name: write-spec
description: >-
技術設計仕様を .artifacts/features//specification.md へ書き込む時に使用する。
design-spec で固めた設計をテンプレートに沿って構造化する。メインエージェントが直接使用する。
user-invocable: false
allowed-tools: [Read, Write, Edit]
specification.md 書き込みワークフロー
技術設計仕様を .artifacts/features/<feature>/specification.md へ書き込む手順を定義する。
書き込み手順
Readで./template.mdを読み込む。- 既存の
.artifacts/features/<feature>/specification.mdがあれば読み込み、更新箇所を特定する。 - テンプレートのセクション構成・見出し・順序を維持し、
Write(新規)またはEdit(既存)で書き込む。 - プレースホルダーはすべて実際の内容で置き換え、フロントマターの最終更新日を更新する。
Mermaid 図の作成
以下のいずれかに該当する場合は Mermaid 図を作成する。
- 全体アーキテクチャ構造(レイヤー図・コンポーネント図)
- データフロー(シーケンス図・フロー図)
- データモデル(ER 図・クラス図)
- 画面遷移図
- テンプレート構造を保つ: テンプレートで定義されたセクションを追加・削除・並べ替えしない。
- 未決の前提を記録する: 設計上の前提(要件で未決だった項目)は明示的に記録する。