specture

Specture System

Specture は、仕様主導の開発システムです。永続的な設計記録は、specs/ ツリー配下の SPEC.md ファイルに保存されます。一時的なエージェントへの引き継ぎには、仕様ファイルと同じ階層またはその配下にある任意の PLAN.md ファイルを使用します。

決定論的なファイルの作成、検索、検証には CLI を使用します。ワークフローの判断やファイルの編集には、このスキルを使用します。

まずはこちら

• 仕様の設計または改善：references/design-workflow.md を読んでください。
• 既存の仕様を親仕様と子仕様に分割する場合：references/split-workflow.md を読んでください。
• 仕様を実装する場合：コードを変更する前に references/implementation-workflow.md を読み、関連する PLAN.md があれば実行コンテキストとして含めてください。
• 仕様または計画の変更を検証する場合：references/validation-workflow.md を読んでください。
• specs ツリーを初期化または移行する場合：references/migration-workflow.md を読んでください。
• SPEC.md を作成または編集する場合：references/spec-format.md を読んでください。
• PLAN.md を作成または編集する場合：references/plan-format.md を読んでください。
• 追跡対象の仕様ファイルを設定する場合：references/specs-gitignore-format.md を読んでください。

基本ルール

• 仕様を探すには specture list を使用してください。CLI で確認できる場合、specs ツリーを手動で走査しないでください。
• 特定の人に割り当てられた仕様を探すには、specture list --assignee "Name" を使用してください。複数の担当者を検索するには、完全な名前をカンマ区切りで渡します。照合では大文字と小文字が区別されません。
• 実装作業の前に、関連する SPEC.md を読んでください。
• 仕様を実装する前に、必ず references/implementation-workflow.md を読んでください。PLAN.md だけではワークフローの指針として不十分です。
• 実装中は、次の作業に着手する前に、焦点を絞って検証済みの各作業単位をコミットしてください。
• ユーザーから明示的に依頼されない限り、計画された複数の PR 作業単位を、未コミットの作業ツリーにまとめないでください。
• 実装の進捗を SPEC.md に記載しないでください。実行時の引き継ぎやタスクの分割には PLAN.md を使用してください。
• ユーザーが明示的に話し合った、または確認した設計内容のみを追加してください。不足している目標、要件、判断を推測して作り出さないでください。
• 既存の仕様を分割するようユーザーから依頼された場合、その仕様内ですでに確立されている内容は、再確認なしに子仕様へ振り分けてもかまいません。references/split-workflow.md に従ってください。
• 仕様を分割する際に、子仕様の範囲を推測してはなりません。提案する子仕様についてユーザーと話し合い、作成前に明示的な承認を得てください。
• 親仕様には簡潔な説明、目標、リンク付きの子仕様一覧を記載します。設計上の判断は子仕様に記載してください。
• ユーザーの明示的な許可なく、仕様の設計上の判断や説明を編集しないでください。
• 見出しには平易な言葉を使い、番号を付けないでください。
• 仕様間の参照には、対象の SPEC.md へのインラインのリポジトリルート相対 Markdown リンクを使用してください。
• 仕様の移行後、または SPEC.md／PLAN.md ファイルの編集後には、specture validate を実行してください。

CLI クイックリファレンス

specture list
specture list -p 1.4
specture list -p 1.4 -d 1
specture list -d all
specture list --status draft,approved
specture list --assignee "Alice Example"
specture list --assignee "Alice Example,Bob Builder"
specture list -f json
specture validate
specture validate --spec 11
specture new --title "Feature name"
specture new --title "Child feature" --parent 11

• specture list -p/--parent を指定すると、出力を親仕様の子に絞り込めます。
• specture list -d/--depth で再帰の深さを制御します。デフォルトは all（ツリー全体）です。直下の子のみを表示するには -d 1 を、深さを制限しない場合は -d 0 または -d all を使用します。
• specture list --assignee は、空白を削除した後、担当者名全体を大文字・小文字を区別せずに照合します。一部一致による検索は行いません。完了済みの割り当ても含める必要がある場合は、--status all と組み合わせてください。
• テキスト出力では、表示対象の仕様のうち少なくとも1つに担当者が割り当てられている場合にのみ ASSIGNEE が表示されます。JSON 出力には常に assignee 文字列が含まれ、担当者が割り当てられていない仕様では "" が使用されます。
• specture new --parent は、親の下に次の子仕様を作成します。短縮形の -p フラグはありません。

Specture の動作や使用可能なフラグを確認するには、まず specture help またはコマンド固有の --help を実行してください。CLI で確認できない場合を除き、ls specs/ のようにシェルからディレクトリを直接一覧表示する方法に頼らないでください。