菜单
Update architecture documents to reflect the current codebase state. Compares documented modules, types, and components against actual code and proposes updates for human review. Never auto-modifies.
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
基于 SOC 职业分类
| name | arch-sync |
| description | Update architecture documents to reflect the current codebase state. Compares documented modules, types, and components against actual code and proposes updates for human review. Never auto-modifies. |
| allowed-tools | Read, Write, Edit, Bash(git *), Bash(ls *), Bash(bash plugins/*) |
| user-invocable | true |
Update architecture documents to reflect the current codebase state. Compares the documented state against actual modules, types, and components, then proposes changes for human review.
/arch-sync [--doc <path>] [--all]
| Argument | Required | Description |
|---|---|---|
--doc <path> | No | Path to a specific architecture doc to sync. |
--all | No | Sync all architecture docs in docs/architecture/. |
If neither --doc nor --all is provided, list available architecture docs and ask which to sync.
Identify target docs. If --doc is specified, use that file. If --all, process every .md file in docs/architecture/. Otherwise, list available docs for selection.
Detect changes. For each target doc, run the change detector:
bash scripts/detect-changes.sh --doc <path>
This outputs discrepancies:
missing_module --- doc references a module that no longer existsnew_module --- module exists but is not mentioned in the doctype_mismatch --- module type in doc doesn't match CLAUDE.mdAnalyze document structure. Read the architecture doc and identify:
Propose updates. For each discrepancy:
Present for review. Display all proposed changes and ask for human approval before applying. Architecture documents are too important to modify automatically.
Architecture sync for docs/architecture/plugin-system.md:
Change 1: Add missing module reference
+ principled-architecture (architecture) — new plugin added
Source: plugins/principled-architecture/CLAUDE.md
Change 2: Remove stale reference
- packages/legacy-auth (removed from codebase)
Apply changes? [y/n/select]
Apply approved changes. Only modify the document if the user approves. Apply edits inline, preserving document structure and formatting.
Report results.
Architecture sync complete:
Document: docs/architecture/plugin-system.md
Changes detected: 3
Changes applied: 2
Changes skipped: 1
scripts/detect-changes.sh --- Compare architecture doc content against actual codebase module stateValidate that a pull request follows principled conventions: references a plan or proposal, has correct labels, includes required sections in the description, and links to relevant documents. Use in CI or before merging to enforce PR quality.
Generate a structured pull request description from a DDD plan task. Reads the plan, task manifest, and implementation branch to produce a PR body with references to the originating proposal, plan, ADRs, and related tasks. Use when opening a PR for plan-driven work.
Process open GitHub issues through the principled pipeline. Lists untriaged issues, normalizes their metadata, ingests them into the documentation pipeline, and reports a summary. Operates as the batch entry point — delegates to /ingest-issue for each individual issue.
Implementation orchestration strategy for the Principled framework. Consult when working with DDD plan execution, git worktrees for task isolation, task manifests, or the decompose-spawn-validate-merge lifecycle. Covers worktree management, sub-agent patterns, task state machines, and manifest schema.
Top-level orchestrator for DDD plan execution. Decomposes a plan into tasks, iterates through phases respecting dependencies, spawns worktree-isolated agents, validates implementations, and merges results. Runs inline to coordinate multiple sub-agent spawns. Use for automated end-to-end plan execution.
Audit ADR coverage across modules. Identifies modules with no architectural governance, orphaned ADRs referencing removed modules, and stale architecture docs. Classifies findings by severity.