plangate-setup - SKILL.md Agent Skill

name: plangate-setup description: PlanGate 初期セットアップを対話的に進めるためのチェックリスト、5 要素対応観点、Human-owned 操作の script 提示テンプレ。doctor を単一検証源とする。Use when: 「PlanGate をセットアップして」「導入したい」「初期設定」「doctor が FAIL する」と依頼された時、または導入直後の環境検証時。

PlanGate Setup — チェックリスト & 観点

入力: doctor の構造化出力（--json）/ Human からの「完了」報告出力: 不足項目リスト / Human-owned 操作の提示文 / 進捗チェックリスト想定 phase: 初期セットアップカテゴリ: ガイド型セットアップ役割: 手順テンプレと検証観点を再利用単位で保持する

Setup の 5 要素対応

5 要素	対応物	検証	不足時の提示文
Context files	`CLAUDE.md` / `AGENTS.md`	ファイル存在確認	「CLAUDE.md を作成してください（プロジェクトルール記述）」
Global instructions	`.claude/settings.json` wiring	`doctor --check-settings`	「`sh scripts/apply-claude-settings.sh` を実行してください」
Folder/Project instructions	`docs/working/` 構造 + TASK 配下	ディレクトリ存在確認	「`mkdir -p docs/working/TASK-XXXX` で新規 TASK を作成してください」
Plugins	`.claude/agents/` / `.claude/skills/` / `.claude/commands/`	ディレクトリ存在確認	「`.claude/` 配下に必要な agents/skills/commands を配置してください」
Connectors	Hook（EH-3, EH-8, …）/ CI / MCP	`doctor --json` の `checks[]` で各項目を検査（scope: `v8.6.0 Metrics & Privacy`、EH-8 実行可能属性を含む）	「該当 Hook を `.claude/settings.json` の hooks セクションに wire してください」

doctor 出力の解釈観点

doctor --json の出力は以下を満たす（PlanGate プロジェクトの設計契約ノートを参照）:

{
  "scope": "...",
  "checks": [
    {"name": "...", "ok": true|false, "level": "fail|warn|info", "detail": "..."}
  ]
}

不足項目抽出

不足項目  := [c for c in checks if c.ok == false]
WARN 項目 := [c for c in checks if c.level == "warn"]
overall_pass := all(c.ok for c in checks if c.level == "fail")

提示時の順序

level=fail の ok=false 項目（必須）
level=warn 項目（推奨）
level=info の補足

Human-owned 操作テンプレ（提示文のみ・実行禁止）

セットアップ Agent はこれらをユーザーに提示するだけで、自分では実行しない:

# settings wiring 適用
sh scripts/apply-claude-settings.sh

# 個別 Hook の有効化（例）
# .claude/settings.json の hooks セクションに該当エントリを追加

チェックポイント記録

各 Step 完了ごとに status.md / decision-log.jsonl に追記する（working-context.md settings タスクロック準拠）:

status.md: Markdown 形式で完了マーカー
decision-log.jsonl: append-only JSON エントリ（pending → resolved）

解消不能 FAIL の脱出経路

doctor FAIL が環境制約等で解消困難な場合、以下のいずれかを提示する:

フォローアップ PBI 起票誘導: /ai-dev-workflow <new-task-id> brainstorm で別 PBI 起票（<new-task-id> は次の空き番号）
承知スキップ: ユーザーが「承知の上で skip」を選択 → status.md に skip 理由を明示記録

完了条件

setup が完了したと判定する条件:

doctor --json で overall_pass == true（level=fail の ok=false ゼロ）
かつ doctor --check-settings の出力が ^\[check-settings\] PASS: で始まる
ユーザーが対話内で完了を確認

完了サマリのフォーマット

status.md 末尾に以下のセクションを追記:

## Setup Summary - YYYY-MM-DD

- 完了項目: [...]
- スキップ項目（承知の上）: [...]
- 残課題: [...]
- 次のアクション候補:
  - 新規 PBI 作成: `/ai-dev-workflow <new-task-id> brainstorm`
  - 既存 PBI 確認: `/working-context <task_id>`（Agent が Step 0 で動的解決した値）
  - C-3 レビュー確認: `bin/plangate render <task_id>`（v8.14.0〜: HTML でレビュー資料を確認）
  - C-3 承認: `bin/plangate approve <task_id>`（v8.14.0〜: Human ワンアクション承認）