메뉴
アーキテクチャ決定の ADR 起票を担当する Skill。起票基準判定 + 採番 + テンプレ起草 + 関連 ADR 双方向リンク + INDEX 更新を実施。起票基準を満たさない決定は rules / epic decisions.md / learning への記録を推奨し、本 Skill は起草で完了する。 議論 / approve / merge は人間レビューに委ねる (Skill は merge を実行しない)。
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Plan / Epic 確定後の実装着手 → Lint/Test → AI Review → マージ → レトロ起動 → worktree クリーンアップを 10 フェーズ (Phase 0-9) で統合管理するオーケストレーター。 Phase 0 で git worktree を作成し、Phase 9 で削除することで複数 Claude Code セッションの 並行実装を物理分離する。`feature-request` / `bug-fix` / `refactor` / `dependency-upgrade` が起票した Plan / Epic 確定後の実装着手指示を受けたとき、または orchestrator skill が per-task pane に Phase 0-9 自走を委譲したときに本 Skill に従って動作する。
ローカル Claude Code 内でポーリング起動し、gh CLI で merged/closed PR を取得 → 未処理 PR があれば pr-retrospective を起動、Renovate ラベル PR があれば dependency-upgrade を起動するハーネスループ起点 Skill。3 系統の起動経路 (起動時 + CronCreate + ScheduleWakeup) に対応するため .claude/locks/pr-poller.lock で排他制御し、 pending-fetch 項目の再走査と harness-meta 自動起動の閾値判定も担当する。
外部研究 / ベストプラクティス駆動の改善ループを担う Skill。手動起動のみで cron 不採用 (ADR 0026)。 WebSearch / WebFetch + Context7 MCP でホワイトリスト外部情報源を取得し、既存ハーネス (`.claude/skills/` / `.claude/rules/` / `docs/`) と gap 分析を行い、 `docs/harness/evolution-proposals/YYYY-MM-DD.md` を出力する。重要案は `example-skills:skill-creator` 経由で Skill scaffold / Plan / EPIC 起票し、人間 approve を必須とする。
pr-retrospective が生成した learning ファイル群の「🤖 ハーネス改善提案」セクションを 入力に、harness-meta-criteria の採用 / 見送り / 撤去 3 分岐で判定し、採用は改修 PR (rule / Skill / ADR 起票) 起票、見送りは元 learning に「📝 harness-meta フィードバック」 追記、撤去は status removed → 物理削除の 2 段階 PR で実行する内部 KPT 駆動 Skill。 dry-run 必須条件該当時は dry-run 先行。
[archived A3-14 / 2026-05-18] Phase A の A1〜A10 を進める汎用 Skill。専用 Skill 群が A3 で出揃ったため archived 化。新規呼び出し禁止。本ファイルは履歴参照用。
対象 PR の diff / comments / reviews / CI ログ / Skill 実行ログ / 三層指標差分 / 関連 Plan・Epic を収集し、docs/harness/learnings/YYYY-MM-DD-pr-<n>.md を日本語の構造化フォーマットで生成する。 harness/learnings-batch-YYYY-WW ブランチに集約し、週次 (or 件数到達時) に PR として起票する。
| name | adr-author |
| description | アーキテクチャ決定の ADR 起票を担当する Skill。起票基準判定 + 採番 + テンプレ起草 + 関連 ADR 双方向リンク + INDEX 更新を実施。起票基準を満たさない決定は rules / epic decisions.md / learning への記録を推奨し、本 Skill は起草で完了する。 議論 / approve / merge は人間レビューに委ねる (Skill は merge を実行しない)。 |
| status | active |
| phase | A3 |
| last_updated | "2026-05-18T00:00:00.000Z" |
| related_plan | docs/harness/plan.md §A3 / §4.5 |
| related_rules | [".claude/rules/adr.md",".claude/rules/docs-structure.md",".claude/rules/template-language.md",".claude/rules/markdown.md"] |
| related_adrs | ["ADR-0001","ADR-0027"] |
5 行以内 summary: アーキテクチャ決定の ADR を
docs/adr/template.mdから起草する Skill。.claude/rules/adr.md§起票基準 (10 項目のうち 2 つ以上) を判定し、満たさない 決定は別記録方法 (rules / Epic decisions.md / Plan / learning / runbook) を推奨して 停止する。採番 + frontmatter 埋め + 本文起草 +related_adrs/supersedes/superseded_byの双方向リンク +docs/adr/README.mdINDEX 更新まで実施し、 Phase 6 で人間レビューに handoff する。議論 / approve / merge は人間が担当。
.claude/rules/adr.md §起票基準
10 項目のうち 2 つ以上を満たすか判定docs/adr/template.md を base に docs/adr/ADR-NNNN-<kebab-slug>.md を起草、frontmatter +
本文 (ステータス / コンテキスト / 決定 / 根拠 / 帰結 / §4.5 起票基準充足チェック / 関連) を埋めるrelated_adrs / supersedes / superseded_by)、
supersede 関係がある場合は対向 ADR の frontmatter にも superseded_by を書き込むdocs/adr/README.md の一覧テーブルに新行を追加 (ADR ID / 状態 / 内容 / 起票根拠 (§4.5) /
関連 rule / ファイル)proposed → accepted) /
PR merge は人間レビューに委ねるdocs/adr/ADR-*.md + docs/adr/README.md 一覧テーブル): 採番衝突回避 /
双方向リンクの対向 ADR 解析に使用.claude/rules/adr.md §起票基準): 10 項目のうち 2 つ以上の充足判定に使用docs/adr/template.md): frontmatter / 本文構造の雛形docs/adr/ADR-NNNN-<kebab-slug>.md
id / title / status: proposed (起草時は固定) / date / related_epics /
related_plans / related_specs / superseded_by / supersedesdocs/adr/README.md 一覧テーブルに新行追加
(| NNNN | proposed | <内容> | <起票根拠 §4.5> | <関連 rule> | [ADR-NNNN](ADR-NNNN-<slug>.md) |)supersedes: ADR-MMMM を宣言する場合、
ADR-MMMM 側の frontmatter superseded_by を新 ADR ID に書き換え + 状態を superseded に更新.claude/rules/adr.md §起票基準 10 項目を逐一チェック、2 つ以上満たすか判定.claude/rules/adr.md §ADR 化見送りの理由テンプレ 3 条件 (撤回コスト低 /
scope が config N ファイル限定 / 既存 rule 本体の改定なし) を順に確認し、3 条件すべて
満たす場合のみ ADR 化見送りが正当と判定。該当する場合は EPIC decisions.md / PR
description / Plan に「ADR 起票基準 (§起票基準) を満たさないため見送り、撤回コスト低 /
scope は <files> 限定 / 既存 rule 本体の改定なし」と明記して記録を推奨 (PR #129 で
.claude/settings.json の permissions.allow 拡張時に本テンプレを適用し、当時予約していた
ADR-0028 番号での起票を見送って EPIC-A2 decisions.md に判断ログを残した実績、本見送りで
解放された ADR-0028 番号は後に PLAN-002 / PR #171 で 3 軸定量評価フレーム ADR に再割当)docs/adr/ADR-*.md ファイル名 + docs/adr/README.md 一覧テーブル) を走査して
最大番号を取得、+1 で新 ADR 番号を確定 (4 桁ゼロパディング、ADR-NNNN)git status / git log --oneline -5 docs/adr/ で直近の差分を確認docs/adr/template.md を copy して docs/adr/ADR-NNNN-<slug>.md を作成、frontmatter の
プレースホルダ (ADR-NNNN / <タイトル> / YYYY-MM-DD / related_* / superseded_by /
supersedes) を実値で埋めるstatus は proposed 固定 (起草時、accepted 遷移は人間レビュー後の別操作)> **5 行以内 summary**: ...) を必須記入 (.claude/rules/docs-structure.md §各 docs 構造)docs/adr/template.md §ADR 起票基準 (§4.5) の充足 / SoT は .claude/rules/adr.md §起票基準 + docs/harness/plan.md §4.5) で該当項目に [x] をマーク (2 つ以上充足が条件)[x] を付与.claude/rules/template-language.md)、コード断片は英語 / プレーン
テキストは ```text 言語指定 (.claude/rules/markdown.md)related_adrs / supersedes / superseded_by を抽出[] 明示、docs-structure.md
frontmatter 規約)supersedes: ADR-MMMM を宣言する場合、対向 ADR (ADR-MMMM) の frontmatter superseded_by
を新 ADR ID に書き換え + status を superseded に更新 (supersede は新旧の決定差し替えを
明示する操作のため、accepted immutable 原則の例外として対向 frontmatter 改変が許容される)related_adrs は双方向リンクが望ましいが、対向 ADR が accepted 以降で immutable な場合
(= supersede 以外の単純参照関係の場合) は対向側を改変せず、新 ADR 側のみ
related_adrs: [ADR-MMMM] を記入する片方向リンクに留める。例: 新 ADR が ADR-0017 (ハーネス
ローカル Claude Code ポーリング駆動、accepted) を参照したいが新旧差し替え関係ではない場合、
ADR-0017 側の related_adrs には追記せず新 ADR 側のみ参照を記入 (.claude/rules/adr.md
§Gotchas「accepted 以降は本文を改変しない」原則と整合)docs/adr/README.md の一覧テーブルに新行を追加:
| NNNN | proposed | <内容簡潔> | <起票根拠 §4.5 の該当番号カンマ区切り> | <関連 rule のリスト> | [ADR-NNNN](ADR-NNNN-<slug>.md) |status: proposed のまま停止し、人間レビュー → accepted 遷移 → PR レビュー → merge は
人間が担当accepted 以降の immutable
原則に注意、§Gotchas 参照).claude/rules/adr.md §起票基準 10 項目のうち
2 つ以上を満たさない場合は ADR 起草を見送り、別記録方法 (rules / Epic decisions.md /
Plan / learning / runbook) を提案。撤回コスト低 / config N ファイル限定 / 既存 rule 本体
改定なしの 3 条件を満たすなら §ADR 化見送りの理由テンプレ に従う (PR #129 で実績、当時予約
していた ADR-0028 番号での起票を見送り EPIC-A2 decisions.md に記録。本見送りで解放された
ADR-0028 番号は PLAN-002 / PR #171 で 3 軸定量評価フレーム ADR に再割当)supersedes: ADR-MMMM 宣言時は対向 ADR の superseded_by も同 PR
内で更新。片方向だけ書くと A6 機械検証 (相互参照の実在チェック) で reject されるsuperseded_by の整合性: 対向 ADR の status も superseded に更新が必要。accepted
のまま superseded_by を埋めると status 語彙と矛盾 (MADR 4 状態の遷移ルール違反)git status + git log --oneline -5 docs/adr/ を確認、可能なら git fetch origin master
で latest と同期してから採番accepted 以降は本文を改変しない: 既存 ADR を accepted から書き換える要求が来ても、
本 Skill は新 ADR (supersede) を提案して旧 ADR は immutable に保つ。誤記訂正のみ
docs/adr/README.md 側に正誤表を追記proposed / accepted / deprecated / superseded by ADR-NNNN の
MADR 4 状態以外を使わない (.claude/rules/adr.md §採番・命名・ステータス).claude/rules/<name>.md が SoT」と書くと
循環参照になり A6 トレーサビリティ機械検証が弱まる (.claude/rules/adr.md §ADR ⇄ rule の
SoT 方向、PR #119 レトロ Try)。委譲先の明示 (「運用詳細は rule に委譲」) は OKfile_path:line 参照 / 30 行以内の最小例 / ```text 言語指定など
.claude/rules/markdown.md の規約に従うrelated_adrs: [ADR-0001, ADR-0011] の flow 形式は
禁止 (.claude/rules/docs-structure.md §配列はブロック形式を強制)。要素ゼロのみ [] 許容title ⊇ H1 (完全一致または短縮形許容)。別表現は
NG (.claude/rules/docs-structure.md §title と H1 の表記方針、PR #126 レトロ Try)status: proposed →
accepted 遷移は人間が議論結果を反映して別操作で行う。auto-merge は禁止 (R-15).claude/rules/adr.md (ADR 起票基準 + 採番規約 + status 語彙 + ADR ⇄ rule SoT 方向).claude/rules/docs-structure.md (frontmatter 規約 / 命名規約 / 5 行 summary).claude/rules/template-language.md (日本語必須、Phase A 経過措置).claude/rules/markdown.md (見出し / frontmatter / code block / 表記規約)docs/adr/template.md (本 Skill が copy する雛形)docs/adr/README.md (本 Skill が更新する INDEX)docs/harness/plan.md §4.5 (ADR 判断フロー Mermaid) / §A3 (本 Skill の責務 SoT).claude/skills/plan-author/SKILL.md (テンプレ起票責務の構造参考).claude/skills/epic-author/SKILL.md (同上)