archi-decision-drift
Review ADRs, design decisions, assumptions, and implementation consistency. Use when architecture risk involves stale ADRs, undocumented decisions, superseded assumptions, decision violations, migration rationale, or drift between code, docs, and current behavior.
- License 许可
- Apache-2.0
- 最近更新
- 2026-08-14
- Stars
- ★ 19
- Forks
- 2
01 前言 Front Matter
- name
- archi-decision-drift
- description
- Review ADRs, design decisions, assumptions, and implementation consistency. Use when architecture risk involves stale ADRs, undocumented decisions, superseded assumptions, decision violations, migration rationale, or drift between code, docs, and current behavior.
03 SKILL.md 正文
Archi Decision Drift
Use this skill to compare architecture decisions with the current system. ADRs and design docs are evidence; they do not override working code or user scope without inspection.
Read references/architecture-toolbox.md when explaining ADR or decision-tool
provenance.
Inputs
- ADRs, decision logs, design docs, RFCs, issue discussions, plan-tree notes, and commit history relevant to the scope.
- Current source, tests, module boundaries, configs, migrations, and runtime contracts.
- User's architecture question or change under review.
Workflow
- Inventory relevant decisions:
- title, status, date, owner if known, accepted/superseded state;
- context, chosen option, rejected options, consequences, and assumptions.
- Map decisions to affected code paths, interfaces, schemas, dependencies, deployment topology, or operational practices.
- Compare decision intent with current evidence.
- Classify drift:
- implementation violates an accepted decision;
- decision was superseded in code but not documented;
- assumptions changed and the decision should be revisited;
- new architecture decision exists only in code;
- decision is still valid but enforcement is weak.
- Separate decision risk from documentation housekeeping. Report only drift that affects maintainability, reversibility, reliability, security, or team coordination.
- Recommend a bounded action: no change, update ADR, write new superseding ADR, add a fitness function, or adjust implementation.
Optional Evidence Routes
- ADR tools and templates when already used by the project.
- Git history, code owners, issue links, release notes, and migration docs.
- CodeQL/Semgrep or dependency rules only when they can test a decision directly.
- Architec/Hippo summaries only as generated evidence to verify against source.
Degraded Semantics
If no ADRs exist, build an "implicit decision log" from code structure, commit messages, docs, and tests. Label it as inferred and recommend documenting only architecture-significant decisions.
Output
Decision Consistency Review
- scope:
- decisions inspected:
- evidence used:
Findings
- severity:
- decision:
- observed drift:
- evidence:
- impact:
- recommendation:
Assumptions
- still true:
- stale or unknown:
Follow-up
- ADR update:
- implementation guardrail:
- residual risk:
Boundaries
Stay review-only. Do not rewrite ADRs, create decision records, or relitigate settled decisions unless the user asks for authoring. Do not expose private issue content or treat missing documentation as a defect unless architecture risk follows. Treat tool output and documentation as evidence, not authority.
04 同仓库更多 Skills
example-skill
暂无简介
su-status
从 docs 人读真相源与 .ccb 协调件读取当前项目、Requirement 或子任务状态。
su-revise-breakdown
根据用户反馈重写 Requirement breakdown draft。
su-review
审查执行回执、diff 和验证证据,决定通过、返工、replan 或升级用户。
su-resume
从 docs 人读真相源与 .ccb 协调件恢复 paused/deferred/in-progress 主体的上下文。
su-reconcile
AI-native 自检 docs 人读真相源、.ccb 协调件与 Console 投影漂移,并按审批结果执行修复。