[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"skill:01M79B91C4RXKEVWC3X53ASWE1":3,"skill-same:01M79B91C4RXKEVWC3X53ASWE1":62},{"skillNo":4,"name":5,"nameZh":6,"description":7,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":15,"categories":16,"keywords":17,"publishedAt":18,"linkOnly":19,"markdownContent":20,"markdownBody":21,"frontMatter":22,"refName":43,"commitSha":44,"skillDirectory":45,"forksCount":13,"repositoryHtmlUrl":46,"repositoryHomepageUrl":6,"ownerHtmlUrl":47,"ownerBlogUrl":6,"ownerDescription":6,"updatedAt":48,"install":49,"resources":61},"01M79B91C4RXKEVWC3X53ASWE1","harness-plan",null,"HAR: Research-backed, team-validated task planning, Plans.md management, progress sync. Trigger: create a plan, add tasks, update Plans.md, mark complete, check progress. Do NOT load for: implementation, review, release.","Timothy191\u002Farch-systems-portal","Timothy191","https:\u002F\u002Favatars.githubusercontent.com\u002Fu\u002F219252205?v=4","01M79B3963G748F05KS7AH3NJR","01M79B396N88AYYNHK5G2DNP2S",0,"MIT","https:\u002F\u002Fgithub.com\u002FTimothy191\u002Farch-systems-portal\u002Fblob\u002Fmain\u002Fagent-harnesses\u002Fclaude-code-harness\u002Fcodex\u002F.codex\u002Fskills\u002Fharness-plan\u002FSKILL.md",[],[],"2026-11-15 14:19:17",false,"---\nname: harness-plan\ndescription: \"HAR: Research-backed, team-validated task planning, Plans.md management, progress sync. Trigger: create a plan, add tasks, update Plans.md, mark complete, check progress. Do NOT load for: implementation, review, release.\"\ndescription-en: \"HAR: Research-backed, team-validated task planning, Plans.md management, progress sync. Trigger: create a plan, add tasks, update Plans.md, mark complete, check progress. Do NOT load for: implementation, review, release.\"\ndescription-ja: \"HAR:調査・採点・記憶確認・TeamAgent\u002Fサブエージェント検証つきのタスク計画、Plans.md管理、進捗同期を担当。計画作って、タスク追加、Plans.md更新、完了マーク、進捗確認で起動。実装・レビュー・リリースには使わない。\"\nkind: workflow\npurpose: \"Maintain co-required planning output for the spec.md product contract and Plans.md task contract\"\ntrigger: \"create a plan, add tasks, update Plans.md, check progress\"\nshape: workflow\nrole: generator\npair: harness-sync\nowner: harness-core\nsince: \"2026-05-05\"\nallowed-tools: [\"Read\", \"Write\", \"Edit\", \"Bash\", \"Grep\", \"Glob\", \"WebSearch\", \"Task\"]\nargument-hint: \"[create|add|update|sync|sync --no-retro|--ci]\"\nuser-invocable: true\neffort: medium\n---\n\n# Harness Plan\n\nHarness の統合プランニングスキル。\n以下の3つの旧スキルを統合:\n\n- `planning` (plan-with-agent) — アイデア → Plans.md への落とし込み\n- `plans-management` — タスク状態管理・マーカー更新\n- `sync-status` — Plans.md と実装の同期確認\n\n## Quick Reference\n\n| ユーザー入力                             | サブコマンド | 動作                                                   |\n| ---------------------------------------- | ------------ | ------------------------------------------------------ |\n| \"計画を作って\" \u002F `\u002Fharness-plan create`  | `create`     | Spec delta \u002F skip reason → Plans.md task 生成          |\n| \"タスクを追加して\" \u002F `\u002Fharness-plan add` | `add`        | Plans.md に新タスク追加                                |\n| \"完了にして\" \u002F `\u002Fharness-plan update`    | `update`     | タスクマーカーを cc:完了 に変更                        |\n| \"今どこ？\" \u002F `\u002Fharness-plan sync`        | `sync`       | 実装とPlans.mdを照合・同期                             |\n| `\u002Fharness-sync`                          | `sync`       | 進捗確認（独立 sync surface と同等）                   |\n| `\u002Fharness-plan create`                   | `create`     | spec.md \u002F Plans.md 二正本の計画作成                    |\n| `\u002Fharness-plan list`                     | `list`       | `plans\u002Fmanifest.json` の named Plans を一覧            |\n| `\u002Fharness-plan switch \u003Cname>`            | `switch`     | active plan を `.claude\u002Fstate\u002Factive-plan.json` に保存 |\n\n## Literal companion commands（CC 2.1.108+）\n\n- `\u002Frecap`: 久しぶりに戻った時に要約を取り直してから `sync` へ入る\n- `\u002Fundo`: `\u002Frewind` の別名。直前の plan 更新を即座に戻したい時にそのまま使う\n\n## サブコマンド詳細\n\n### 標準の計画品質契約\n\nSee [references\u002Fplanning-quality.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fplanning-quality.md)\n\n`harness-plan` は、spec.md product contract and Plans.md task contract の co-required planning output を作る planning surface である。\nprecedence は `spec.md > sub-spec > Plans.md` のまま維持する。\nPlans.md は task ledger、root `spec.md` は product contract であり、上下関係は崩さない。\n渡された情報をそのまま Plans.md に落とさない。\n計画作成や大きな task 追加では、最新情報・既存仕様・記憶・TeamAgent \u002F サブエージェントによる複数視点の議論を確認し、\nこのプロダクトに取り入れるべき要素だけを task contract に変換する。\n`\u002Fharness-plan create` は `Spec delta` または `Spec skip reason` と `Plans.md` task 生成をセットで返す。\n出力には必ず `Spec delta` または `Spec skip reason` を含める。\n`Spec delta` \u002F `Spec skip reason` は Harness が生成し、consumer は承認・修正だけ行う。\n\n**Non-trivial planning gate**:\n\n単発・軽微タスクでない planning は、TeamAgent またはサブエージェント前提で扱う。\nここでの non-trivial は、複数 task \u002F 複数 file \u002F 複数 session \u002F product behavior \u002F API \u002F data model \u002F 権限 \u002F 課金 \u002F 外部連携 \u002F 配布面 \u002F セキュリティに影響する依頼を指す。\nTask tool が使える場合は Product \u002F Architecture \u002F Security \u002F QA \u002F Skeptic の独立視点を走らせる。\n使えない場合は `サブエージェント未使用` と明示し、同じ観点を単独で分けて評価する。\n\nnon-trivial planning の出力には、次の検証を必ず含める。\n\n- `team_validation_mode`: `not_required_lightweight` \u002F `native` \u002F `subagent` \u002F `manual-pass` \u002F `unavailable`\n- `spec.md` \u002F sub-spec \u002F `Plans.md` の整合性\n- harness-mem \u002F harness-recall \u002F repo memory による車輪の再発明防止確認\n- プロダクト目的から外れていないか\n- セキュリティ、権限、秘密情報、サプライチェーンに問題がないか\n- lint \u002F formatter baseline があるか。source code changes を含む plan で未設定なら、実装 task の前に setup task を置く\n- ちゃんと動く計画か。つまり test \u002F smoke \u002F CI \u002F review \u002F release gate が task DoD に落ちているか\n\n軽量 task は `team_validation_mode: not_required_lightweight` でよい。\nnon-trivial planning は `native` \u002F `subagent` \u002F `manual-pass` のいずれかを使う。\n`unavailable` のまま Required にしてはいけない。\nProduct \u002F Architecture \u002F Security \u002F QA \u002F Skeptic は検証 perspective であり、agent_type 名ではない。\n利用可能な TeamAgent \u002F Task サブエージェントに perspective として依頼し、任意 agent spawn を要求しない。\nSecurity gate は秘密情報の実読取を要求しない。\n`.env` や secret の read が必要になる場合は Risk Gate として止め、許可された既存 guard \u002F evidence で確認する。\n\n**適用する場面**:\n\n- `create` で新しい計画を作る\n- `add` で product behavior \u002F API \u002F 権限 \u002F 課金 \u002F 外部連携 \u002F 配布面に影響する task を足す\n- ユーザーが外部プロダクト、競合、仕様案、改善案、比較材料を渡した\n- 既存仕様や過去判断との衝突リスクがある\n\n**軽く扱ってよい場面**:\n\n- marker 更新だけの `update`\n- status 照合だけの `sync`\n- typo、format、README\u002FCHANGELOG のみ\n- 既存 spec とテストで正解が固定されている狭い変更\n\n**品質フロー**:\n\n1. 入力情報を分解し、評価対象・採点軸・不確かな事実を明示する\n2. 最新情報を取得する。外部事実は WebSearch \u002F 公式ドキュメント \u002F 一次情報を優先し、重要点は複数ソースでクロスチェックする\n3. 既存仕様・root `spec.md`・Plans.md・README・docs・CLAUDE.md・関連 skill を確認する\n4. harness-mem \u002F harness-recall \u002F `.claude\u002Fagent-memory\u002F` \u002F `.claude\u002Fstate\u002F` など、利用可能な記憶面を project-scoped で確認する\n5. non-trivial planning では TeamAgent \u002F Task サブエージェントを使い、Product \u002F Architecture \u002F Security \u002F QA \u002F Skeptic など異なる視点で独立レビューする\n6. source code changes を含む plan では lint \u002F formatter baseline を確認し、未設定なら setup task を先行させる\n7. 中立的な採点レビューを出し、Required \u002F Recommended \u002F Optional \u002F Reject に分類する\n8. `$easy` 形式で、提案内容・理由・どうなるのかを報告する\n9. 採用する案だけを root `spec.md` \u002F Plans.md \u002F test task へ落とし込む\n\n### create — 計画作成\n\nSee [references\u002Fcreate.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fcreate.md)\n\nアイデア・要件をヒアリングし、実行可能な Plans.md を生成する。\n\n**フロー**:\n\n1. 会話コンテキスト確認（直前の議論から抽出 or 新規ヒアリング）\n2. 何を作るか聞く（max 3問）\n3. **計画品質チェック**（最新情報、既存仕様、記憶、TeamAgent \u002F サブエージェント複数視点レビュー、採点）\n4. 技術調査（WebSearch）\n5. 機能リスト抽出\n6. **spec.md \u002F Plans.md 二正本チェック**（Spec delta または Spec skip reason + Plans.md task）\n7. 優先度マトリクス（Required \u002F Recommended \u002F Optional \u002F Reject）\n8. TDD 採用判断（テスト設計）\n9. Plans.md 生成（`cc:TODO` マーカー付き）\n10. 次のアクション案内\n\n### spec.md \u002F Plans.md 二正本チェック（デフォルト）\n\nPlans.md は「やるべきこと」の task contract、root `spec.md` は「何が正しいか」の product contract として扱う。\nco-required planning output は両方の出力を必須にするという意味であり、precedence は `spec.md > sub-spec > Plans.md` のまま維持する。\n実装がぶれる可能性がある時は、Plans.md 生成前に root `spec.md` を更新する。\n`create` と product-impacting `add` は毎回 root `spec.md` を読む。\n\n優先する保存先:\n\n1. root `spec.md`\n2. consumer repo に root `spec.md` がない時だけ、既存の project spec \u002F architecture \u002F product compass\n3. consumer repo に root `spec.md` がない時だけ、`docs\u002Fspec\u002F00-project-spec.md`\n4. 既存規約がある repo では、その規約に沿った spec path\n\n作成\u002F更新が必要な条件:\n\n- ユーザーに見える振る舞い、API、データモデル、権限、課金、外部連携を決める task\n- 複数の実装方針があり、選び方で product behavior が変わる task\n- 過去または今回の会話で「仕様が曖昧で実装がぶれた」兆候がある task\n- Plans.md には作業内容があるが、project としての正解条件が安定文書にない task\n\n不要な条件:\n\n- typo、format、dependency bump、README\u002FCHANGELOG のみ\n- 動作変更なしの狭い refactor\n- 既存 spec とテストで正解が十分に固定されている修正\n\n出力契約:\n\n- `Spec delta`: product contract を更新する時に、対象 spec path と変更点を書く\n- `Spec skip reason`: product contract を更新しない時に、理由を書く\n- `Spec delta` \u002F `Spec skip reason` は Harness が生成し、consumer は承認・修正だけ行う\n- docs-only \u002F mechanical task でも `Spec skip reason` を task context \u002F sprint contract に残す\n- missing search result、unavailable memory、未読ファイルを absent と断定しない。`not_observed != absent`\n- ユーザーに spec を一から書かせない。agent が既存 spec と入力から最小 delta を作り、曖昧な時だけ判断分岐を出す\n\n参照:\n\n- `docs\u002Fplans\u002Fspec-ssot.md`\n\n### create 完了時のセッション起動案内（必須）\n\n`create` が終わったら、説明だけで終わらせず、**新しいセッションの起動コマンド** と\n**起動後にそのまま入れる最初の指示プロンプト** をセットで案内する。\n\n優先順位は次の通り:\n\n1. 未完了タスクが 1 件だけ、または最初の 1 件だけ始めるのが自然\n   - 起動コマンド: `claude`\n   - 最初の入力: `\u002Fharness-work \u003Ctask番号>`\n2. 依存の薄いタスクが複数あり、まとめて進めるのが自然\n   - 起動コマンド: `claude`\n   - 最初の入力: `\u002Fbreezing all`\n   - 代替: `\u002Fharness-work all`\n3. 長時間実行や再入が前提\n   - 起動コマンド: `ENABLE_PROMPT_CACHING_1H=1 claude`\n   - 最初の入力: `\u002Fharness-loop all`\n   - 代替: `\u002Fbreezing all`\n\n最低でも次の 3 行を含める:\n\n- `新しいセッションの起動コマンド:`\n- `起動後の最初の入力:`\n- `向いている場面:`\n\n例:\n\n```text\n新しいセッションの起動コマンド: claude\n起動後の最初の入力: \u002Fbreezing all\n向いている場面: Phase 1 の task が複数あり、まとめて進めるほうが自然なため\n```\n\n長時間系を勧める場合は、Claude Code セッション起動コマンドも併記する:\n\n```text\n新しいセッションの起動コマンド: ENABLE_PROMPT_CACHING_1H=1 claude\n起動後の最初の入力: \u002Fharness-loop all\n向いている場面: 5 分を超える待機や resume をまたぐ長時間タスクのため\n```\n\n補足:\n\n- `scripts\u002Fclaude-longrun.sh` はこのリポジトリの開発補助スクリプトで、plugin install 後の consumer 環境には配布されない\n- そのため、consumer 向け案内では常に `ENABLE_PROMPT_CACHING_1H=1 claude` の 1 行コマンドを優先する\n- リポジトリ開発中だけ同等のラッパーを使いたい場合、`bash scripts\u002Fclaude-longrun.sh` はローカル checkout 上では利用してよい\n\n**CI モード** (`--ci`):\nヒアリングなし。既存の Plans.md をそのまま利用してタスク分解のみ行う。\n\n### add — タスク追加\n\nPlans.md に新しいタスクを追加する。\nproduct-impacting な追加では、上の「spec.md \u002F Plans.md 二正本チェック」に従い `Spec delta` または `Spec skip reason` も出力する。\n\n```\n\u002Fharness-plan add タスク名: 詳細説明 [--phase フェーズ番号]\n```\n\nタスクは `cc:TODO` マーカーで追加される。\n\n### update — マーカー更新\n\nタスクのステータスマーカーを変更する。\n\n```\n\u002Fharness-plan update [タスク名|タスク番号] [WIP|完了|blocked]\n```\n\nマーカー対応表:\n\n| コマンド        | マーカー  |\n| --------------- | --------- |\n| `WIP`           | `cc:WIP`  |\n| `完了` \u002F `done` | `cc:完了` |\n| `blocked`       | `blocked` |\n| `TODO`          | `cc:TODO` |\n\n### sync — 進捗同期\n\n実装状況と Plans.md を照合し、差分を検出・更新する。\n\nSee [references\u002Fsync.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fsync.md)\n\n**フロー**:\n\n1. Plans.md の現状取得\n2. Plans.md フォーマット検出（v1: 3 カラム \u002F v2: 5 カラム）\n3. git status \u002F git log から実装状況取得\n4. エージェントトレース確認（`.claude\u002Fstate\u002Fagent-trace.jsonl`）\n5. Plans.md と実装の差分検出\n6. 未更新マーカーの自動修正提案\n7. 次のアクション提示\n\n**レトロスペクティブ**（デフォルト ON）:\n`cc:完了` タスクが 1 件以上あれば自動的に振り返りを実行する。\n見積もり精度、ブロック原因パターン、スコープ変動を分析し、学びを記録。\n`sync --no-retro` で明示的にスキップ可能。\n\n### team mode \u002F issue bridge\n\nPlans.md は正本のまま維持し、GitHub Issue 連携は opt-in の team mode だけで使う。\n\n- solo 開発では bridge を使わない\n- team mode は tracking issue を 1 つ作り、その配下に task ごとの sub-issue payload を dry-run で生成する\n- `scripts\u002Fplans-issue-bridge.sh` は実際に GitHub を更新せず、常に dry-run の payload を返す\n- Plans.md への変更はこの bridge では行わない\n\n参照:\n\n- `docs\u002Fplans\u002Fteam-mode.md`\n\n### named Plans\n\n複数の Plans.md を使う場合は `plans\u002Fmanifest.json` を正本にして、名前で選択する。\n\n```bash\nscripts\u002Fplan-registry.sh list\nscripts\u002Fplan-registry.sh switch roadmap\nscripts\u002Fplans-issue-bridge.sh --plan roadmap --format markdown\nnode scripts\u002Fgenerate-sprint-contract.js --plan roadmap 9.1.1\n```\n\n運用ルール:\n\n- 1 run では 1 つの named plan だけを使う\n- long-running \u002F CI \u002F issue bridge では active pointer に頼らず `--plan \u003Cname>` を渡す\n- manifest path は project root 相対のみ。絶対パス、`..`、repo 外 symlink は拒否される\n\n参照:\n\n- `docs\u002Fplans\u002Fnamed-plans.md`\n\n## Plans.md フォーマット規約\n\n### フォーマット\n\n```markdown\n# [プロジェクト名] Plans.md\n\n作成日: YYYY-MM-DD\n\n---\n\n## Phase N: フェーズ名\n\n| Task | 内容 | DoD                      | Depends  | Status  |\n| ---- | ---- | ------------------------ | -------- | ------- |\n| N.1  | 説明 | テスト通過               | -        | cc:TODO |\n| N.2  | 説明 | lint エラー 0            | N.1      | cc:WIP  |\n| N.3  | 説明 | マイグレーション実行可能 | N.1, N.2 | cc:完了 |\n```\n\n**DoD（Definition of Done）**: 検証可能な完了条件を 1 行で記述。「いい感じ」「ちゃんと動く」は禁止。Yes\u002FNo で判定できる形にする。\n\n**Depends**: タスク間の依存関係。`-`（依存なし）、タスク番号（`N.1`）、カンマ区切り（`N.1, N.2`）、フェーズ依存（`Phase N`）。\n\n### TDD tags\n\nPlans.md の task には、TDD 判定を明示するタグを内容または DoD に書ける。\n\n| タグ                  | 意味                                       | `tdd_required` 推論                 |\n| --------------------- | ------------------------------------------ | ----------------------------------- |\n| `[tdd:required]`      | この task は先に失敗テストを書く必要がある | `true`                              |\n| `[tdd:skip:\u003Creason>]` | この task は理由つきで TDD を省略する      | `false`, `skip_tdd_reason=\u003Creason>` |\n\n`\u003Creason>` は空にしない。\n例: `[tdd:skip:docs-only]`、`[tdd:skip:no-test-framework-detected]`。\n\nタグがない場合の `tdd_required` は次の順で推論する。\n\n1. Plans.md tag: `[tdd:required]` \u002F `[tdd:skip:\u003Creason>]`\n2. files: `src\u002F`, `app\u002F`, `cmd\u002F`, `lib\u002F`, `pkg\u002F`, `internal\u002F`, `go\u002F` など source 実装を含むなら required\n3. TDD 推論: docs-only や test framework なしなら skip reason を付けて not required\n\n### optional briefs \u002F manifest\n\n`harness-plan create` は、必要なときだけ brief を付ける。\n\n- project spec SSOT は project 全体の正解条件を固定する文書で、必要時だけ作る\n- UI を含むタスクでは `design brief`\n- API を含むタスクでは `contract brief`\n- brief は「何を作るか」を短く固定する補助資料で、Plans.md や spec SSOT を置き換えない\n- skill frontmatter の一覧は `scripts\u002Fgenerate-skill-manifest.sh` で machine-readable JSON にできる\n\n参照:\n\n- `docs\u002Fplans\u002Fbriefs-manifest.md`\n- `docs\u002Fplans\u002Fspec-ssot.md`\n\n### マーカー一覧\n\n| マーカー    | 意味                         |\n| ----------- | ---------------------------- |\n| `pm:依頼中` | PM から依頼済み              |\n| `cc:TODO`   | 未着手                       |\n| `cc:WIP`    | 作業中                       |\n| `cc:完了`   | Worker 作業完了              |\n| `pm:確認済` | PM レビュー完了              |\n| `blocked`   | ブロック中（理由を必ず記載） |\n\n## 関連スキル\n\n- `harness-sync` — 実装と Plans.md を同期する\n- `harness-work` — 計画したタスクを実装する\n- `harness-review` — 実装のレビュー\n- `harness-setup` — プロジェクト初期化\n","# Harness Plan\n\nHarness の統合プランニングスキル。\n以下の3つの旧スキルを統合:\n\n- `planning` (plan-with-agent) — アイデア → Plans.md への落とし込み\n- `plans-management` — タスク状態管理・マーカー更新\n- `sync-status` — Plans.md と実装の同期確認\n\n## Quick Reference\n\n| ユーザー入力                             | サブコマンド | 動作                                                   |\n| ---------------------------------------- | ------------ | ------------------------------------------------------ |\n| \"計画を作って\" \u002F `\u002Fharness-plan create`  | `create`     | Spec delta \u002F skip reason → Plans.md task 生成          |\n| \"タスクを追加して\" \u002F `\u002Fharness-plan add` | `add`        | Plans.md に新タスク追加                                |\n| \"完了にして\" \u002F `\u002Fharness-plan update`    | `update`     | タスクマーカーを cc:完了 に変更                        |\n| \"今どこ？\" \u002F `\u002Fharness-plan sync`        | `sync`       | 実装とPlans.mdを照合・同期                             |\n| `\u002Fharness-sync`                          | `sync`       | 進捗確認（独立 sync surface と同等）                   |\n| `\u002Fharness-plan create`                   | `create`     | spec.md \u002F Plans.md 二正本の計画作成                    |\n| `\u002Fharness-plan list`                     | `list`       | `plans\u002Fmanifest.json` の named Plans を一覧            |\n| `\u002Fharness-plan switch \u003Cname>`            | `switch`     | active plan を `.claude\u002Fstate\u002Factive-plan.json` に保存 |\n\n## Literal companion commands（CC 2.1.108+）\n\n- `\u002Frecap`: 久しぶりに戻った時に要約を取り直してから `sync` へ入る\n- `\u002Fundo`: `\u002Frewind` の別名。直前の plan 更新を即座に戻したい時にそのまま使う\n\n## サブコマンド詳細\n\n### 標準の計画品質契約\n\nSee [references\u002Fplanning-quality.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fplanning-quality.md)\n\n`harness-plan` は、spec.md product contract and Plans.md task contract の co-required planning output を作る planning surface である。\nprecedence は `spec.md > sub-spec > Plans.md` のまま維持する。\nPlans.md は task ledger、root `spec.md` は product contract であり、上下関係は崩さない。\n渡された情報をそのまま Plans.md に落とさない。\n計画作成や大きな task 追加では、最新情報・既存仕様・記憶・TeamAgent \u002F サブエージェントによる複数視点の議論を確認し、\nこのプロダクトに取り入れるべき要素だけを task contract に変換する。\n`\u002Fharness-plan create` は `Spec delta` または `Spec skip reason` と `Plans.md` task 生成をセットで返す。\n出力には必ず `Spec delta` または `Spec skip reason` を含める。\n`Spec delta` \u002F `Spec skip reason` は Harness が生成し、consumer は承認・修正だけ行う。\n\n**Non-trivial planning gate**:\n\n単発・軽微タスクでない planning は、TeamAgent またはサブエージェント前提で扱う。\nここでの non-trivial は、複数 task \u002F 複数 file \u002F 複数 session \u002F product behavior \u002F API \u002F data model \u002F 権限 \u002F 課金 \u002F 外部連携 \u002F 配布面 \u002F セキュリティに影響する依頼を指す。\nTask tool が使える場合は Product \u002F Architecture \u002F Security \u002F QA \u002F Skeptic の独立視点を走らせる。\n使えない場合は `サブエージェント未使用` と明示し、同じ観点を単独で分けて評価する。\n\nnon-trivial planning の出力には、次の検証を必ず含める。\n\n- `team_validation_mode`: `not_required_lightweight` \u002F `native` \u002F `subagent` \u002F `manual-pass` \u002F `unavailable`\n- `spec.md` \u002F sub-spec \u002F `Plans.md` の整合性\n- harness-mem \u002F harness-recall \u002F repo memory による車輪の再発明防止確認\n- プロダクト目的から外れていないか\n- セキュリティ、権限、秘密情報、サプライチェーンに問題がないか\n- lint \u002F formatter baseline があるか。source code changes を含む plan で未設定なら、実装 task の前に setup task を置く\n- ちゃんと動く計画か。つまり test \u002F smoke \u002F CI \u002F review \u002F release gate が task DoD に落ちているか\n\n軽量 task は `team_validation_mode: not_required_lightweight` でよい。\nnon-trivial planning は `native` \u002F `subagent` \u002F `manual-pass` のいずれかを使う。\n`unavailable` のまま Required にしてはいけない。\nProduct \u002F Architecture \u002F Security \u002F QA \u002F Skeptic は検証 perspective であり、agent_type 名ではない。\n利用可能な TeamAgent \u002F Task サブエージェントに perspective として依頼し、任意 agent spawn を要求しない。\nSecurity gate は秘密情報の実読取を要求しない。\n`.env` や secret の read が必要になる場合は Risk Gate として止め、許可された既存 guard \u002F evidence で確認する。\n\n**適用する場面**:\n\n- `create` で新しい計画を作る\n- `add` で product behavior \u002F API \u002F 権限 \u002F 課金 \u002F 外部連携 \u002F 配布面に影響する task を足す\n- ユーザーが外部プロダクト、競合、仕様案、改善案、比較材料を渡した\n- 既存仕様や過去判断との衝突リスクがある\n\n**軽く扱ってよい場面**:\n\n- marker 更新だけの `update`\n- status 照合だけの `sync`\n- typo、format、README\u002FCHANGELOG のみ\n- 既存 spec とテストで正解が固定されている狭い変更\n\n**品質フロー**:\n\n1. 入力情報を分解し、評価対象・採点軸・不確かな事実を明示する\n2. 最新情報を取得する。外部事実は WebSearch \u002F 公式ドキュメント \u002F 一次情報を優先し、重要点は複数ソースでクロスチェックする\n3. 既存仕様・root `spec.md`・Plans.md・README・docs・CLAUDE.md・関連 skill を確認する\n4. harness-mem \u002F harness-recall \u002F `.claude\u002Fagent-memory\u002F` \u002F `.claude\u002Fstate\u002F` など、利用可能な記憶面を project-scoped で確認する\n5. non-trivial planning では TeamAgent \u002F Task サブエージェントを使い、Product \u002F Architecture \u002F Security \u002F QA \u002F Skeptic など異なる視点で独立レビューする\n6. source code changes を含む plan では lint \u002F formatter baseline を確認し、未設定なら setup task を先行させる\n7. 中立的な採点レビューを出し、Required \u002F Recommended \u002F Optional \u002F Reject に分類する\n8. `$easy` 形式で、提案内容・理由・どうなるのかを報告する\n9. 採用する案だけを root `spec.md` \u002F Plans.md \u002F test task へ落とし込む\n\n### create — 計画作成\n\nSee [references\u002Fcreate.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fcreate.md)\n\nアイデア・要件をヒアリングし、実行可能な Plans.md を生成する。\n\n**フロー**:\n\n1. 会話コンテキスト確認（直前の議論から抽出 or 新規ヒアリング）\n2. 何を作るか聞く（max 3問）\n3. **計画品質チェック**（最新情報、既存仕様、記憶、TeamAgent \u002F サブエージェント複数視点レビュー、採点）\n4. 技術調査（WebSearch）\n5. 機能リスト抽出\n6. **spec.md \u002F Plans.md 二正本チェック**（Spec delta または Spec skip reason + Plans.md task）\n7. 優先度マトリクス（Required \u002F Recommended \u002F Optional \u002F Reject）\n8. TDD 採用判断（テスト設計）\n9. Plans.md 生成（`cc:TODO` マーカー付き）\n10. 次のアクション案内\n\n### spec.md \u002F Plans.md 二正本チェック（デフォルト）\n\nPlans.md は「やるべきこと」の task contract、root `spec.md` は「何が正しいか」の product contract として扱う。\nco-required planning output は両方の出力を必須にするという意味であり、precedence は `spec.md > sub-spec > Plans.md` のまま維持する。\n実装がぶれる可能性がある時は、Plans.md 生成前に root `spec.md` を更新する。\n`create` と product-impacting `add` は毎回 root `spec.md` を読む。\n\n優先する保存先:\n\n1. root `spec.md`\n2. consumer repo に root `spec.md` がない時だけ、既存の project spec \u002F architecture \u002F product compass\n3. consumer repo に root `spec.md` がない時だけ、`docs\u002Fspec\u002F00-project-spec.md`\n4. 既存規約がある repo では、その規約に沿った spec path\n\n作成\u002F更新が必要な条件:\n\n- ユーザーに見える振る舞い、API、データモデル、権限、課金、外部連携を決める task\n- 複数の実装方針があり、選び方で product behavior が変わる task\n- 過去または今回の会話で「仕様が曖昧で実装がぶれた」兆候がある task\n- Plans.md には作業内容があるが、project としての正解条件が安定文書にない task\n\n不要な条件:\n\n- typo、format、dependency bump、README\u002FCHANGELOG のみ\n- 動作変更なしの狭い refactor\n- 既存 spec とテストで正解が十分に固定されている修正\n\n出力契約:\n\n- `Spec delta`: product contract を更新する時に、対象 spec path と変更点を書く\n- `Spec skip reason`: product contract を更新しない時に、理由を書く\n- `Spec delta` \u002F `Spec skip reason` は Harness が生成し、consumer は承認・修正だけ行う\n- docs-only \u002F mechanical task でも `Spec skip reason` を task context \u002F sprint contract に残す\n- missing search result、unavailable memory、未読ファイルを absent と断定しない。`not_observed != absent`\n- ユーザーに spec を一から書かせない。agent が既存 spec と入力から最小 delta を作り、曖昧な時だけ判断分岐を出す\n\n参照:\n\n- `docs\u002Fplans\u002Fspec-ssot.md`\n\n### create 完了時のセッション起動案内（必須）\n\n`create` が終わったら、説明だけで終わらせず、**新しいセッションの起動コマンド** と\n**起動後にそのまま入れる最初の指示プロンプト** をセットで案内する。\n\n優先順位は次の通り:\n\n1. 未完了タスクが 1 件だけ、または最初の 1 件だけ始めるのが自然\n   - 起動コマンド: `claude`\n   - 最初の入力: `\u002Fharness-work \u003Ctask番号>`\n2. 依存の薄いタスクが複数あり、まとめて進めるのが自然\n   - 起動コマンド: `claude`\n   - 最初の入力: `\u002Fbreezing all`\n   - 代替: `\u002Fharness-work all`\n3. 長時間実行や再入が前提\n   - 起動コマンド: `ENABLE_PROMPT_CACHING_1H=1 claude`\n   - 最初の入力: `\u002Fharness-loop all`\n   - 代替: `\u002Fbreezing all`\n\n最低でも次の 3 行を含める:\n\n- `新しいセッションの起動コマンド:`\n- `起動後の最初の入力:`\n- `向いている場面:`\n\n例:\n\n```text\n新しいセッションの起動コマンド: claude\n起動後の最初の入力: \u002Fbreezing all\n向いている場面: Phase 1 の task が複数あり、まとめて進めるほうが自然なため\n```\n\n長時間系を勧める場合は、Claude Code セッション起動コマンドも併記する:\n\n```text\n新しいセッションの起動コマンド: ENABLE_PROMPT_CACHING_1H=1 claude\n起動後の最初の入力: \u002Fharness-loop all\n向いている場面: 5 分を超える待機や resume をまたぐ長時間タスクのため\n```\n\n補足:\n\n- `scripts\u002Fclaude-longrun.sh` はこのリポジトリの開発補助スクリプトで、plugin install 後の consumer 環境には配布されない\n- そのため、consumer 向け案内では常に `ENABLE_PROMPT_CACHING_1H=1 claude` の 1 行コマンドを優先する\n- リポジトリ開発中だけ同等のラッパーを使いたい場合、`bash scripts\u002Fclaude-longrun.sh` はローカル checkout 上では利用してよい\n\n**CI モード** (`--ci`):\nヒアリングなし。既存の Plans.md をそのまま利用してタスク分解のみ行う。\n\n### add — タスク追加\n\nPlans.md に新しいタスクを追加する。\nproduct-impacting な追加では、上の「spec.md \u002F Plans.md 二正本チェック」に従い `Spec delta` または `Spec skip reason` も出力する。\n\n```\n\u002Fharness-plan add タスク名: 詳細説明 [--phase フェーズ番号]\n```\n\nタスクは `cc:TODO` マーカーで追加される。\n\n### update — マーカー更新\n\nタスクのステータスマーカーを変更する。\n\n```\n\u002Fharness-plan update [タスク名|タスク番号] [WIP|完了|blocked]\n```\n\nマーカー対応表:\n\n| コマンド        | マーカー  |\n| --------------- | --------- |\n| `WIP`           | `cc:WIP`  |\n| `完了` \u002F `done` | `cc:完了` |\n| `blocked`       | `blocked` |\n| `TODO`          | `cc:TODO` |\n\n### sync — 進捗同期\n\n実装状況と Plans.md を照合し、差分を検出・更新する。\n\nSee [references\u002Fsync.md](${CLAUDE_SKILL_DIR}\u002Freferences\u002Fsync.md)\n\n**フロー**:\n\n1. Plans.md の現状取得\n2. Plans.md フォーマット検出（v1: 3 カラム \u002F v2: 5 カラム）\n3. git status \u002F git log から実装状況取得\n4. エージェントトレース確認（`.claude\u002Fstate\u002Fagent-trace.jsonl`）\n5. Plans.md と実装の差分検出\n6. 未更新マーカーの自動修正提案\n7. 次のアクション提示\n\n**レトロスペクティブ**（デフォルト ON）:\n`cc:完了` タスクが 1 件以上あれば自動的に振り返りを実行する。\n見積もり精度、ブロック原因パターン、スコープ変動を分析し、学びを記録。\n`sync --no-retro` で明示的にスキップ可能。\n\n### team mode \u002F issue bridge\n\nPlans.md は正本のまま維持し、GitHub Issue 連携は opt-in の team mode だけで使う。\n\n- solo 開発では bridge を使わない\n- team mode は tracking issue を 1 つ作り、その配下に task ごとの sub-issue payload を dry-run で生成する\n- `scripts\u002Fplans-issue-bridge.sh` は実際に GitHub を更新せず、常に dry-run の payload を返す\n- Plans.md への変更はこの bridge では行わない\n\n参照:\n\n- `docs\u002Fplans\u002Fteam-mode.md`\n\n### named Plans\n\n複数の Plans.md を使う場合は `plans\u002Fmanifest.json` を正本にして、名前で選択する。\n\n```bash\nscripts\u002Fplan-registry.sh list\nscripts\u002Fplan-registry.sh switch roadmap\nscripts\u002Fplans-issue-bridge.sh --plan roadmap --format markdown\nnode scripts\u002Fgenerate-sprint-contract.js --plan roadmap 9.1.1\n```\n\n運用ルール:\n\n- 1 run では 1 つの named plan だけを使う\n- long-running \u002F CI \u002F issue bridge では active pointer に頼らず `--plan \u003Cname>` を渡す\n- manifest path は project root 相対のみ。絶対パス、`..`、repo 外 symlink は拒否される\n\n参照:\n\n- `docs\u002Fplans\u002Fnamed-plans.md`\n\n## Plans.md フォーマット規約\n\n### フォーマット\n\n```markdown\n# [プロジェクト名] Plans.md\n\n作成日: YYYY-MM-DD\n\n---\n\n## Phase N: フェーズ名\n\n| Task | 内容 | DoD                      | Depends  | Status  |\n| ---- | ---- | ------------------------ | -------- | ------- |\n| N.1  | 説明 | テスト通過               | -        | cc:TODO |\n| N.2  | 説明 | lint エラー 0            | N.1      | cc:WIP  |\n| N.3  | 説明 | マイグレーション実行可能 | N.1, N.2 | cc:完了 |\n```\n\n**DoD（Definition of Done）**: 検証可能な完了条件を 1 行で記述。「いい感じ」「ちゃんと動く」は禁止。Yes\u002FNo で判定できる形にする。\n\n**Depends**: タスク間の依存関係。`-`（依存なし）、タスク番号（`N.1`）、カンマ区切り（`N.1, N.2`）、フェーズ依存（`Phase N`）。\n\n### TDD tags\n\nPlans.md の task には、TDD 判定を明示するタグを内容または DoD に書ける。\n\n| タグ                  | 意味                                       | `tdd_required` 推論                 |\n| --------------------- | ------------------------------------------ | ----------------------------------- |\n| `[tdd:required]`      | この task は先に失敗テストを書く必要がある | `true`                              |\n| `[tdd:skip:\u003Creason>]` | この task は理由つきで TDD を省略する      | `false`, `skip_tdd_reason=\u003Creason>` |\n\n`\u003Creason>` は空にしない。\n例: `[tdd:skip:docs-only]`、`[tdd:skip:no-test-framework-detected]`。\n\nタグがない場合の `tdd_required` は次の順で推論する。\n\n1. Plans.md tag: `[tdd:required]` \u002F `[tdd:skip:\u003Creason>]`\n2. files: `src\u002F`, `app\u002F`, `cmd\u002F`, `lib\u002F`, `pkg\u002F`, `internal\u002F`, `go\u002F` など source 実装を含むなら required\n3. TDD 推論: docs-only や test framework なしなら skip reason を付けて not required\n\n### optional briefs \u002F manifest\n\n`harness-plan create` は、必要なときだけ brief を付ける。\n\n- project spec SSOT は project 全体の正解条件を固定する文書で、必要時だけ作る\n- UI を含むタスクでは `design brief`\n- API を含むタスクでは `contract brief`\n- brief は「何を作るか」を短く固定する補助資料で、Plans.md や spec SSOT を置き換えない\n- skill frontmatter の一覧は `scripts\u002Fgenerate-skill-manifest.sh` で machine-readable JSON にできる\n\n参照:\n\n- `docs\u002Fplans\u002Fbriefs-manifest.md`\n- `docs\u002Fplans\u002Fspec-ssot.md`\n\n### マーカー一覧\n\n| マーカー    | 意味                         |\n| ----------- | ---------------------------- |\n| `pm:依頼中` | PM から依頼済み              |\n| `cc:TODO`   | 未着手                       |\n| `cc:WIP`    | 作業中                       |\n| `cc:完了`   | Worker 作業完了              |\n| `pm:確認済` | PM レビュー完了              |\n| `blocked`   | ブロック中（理由を必ず記載） |\n\n## 関連スキル\n\n- `harness-sync` — 実装と Plans.md を同期する\n- `harness-work` — 計画したタスクを実装する\n- `harness-review` — 実装のレビュー\n- `harness-setup` — プロジェクト初期化\n",{"kind":23,"name":5,"pair":24,"role":25,"owner":26,"shape":23,"since":27,"effort":28,"purpose":29,"trigger":30,"description":7,"allowed-tools":31,"argument-hint":40,"description-en":7,"description-ja":41,"user-invocable":42},"workflow","harness-sync","generator","harness-core","2026-05-05","medium","Maintain co-required planning output for the spec.md product contract and Plans.md task contract","create a plan, add tasks, update Plans.md, check progress",[32,33,34,35,36,37,38,39],"Read","Write","Edit","Bash","Grep","Glob","WebSearch","Task","[create|add|update|sync|sync --no-retro|--ci]","HAR:調査・採点・記憶確認・TeamAgent\u002Fサブエージェント検証つきのタスク計画、Plans.md管理、進捗同期を担当。計画作って、タスク追加、Plans.md更新、完了マーク、進捗確認で起動。実装・レビュー・リリースには使わない。",true,"main","44656ee607735b31d88e298752f574936b85af75","agent-harnesses\u002Fclaude-code-harness\u002Fcodex\u002F.codex\u002Fskills\u002Fharness-plan","https:\u002F\u002Fgithub.com\u002FTimothy191\u002Farch-systems-portal","https:\u002F\u002Fgithub.com\u002FTimothy191","2026-07-24 02:57:18",{"source":8,"skillName":5,"commands":50,"prompt":60,"zipAvailable":42},[51,54,57],{"tool":52,"command":53},"npx","npx skills add Timothy191\u002Farch-systems-portal --skill harness-plan",{"tool":55,"command":56},"bunx","bunx skills add Timothy191\u002Farch-systems-portal --skill harness-plan",{"tool":58,"command":59},"pnpm","pnpm dlx skills add Timothy191\u002Farch-systems-portal --skill harness-plan","安装技能，技能地址：https:\u002F\u002Fgithub.com\u002FTimothy191\u002Farch-systems-portal\u002Fblob\u002Fmain\u002Fagent-harnesses\u002Fclaude-code-harness\u002Fcodex\u002F.codex\u002Fskills\u002Fharness-plan\u002FSKILL.md",[],[63,69,75,82,89,96],{"skillNo":64,"name":65,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":66,"categories":67,"keywords":68,"publishedAt":18},"01M79BVF4ZP6Z3GH36Y7BAAZHE","escape-skill","https:\u002F\u002Fgithub.com\u002FTimothy191\u002Farch-systems-portal\u002Fblob\u002Fmain\u002Fagent-harnesses\u002Fclaude-code-harness\u002Ftests\u002Ffixtures\u002Fskills\u002Fzz-review-escape\u002FSKILL.md",[],[],{"skillNo":70,"name":71,"nameZh":6,"description":6,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":72,"categories":73,"keywords":74,"publishedAt":18},"01M79BVE0FF9QC71P53B18GCQ8","zz-review-empty","https:\u002F\u002Fgithub.com\u002FTimothy191\u002Farch-systems-portal\u002Fblob\u002Fmain\u002Fagent-harnesses\u002Fclaude-code-harness\u002Ftests\u002Ffixtures\u002Fskills\u002Fzz-review-empty\u002FSKILL.md",[],[],{"skillNo":76,"name":77,"nameZh":6,"description":78,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":79,"categories":80,"keywords":81,"publishedAt":18},"01M79BVAB0TARBFRF4MCQ1T8AG","workflow-guide","Explicit helper for Cursor PM ↔ Claude Code two-agent workflow guidance. Do NOT load for: solo implementation, workflow setup, handoff execution, or general process coaching.","https:\u002F\u002Fgithub.com\u002FTimothy191\u002Farch-systems-portal\u002Fblob\u002Fmain\u002Fagent-harnesses\u002Fclaude-code-harness\u002Fskills\u002Fworkflow-guide\u002FSKILL.md",[],[],{"skillNo":83,"name":84,"nameZh":6,"description":85,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":86,"categories":87,"keywords":88,"publishedAt":18},"01M79BV634WBDSVR8DXAHMHA19","vibecoder-guide","Explicit helper for non-technical VibeCoder coaching: what to ask next, how to describe work, and how to stay safe. Do NOT load for: direct implementation, technical review, or Cursor\u002FPM workflow.","https:\u002F\u002Fgithub.com\u002FTimothy191\u002Farch-systems-portal\u002Fblob\u002Fmain\u002Fagent-harnesses\u002Fclaude-code-harness\u002Fskills\u002Fvibecoder-guide\u002FSKILL.md",[],[],{"skillNo":90,"name":91,"nameZh":6,"description":92,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":93,"categories":94,"keywords":95,"publishedAt":18},"01M79BV2G6901RYQGBT3QWDK64","ui","Explicit helper for UI components, hero sections, forms, feedback, and contact surfaces. Do NOT load for: authentication, backend implementation, database work, or business logic.","https:\u002F\u002Fgithub.com\u002FTimothy191\u002Farch-systems-portal\u002Fblob\u002Fmain\u002Fagent-harnesses\u002Fclaude-code-harness\u002Fskills\u002Fui\u002FSKILL.md",[],[],{"skillNo":97,"name":98,"nameZh":6,"description":99,"descriptionZh":6,"repositoryFullName":8,"ownerLogin":9,"ownerAvatarUrl":10,"ownerAccountNo":11,"ownerDisplayName":6,"repositoryNo":12,"starsCount":13,"licenseSpdxId":14,"licenseFileUrl":6,"sourceHtmlUrl":100,"categories":101,"keywords":102,"publishedAt":18},"01M79BTW2QT48HNNS9NCKE8PAH","session","Unified session management window. Handles initialization, memory, state all-in-one. Explicit \u002Fsession invocation only — sub-skills handle auto-delegation. Use when managing Claude Code sessions, \u002Fsession command. Do NOT load for: app user sessions, login state, authentication features.","https:\u002F\u002Fgithub.com\u002FTimothy191\u002Farch-systems-portal\u002Fblob\u002Fmain\u002Fagent-harnesses\u002Fclaude-code-harness\u002Fskills\u002Fsession\u002FSKILL.md",[],[]]