spec-sync

Classify COCOSiL specification changes and enumerate impacted documents for updates during PR review and document sync checks.

1|Updated Mar 22, 2026
One-click install
npx skills add https://github.com/COCOSiL-inc/COCOSiL_Analysis_V2 --skill spec-sync-cocosil-inc
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-sync
Source: https://github.com/COCOSiL-inc/COCOSiL_Analysis_V2/tree/main/.claude/skills/spec-sync
Command: npx skills add https://github.com/COCOSiL-inc/COCOSiL_Analysis_V2 --skill spec-sync-cocosil-inc

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

COCOSiL仕様の変更が発生したときに、哲学・禁止語・UXシーケンス・機能スコープ・API/DB設計などのドキュメント群へ漏れなく整合的に反映するための更新影響調査と更新案生成を支援します。

Core Features & Use Cases

  • 変更パターン自動判定(P1〜P5): 哲学更新、禁止語変更、UXシーケンス変更、機能スコープ変更、API/DB設計変更をトリガーファイルやキーワードから分類します。
  • Propagation Matrixに基づく影響先の列挙と更新要否の明示: 参照マトリクスを用いて影響ドキュメントを網羅的に列挙し、「更新不要」も省略せず示します。
  • Layer設計に従った実行範囲の決定: Layer 1/2/3のルールに基づき、警告・承認者付き提案・自動更新可能領域を切り分けます。
  • 整合性チェックと安全ゲート: 禁止語チェック、UX順序整合性、Constitution整合性を行い、P5では前置レビュー(security-sensitive-change-review)を促します。

Quick Start

「仕様変更をドキュメントに反映して」と依頼し、変更内容(該当ファイルや変更点)と変更前の状態が分かる範囲で渡してください。

Frequently Asked Questions about spec-sync

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I propagate specification changes across project documentation?

Propagating specification changes across project documentation requires classifying the change type and enumerating all impacted documents via a propagation matrix to generate consistent update proposals.

What is a propagation matrix for document consistency checks?

A propagation matrix for document consistency checks is a reference framework that comprehensively lists impacted documents and explicitly states update or no-update decisions for each file.

How do I keep banned-word and UX sequence updates synchronized?

Keeping banned-word and UX sequence updates synchronized involves running integrity checks that validate banned-word compliance, UX ordering consistency, and Constitution alignment across the documentation set.

Does spec-sync require a specific layer design for document approvals?

Spec-sync requires layer-aware impact routing following Layer 1, 2, and 3 rules to separate warnings, proposals with approvers, and auto-updatable areas during document synchronization.

When do I need a pre-review for API and DB design modifications?

You need a pre-review for API and DB design modifications when changes are classified as P5, triggering a security-sensitive-change-review to ensure safe specification propagation.

What are the limitations of automated specification propagation?

Automated specification propagation is limited by layer design boundaries, restricting auto-updates to safe areas while enforcing manual approvals and integrity checks for conflicting or security-sensitive changes.