Optional Briefs and Skill Manifest

harness-plan create は、必要なときだけ brief を付ける。brief は Plans.md を置き換えず、実装の前提を短く固定する補助資料。

project spec SSOT は brief より上位の正本として扱う。brief は画面や API など個別タスクの短い前提を固定し、spec SSOT は project 全体の正解条件を固定する。

詳細: docs/plans/spec-ssot.md

Design Brief

UI を含むタスクでは design brief を作る。

最低限入れる内容:

• 何を達成したいか
• 誰が使うか
• 重要な画面状態
• 見た目や操作感の制約
• 完了条件

Contract Brief

API を含むタスクでは contract brief を作る。

最低限入れる内容:

• 何を受け取るか / 返すか
• 入力検証の条件
• 失敗時の振る舞い
• 外部依存
• 完了条件

Skill Manifest

scripts/generate-skill-manifest.sh は、repo 内の SKILL.md frontmatter を stable JSON にする。

使いどころ:

• skill surface の監査
• mirror 間の比較
• 自動 docs 生成の入力

出力には次を含める。

• name
• description
• do_not_use_for
• allowed_tools
• argument_hint
• effort
• user_invocable
• surface
• related_surfaces

related_surfaces には skills, codex/.codex/skills, opencode/skills のような mirror 情報も含まれる。

実行例

scripts/generate-skill-manifest.sh --output .claude/state/skill-manifest.json