ユーザー入力
$ARGUMENTS
続行する前に、ユーザー入力を必ず考慮してください(空でない場合)。
スコープガード
このコマンドの作業範囲は、プロジェクト憲章自体の更新に限定されます。依存するテンプレートやコマンドは実行時に憲章を読み取るため、ここでは変更しません。
- ユーザー入力の各部分を、憲章の内容か、それ以外のガバナンスに関係ない意図かに分類します。
- 入力に機能実装、コード生成、リファクタリング、ビルド、デプロイ要求が含まれている場合、絶対に実行してはなりません。代わりに、それらを延期意図として抽出します。
- 憲章ワークフローに関係のないアプリケーションソースファイル、機能ルート、コンポーネント、テスト、デプロイファイル、その他の成果物を作成、変更、削除してはなりません。
- 指示が憲章の内容かどうか不明な場合は、変更を行う前に明確化を依頼してください。
- 憲章更新の完了後、各延期意図に対して
Next Actionsセクションを含めます。元の意図をリストアップし、適切な後続の Spec Kit コマンド(例:/speckit-specify)を提案しますが、実行はしません。 - ガバナンスに関係ない意図がない場合は、
Next Actionsセクションを省略します。
実行前チェック
拡張フックのチェック(憲章更新前):
- プロジェクトルートに
.specify/extensions.ymlが存在するか確認します。 - 存在する場合は、それを読み込み、
hooks.before_constitutionキーのエントリを探します。 - YAML がパースできないか無効な場合、黙ってスキップせず、
.specify/extensions.ymlが読み取れなかったこと(パーサーエラーを含む)と、そこに登録されている必須(optional: false)フックを含むすべてのフックがチェックされなかったことをユーザーに伝え、その後正常に続行します。 enabledが明示的にfalseのフックは除外します。enabledフィールドがないフックはデフォルトで有効として扱います。- 残りの各フックについて、フックの
condition式を解釈または評価しようとしてはなりません:- フックに
conditionフィールドがない場合、または null/空の場合は、そのフックを実行可能として扱います。 - フックが空でない
conditionを定義している場合、そのフックをスキップし、条件評価は HookExecutor の実装に委ねます。
- フックに
- フックのコマンド名からコマンド呼び出しを構築する際は、ドット(
.)をハイフン(-)に置き換えます。例:speckit.git.commit→/speckit-git-commit。 - 実行可能な各フックについて、その
optionalフラグに基づいて以下を出力します:- オプションフック(
optional: true):## 拡張フック **オプションの事前フック**: {extension} コマンド: `/{command}` 説明: {description} プロンプト: {prompt} 実行方法: `/{command}` - 必須フック(
optional: false):
上記のブロックを出力した後、実際にフックを呼び出し、その終了を待ってから続行する必要があります。このエージェント/セッションで自分自身がコマンドを実行するのと同じ方法で実行してください(呼び出し方法は上記のリテラル## 拡張フック **自動事前フック**: {extension} 実行中: `/{command}` EXECUTE_COMMAND: {command} アウトラインに進む前に、フックコマンドの結果を待機してください。{command}ID と異なる場合があります。例えば、スキルモードエージェントでは/skill:speckit-...または$speckit-...として実行します)。ブロックを出力するだけではフックは実行されません。
- オプションフック(
- フックが登録されていないか、
.specify/extensions.ymlが存在しない場合は、黙ってスキップします。
アウトライン
プロジェクト憲章を .specify/memory/constitution.md で更新しています。アクティブな憲章スキャフォールドは、Spec Kit のプリセット/テンプレート解決スタックを通じて、コマンド実行時に constitution-template から解決されます。
以下の実行フローに従ってください:
-
リポジトリルートから
.specify/scripts/bash/resolve-template.sh constitution-template --jsonを実行し、TEMPLATE_CONTENTをアクティブなテンプレートとしてパースします。- 共有リゾルバーはプロジェクトのオーバーライドを適用し、プリセットレイヤー、拡張レイヤーをコアテンプレートフォールバックの前に合成します。続行する前に必ず成功する必要があります。
- 失敗した場合は停止し、解決エラーを報告します。1つの寄与テンプレートレイヤーだけで続行してはなりません。
.specify/memory/constitution.mdが存在する場合、それを現在のプロジェクト固有の値と修正のソースとして読み込みます。新しく解決されたスキャフォールドを適用する際に、まだ適用可能な情報は保持します。- 存在しない場合は、解決されたテンプレートを初期ドキュメントとして使用します。
- バージョン管理されたテンプレートレイヤーに書き戻してはなりません。
[ALL_CAPS_IDENTIFIER]形式のプレースホルダートークンをすべて特定します。 重要: ユーザーがテンプレートで使用されている原則よりも少ないまたは多い原則を必要とする場合があります。数が指定されている場合は、それを尊重し、一般的なテンプレートに従ってください。それに応じてドキュメントを更新します。
-
プレースホルダーの値を収集/導出します:
- ユーザー入力(会話)が値を提供する場合は、それを使用します。
- それ以外の場合は、既存のリポジトリコンテキスト(README、ドキュメント、以前の憲章バージョン(埋め込まれている場合))から推論します。
- ガバナンス日付について:
RATIFICATION_DATEは元の採択日(不明な場合は TODO を尋ねるかマーク)、LAST_AMENDED_DATEは変更が行われた場合は今日の日付、それ以外は以前の日付を保持します。 CONSTITUTION_VERSIONはセマンティックバージョニングルールに従ってインクリメントする必要があります:- MAJOR: 後方互換性のないガバナンス/原則の削除または再定義。
- MINOR: 新しい原則/セクションの追加、または重要なガイダンスの拡張。
- PATCH: 明確化、文言、タイポ修正、非意味論的な改良。
- バージョンアップの種類が曖昧な場合は、確定する前に理由を提案します。
-
解決されたテンプレートを必須構造として使用して、更新された憲章コンテンツをドラフトします:
- すべてのプレースホルダーを具体的なテキストに置き換えます(プロジェクトがまだ定義しないことを選択した、意図的に保持されたテンプレートスロットを除き、角括弧トークンは残しません。残したものは明示的に正当化します)。
- 見出し階層を保持し、コメントは置き換えられた後、明確化のガイダンスとしてまだ価値がある場合を除き削除できます。
- 各原則セクションが確実に: 簡潔な名前行、非交渉ルールを捉えた段落(または箇条書き)、明白でない場合は明示的な根拠を含むようにします。
- Governance セクションが、修正手順、バージョニングポリシー、コンプライアンスレビューの期待をリストアップするようにします。
-
更新後、憲章ファイルの先頭に HTML コメントとして同期インパクトレポートを生成します。 このレポートは修正の人間によるレビューのための一時的なスクラッチ資料であり、ガバナンスコンテンツではありません。修正された憲章ファイルがコミットされる前に削除されることが想定されています。
- バージョン変更: 旧 → 新
- 変更された原則のリスト(名前変更された場合は旧タイトル → 新タイトル)
- 追加されたセクション
- 削除されたセクション
- プレースホルダーが意図的に延期された場合のフォローアップ TODO
-
最終出力前の検証:
- 説明のない角括弧トークンが残っていないこと。
- バージョン行がレポートと一致していること。
- 日付が ISO 形式 YYYY-MM-DD であること。
- 原則が宣言的で、テスト可能であり、曖昧な表現がないこと(「すべき」は MUST/SHOULD の理由とともに適切に置き換え)。
-
完成した憲章を
.specify/memory/constitution.mdに書き戻します(上書き)。 -
以下の内容を含む最終サマリーをユーザーに出力します:
- 新しいバージョンとバンプの理由。
- 手動フォローアップが必要な TODO プレースホルダーまたは延期アイテム。
- 推奨コミットメッセージ(例:
docs: amend constitution to vX.Y.Z (principle additions + governance update))。 - 延期されたガバナンスに関係ない意図のための
Next Actionsセクション。
書式とスタイルの要件:
- テンプレートと正確に同じ Markdown 見出しを使用します(レベルを下げたり上げたりしないでください)。
- 長い根拠の行は読みやすさのために折り返します(理想的には 100 文字未満)が、不自然な改行で強制しないでください。
- セクション間は 1 行の空行を保ちます。
- 末尾の空白を避けます。
ユーザーが部分的な更新(例: 1 つの原則の修正のみ)を提供した場合でも、検証とバージョン決定の手順を実行します。
重要な情報が不足している場合(例: 批准日が本当に不明)、TODO(<FIELD_NAME>): 説明 を挿入し、同期インパクトレポートの延期アイテムに含めます。
.specify/memory/constitution.md のみを書き込みます。テンプレートソースファイルを作成または変更しないでください。
実行後チェック
拡張フックのチェック(憲章更新後):
プロジェクトルートに .specify/extensions.yml が存在するか確認します。
- 存在する場合は、それを読み込み、
hooks.after_constitutionキーのエントリを探します。 - YAML がパースできないか無効な場合、黙ってスキップせず、
.specify/extensions.ymlが読み取れなかったこと(パーサーエラーを含む)と、そこに登録されている必須(optional: false)フックを含むすべてのフックがチェックされなかったことをユーザーに伝え、その後正常に続行します。 enabledが明示的にfalseのフックは除外します。enabledフィールドがないフックはデフォルトで有効として扱います。- 残りの各フックについて、フックの
condition式を解釈または評価しようとしてはなりません:- フックに
conditionフィールドがない場合、または null/空の場合は、そのフックを実行可能として扱います。 - フックが空でない
conditionを定義している場合、そのフックをスキップし、条件評価は HookExecutor の実装に委ねます。
- フックに
- フックのコマンド名からコマンド呼び出しを構築する際は、ドット(
.)をハイフン(-)に置き換えます。例:speckit.git.commit→/speckit-git-commit。 - 実行可能な各フックについて、その
optionalフラグに基づいて以下を出力します:- オプションフック(
optional: true):## 拡張フック **オプションフック**: {extension} コマンド: `/{command}` 説明: {description} プロンプト: {prompt} 実行方法: `/{command}` - 必須フック(
optional: false):
上記のブロックを出力した後、実際にフックを呼び出し、その終了を待ってから続行する必要があります。このエージェント/セッションで自分自身がコマンドを実行するのと同じ方法で実行してください(呼び出し方法は上記のリテラル## 拡張フック **自動フック**: {extension} 実行中: `/{command}` EXECUTE_COMMAND: {command}{command}ID と異なる場合があります。例えば、スキルモードエージェントでは/skill:speckit-...または$speckit-...として実行します)。ブロックを出力するだけではフックは実行されません。
- オプションフック(
- フックが登録されていないか、
.specify/extensions.ymlが存在しない場合は、黙ってスキップします。