| name | harness-bootstrap |
| description | [archived A3-14 / 2026-05-18] Phase A の A1〜A10 を進める汎用 Skill。専用 Skill 群が
A3 で出揃ったため archived 化。新規呼び出し禁止。本ファイルは履歴参照用。
|
| status | archived |
| phase | B0 |
| archived_at | "2026-05-18T00:00:00.000Z" |
| archived_pr | A3-14 |
| related_plan | docs/harness/plan.md §6.2 |
| related_rules | [".claude/rules/adr.md",".claude/rules/docs-structure.md",".claude/rules/skill-authoring.md",".claude/rules/template-language.md",".claude/rules/harness-meta-criteria.md",".claude/rules/retrospective-format.md"] |
harness-bootstrap (archived A3-14)
本ファイルは archived 済み。A3 で専用 Skill 群が出揃ったため、Phase A 用の汎用 Skill としての
役割は終了。新規呼び出しは禁止し、各タスク種別は対応する専用 Skill を使用すること。
本セクション以下は履歴参照用に残置 (元の B0 骨格)。
撤去理由 (A3-14)
- 撤去日: 2026-05-18 (EPIC-A3 A3-14 PR でマージ)
- 理由: A3 で feature-request / bug-fix / refactor / adr-author / harness-meta /
harness-evolution / dependency-upgrade / implementation-workflow / code-reviewer /
pr-retrospective / pr-poller / roadmap-tracker / ui-snapshot の 13 Skill が出揃い、
本 Skill が担っていた汎用起票・起草の責務は全て専用 Skill に移行済
(
docs/harness/plan.md §6.2 A3 / R-6)。
- 代替先 (タスク種別 → 専用 Skill): ADR 起草 →
adr-author / rules 拡充・docs 拡充 →
対応する Plan / Epic から implementation-workflow 経由 / retro 集約改善 → harness-meta
(dry-run 必須条件は .claude/rules/harness-meta-criteria.md §dry-run 必須条件を参照) /
Skill 実装 → example-skills:skill-creator (ADR 0025)。
- 復活時の操作:
.claude/skills/archived/harness-bootstrap/ から
.claude/skills/harness-bootstrap/ へ git mv で戻し、frontmatter status を
archived → active、archived_at / archived_pr を削除、CLAUDE.md /
.claude/rules/rules-index.md / 関連 rule の参照を復活。ただし復活前に「専用 Skill の
責務分担でカバーできない gap」が ADR / Epic レベルで明示されていることを前提とする
(汎用 Skill 復活は anti-pattern)。
本ファイルは B0 で配置する 最小スケルトン。本格実装は Phase A 内 (主に A1-A3) で行う。
役割
専用 Skill 群 (feature-request / bug-fix / refactor / adr-author / harness-meta 等) が
A3 で揃うまで、harness-bootstrap が一時的に汎用 Skill として A1〜A10 の起票・起草を担当する。
A3 完了後に .claude/skills/archived/ へ移動し、CLAUDE.md からの参照も外す。
タスク種別の自動判定 (入力パスベース)
| 入力パスのパターン | モード |
|---|
docs/adr/*.md を作成・更新 | ADR 起草モード |
.claude/rules/*.md を作成・更新 | rules 拡充モード |
docs/{requirements,specifications,architecture,api,security,runbooks}/** を作成・更新 | docs 拡充モード |
.claude/skills/*/ を作成 | Skill 実装モード (example-skills:skill-creator を呼び出す) |
| モジュールディレクトリ削除指示 | 撤去モード |
build.gradle.kts / lint 設定追加 | Lint 導入モード |
複数 merged retro の 🤖 ハーネス改善提案 を集約消化する指示 | retro 集約改善モード (PR #139 で実証、harness-meta Skill 本格化 A3/A4 までの暫定運用) |
複数該当時はユーザーに確認する。
retro 集約改善モード (PR #141 レトロ Try / 人間追加最優先)
PR #139 で 8 retro × 約 47 件の改善提案を 1 PR で集約消化した手動代替実行パターン。
harness-meta Skill 本格化 (A3/A4) までの暫定運用として、本 Skill が以下の 4 ステップを担う。
本格実装 (subagent 並列 dedupe + 採用判定 + dry-run + PR 起票) は A3/A4 harness-meta Skill に委任、
本セクションは 配置のみ (詳細仕様は .claude/rules/harness-meta-criteria.md を参照)。
ステップ 1: merged retro 全件 parse
- 入力:
docs/harness/learnings/YYYY-MM-DD-pr-<n>.md の 🤖 ハーネス改善提案 セクション
- 抽出:
[rule] / [skill] / [template] / [remove] プレフィックス付きの未消化提案
- 出力: 提案リスト (PR 番号 × カテゴリ × プレフィックス × 採用判定基準該当箇所)
ステップ 2: dedupe + カテゴリ化 + スコープ分類
- dedupe: 同一トピックの提案を 1 件に集約 (例: A1 レトロ rules-index 正規化 ⇄ A2-3 status drift)
- カテゴリ化: rule / skill / template / docs / ADR / 横断 learnings 別
- スコープ分類: 採用判定基準 1-5 (
harness-meta-criteria.md §採用判定基準) のどれを満たすか
ステップ 3: dry-run フェーズ (PR #141 レトロ Try / 人間追加最優先)
.claude/rules/harness-meta-criteria.md §dry-run 必須条件 を参照し、改善提案ごとに dry-run 必要 / 不要を判定。
必要な提案については以下の 5 ステップで適用前検証を実施:
- dry-run 入力: 改善提案を適用した rule / template / skill / docs と、未適用の既存版 (両 commit / branch / worktree のどれを使うかは設計時に確定、A3/A4 本格化時に worktree 並列が候補)
- dry-run 実行: 適用版と未適用版それぞれに対して、過去 retro で問題視された具体的シナリオを AI (サブエージェント、Generator 独立性のため別 system prompt) に投げて出力を比較。シナリオ抽出元は対象 retrospective の
⚠️ Problem セクション (再現条件 + 過去の AI 出力との対比で判定可能なもの)
- 判定基準: 適用版が未適用版より明らかに望ましい出力 (誤検知減 / 規約遵守率向上 / 提案精度向上) を出す場合のみ commit + push に進む。改善が見られない / 退化する場合は変更を破棄 or 別案検討
- dry-run 結果記録:
docs/harness/dry-runs/YYYY-MM-DD-pr-NNN.md (テンプレ: docs/harness/dry-runs/template.md、索引: docs/harness/dry-runs/INDEX.md) に before/after の AI 出力差分と判定理由を残す
- 必須条件参照: 適用 / 未適用判定が曖昧な場合は
.claude/rules/harness-meta-criteria.md §dry-run 必須条件 §必須条件不一致時のフォールバック に従い orchestrator (subroh0508) に判定委任
dry-run スキップ可の提案 (typo 修正 / リンク追加等、harness-meta-criteria.md §dry-run 不要 表参照) は本ステップを skip して直接ステップ 4 へ。
ステップ 4: PR 起票 + 📝 harness-meta フィードバック 一括追記
- PR ブランチ:
harness/<purpose> (.claude/rules/branch-naming.md 参照)
- PR テンプレ:
.github/PULL_REQUEST_TEMPLATE/harness.md (.claude/rules/pr-template.md 参照)
- 各 retro の
📝 harness-meta フィードバック セクションに「採用」「見送り」表を一括追記
(PR 番号は起票後に確定、placeholder 残存検出は A6 機械検証で実装予定)
- N PR vs 1 PR 包括判断は
harness-meta-criteria.md §分割粒度 を参照
Gotchas
- 本 Skill は B0 時点では雛形のみ。本格動作は Phase A で実装する。
- ADR 起草モードでは
.claude/rules/adr.md の起票基準を必ず参照する。
- Skill 実装モードでは新規 Skill を本リポジトリに作成せず、Claude Code ユーザースコープの
example-skills:skill-creator を呼び出すこと (ADR 0025)。
- retro 集約改善モードの dry-run フェーズは A3/A4 harness-meta Skill 本格化までは手動代替実行: subagent 並列 / 出力比較 / 判定の自動化は未実装、本セクションは仕様の placeholder。本格実装は ADR 0025 (Skill 作成は
example-skills:skill-creator 経由) に従い harness-meta Skill 起票時に skill-creator が rubric 評価する。
- dry-run 必須 / 不要の判定は
harness-meta-criteria.md §dry-run 必須条件 を SoT とする: 本 Skill 内で重複定義しない (重複時は rule 側を優先、本 Skill 側は誘導のみ)。
- dry-run 結果記録ファイルは
docs/harness/dry-runs/YYYY-MM-DD-pr-NNN.md: テンプレ / 索引は同ディレクトリの template.md / INDEX.md を参照。
関連
docs/harness/plan.md §5.3 (Skill の責務)docs/harness/plan.md §6.2 A1-A3 (Phase A での本格動作内容)
