spec-sync
Maintains consistency and cross-references between design and specification documents.
Install
mkdir -p .claude/skills/spec-sync && curl -L -o skill.zip "https://agentskills.codes/api/skills/download/13281" && unzip -o skill.zip -d .claude/skills/spec-sync && rm skill.zipInstalls to .claude/skills/spec-sync
Activation
This is the description your AI agent reads to decide when to run this skill — the better it matches your request, the more reliably it fires.
あるドキュメント（実装計画・ADR・decision 等）で追加・詳細化された内容のうち、本来は別ドキュメント（spec / ADR / decision）に記載すべきものを反映し、変更履歴と相互参照を整える。ユーザーが「実装計画の内容を spec に反映」「ADR の決定を関連 spec に下ろす」「ドキュメント間の整合を取る」「back-reflection を行う」等を指示した場合に使用する。Key capabilities
- →Identify added or updated content in a source document
- →Determine if content belongs in a different derived document
- →Add or update equivalent descriptions in derived documents
- →Append a one-line entry to the change history of both documents
- →Add mutual reference links if necessary
- →Ensure consistency between multiple design documents
How it works
The skill identifies changes in a source document, determines which parts are relevant to other derived documents, and then updates those derived documents. It also synchronizes change histories and adds mutual reference links.
Inputs & outputs
When to use spec-sync
- →Syncing spec updates
- →Updating ADR references
- →Maintaining documentation consistency
About spec-sync
Updates derived documentation when source design or ADR documents change. It automates updating change logs and mutual references to maintain project documentation integrity.
あるドキュメント（実装計画・ADR・decision 等）で追加・詳細化された内容のうち、本来は別ドキュメント（spec / ADR / decision）に記載すべきものを反映し、変更履歴と相互参照を整える。ユーザーが「実装計画の内容を spec に反映」「ADR の決定を関連 spec に下ろす」「ドキュメント間の整合を取る」「back-reflection を行う」等を指示した場合に使用する。
When not to use it
- →When creating new documents from scratch
- →When the task is to write a requirements document
- →When the task is to create a basic design document
Limitations
- →Its responsibility is limited to maintaining consistency between existing documents.
- →It does not handle the creation of new documents from scratch.
- →It formats derived documents to be less redundant than the source, not an exact copy.
How it compares
This skill automates the back-reflection process for design documents, ensuring consistency and traceability across related specifications and decisions, which is typically a manual and error-prone task.
Compared to similar skills
spec-sync side by side with the closest alternatives in the catalog.
| Skill | Installs | Updated | Safety | Difficulty |
|---|---|---|---|---|
| spec-sync (this skill) | 0 | 2mo | No flags | Intermediate |
| project-planner | 32 | 9mo | Review | Intermediate |
| spec-kit-workflow | 11 | 8mo | No flags | Intermediate |
| specification-architect | 13 | 9mo | Review | Advanced |
Try saying
Example prompts that trigger this skill in your AI assistant.
You might also like
project-planner
adrianpuiu
Comprehensive project planning and documentation generator for software projects. Creates structured requirements documents, system design documents, and task breakdown plans with implementation tracking. Use when starting a new project, defining specifications, creating technical designs, or breaking down complex systems into implementable tasks. Supports user story format, acceptance criteria, component design, API specifications, and hierarchical task decomposition with requirement traceability.
spec-kit-workflow
jmanhype
Guides specification-driven development workflow. Automatically invoked when discussing new features, specifications, technical planning, or implementation tasks. Ensures proper workflow phases (specify → clarify → plan → checklist → tasks → analyze → implement).
specification-architect
adrianpuiu
A rigorous, traceability-first system that generates five interconnected architectural documents (blueprint.md, requirements.md, design.md, tasks.md, and validation.md) with complete requirements-to-implementation traceability. Use this skill when users need to architect systems, create technical specifications, or develop structured project documentation with guaranteed traceability.
architecture
davila7
Architectural decision-making framework. Requirements analysis, trade-off evaluation, ADR documentation. Use when making architecture decisions or analyzing system design.
context-driven-development
wshobson
Use this skill when working with Conductor's context-driven development methodology, managing project context artifacts, or understanding the relationship between product.md, tech-stack.md, and workflow.md files.
planning-agent
parcadei
Planning agent that creates implementation plans and handoffs from conversation context