mspec-design
design step of mspec workflow — write design.md + design-rationale.md + architecture-overview.md, full Constitution Check
Файлы1
Открыть в GitHubSKILL.md.claude/skills/mspec-design/SKILL.md
GitHub<!-- @mspec-delta 2026-05-18-044538-revise-artifact-taxonomy/specs/claude-integration/spec.md -->
<!-- Requirements implemented: FR-022 -->
<!-- Change: revise-artifact-taxonomy -->
<!-- @mspec-delta 2026-05-15-063805-fix-command-name-consistency/specs/claude-integration/spec.md -->
<!-- Requirements implemented: FR-017 -->
<!-- Change: fix-command-name-consistency -->
<!-- @mspec-delta 2026-05-15-040857-step-checkbox-update/specs/claude-integration/spec.md -->
<!-- Requirements implemented: FR-015 -->
<!-- Change: step-checkbox-update -->
Procedure
- Run
mspec status --change <change-dir> --jsonfirst. - Read
research.md. - Write
design.mdfrom the artifact template (doc_type: Reference). Fill: Summary, Technical Context, Phase 0 Constitution Check, Project Structure, Decisions.design.mdは「何を」設計したかを記述する Reference ドキュメント(構造・API・データモデル・契約)。採用理由・代替案・トレードオフは 3a で書く。## Decisionsセクションでは、各技術的決定の受け入れ基準を Delta Spec の Scenario(GIVEN/WHEN/THEN)と対応付けて記述する。これにより checklist と tasks.md の E2E タスクへのトレーサビリティを確保する。- 冒頭に
<!-- See also: ./design-rationale.md for採用理由・代替案 -->コメントを追加する。 3a. Writedesign-rationale.mdfrom the artifact template (doc_type: Explanation). このファイルは「なぜその設計を選んだか」を記述する Explanation ドキュメント。Fill: ## Context— この設計判断が必要となった背景・制約を 2-3 段落で記述。## Decisions— 各意思決定の採用理由を 2-3 段落で記述。design.mdの Project Structure / Decisions と相互参照する。## Alternatives Considered— 検討した代替案とその評価を箇条書きで記述。## Trade-offs— 採用案で受け入れたトレードオフを列挙。## Rejected Options— 却下した選択肢と却下理由を列挙。- 冒頭に
<!-- See also: ./design.md -->コメントを付ける。
- Write
architecture-overview.mdwith at minimum a Mermaid System Diagram (required). Add Sequence / Data Model diagrams when applicable. Inline SVG only if Mermaid can't express it. - Re-evaluate the Constitution Check on both
design.md(Phase 1) anddesign-rationale.md(Phase 1) — both Phase 0 and Phase 1 columns must be filled in each file. - If any ❌, fill
### Complexity Trackingwith justification (otherwise write "None"). - Use AskUserQuestion when material design trade-offs need user input.
7a.
design.mdとdesign-rationale.mdとarchitecture-overview.mdの 3 ファイルがすべて書き込まれた後、readme.mdの## Artifacts節の- [ ] design.md / architecture-overview.mdを- [x] design.md / design-rationale.md / architecture-overview.mdに更新する。design-rationale.mdのチェックボックス- [ ] design-rationale.mdが別行にある場合も同様に- [x]に更新する。
- Run
mspec validate --change <change-dir>. validate が失敗した場合は- [x] design.md / design-rationale.md / architecture-overview.mdを- [ ] design.md / design-rationale.md / architecture-overview.mdにロールバックする。design-rationale.mdが欠落している場合は 3a に戻って作成する。
block: true— stop and ask the user to run/mspec:continue.
Verification (C2)
mspec validate --change <change>— アーティファクト整合性チェックmspec anchor check --change <change>— アンカー解決確認mspec validate --change <change> --strict— Constitution Check両Phase確認
Learning (C3)
このスキルの実行で発生した学習候補を記録する:
<!-- LEARNING: <パターン説明> | source: <FR-ID> | confidence: low|medium|high -->
mspec learn コマンドが archive 済み changes からこれらを収集してpost-condition候補をproposeする。