feat: Claude Code向けCLAUDE.mdとskillsを生成

[shogo-hs]

概要

• Claude Code 向けの生成物として CLAUDE.md と .claude/skills/<playbook>/SKILL.md を scripts/sync_ai_context.py から配布する。
• AGENTS.md（Codex）・.cursor/rules/*.mdc（Cursor）と同じ正本から生成し、CI の drift 検査の対象に含める。

背景 / 目的

• Claude Code は AGENTS.md を自動では読まない（公式 memory ドキュメント）。このテンプレートから起こしたプロジェクトで Claude Code を使うと、規約も Playbook も効いていなかった。
• 公式が推奨する「CLAUDE.md から @AGENTS.md を import する」方式を採り、正本を増やさずに 3 ツールへ同じ規約を配る。

変更内容

• scripts/sync_ai_context.py
  • OUTPUT_FILES に CLAUDE.md を追加。中身は自動生成ヘッダと @AGENTS.md の 1 行（build_claude()）。
  • Playbook の生成結果を docs/ai/playbooks/<name>.md に加えて .claude/skills/<name>/SKILL.md にも出す。canonical playbook の frontmatter は既に name / description の SKILL.md 形式なので変換は不要。
• .github/workflows/ai-context-sync.yml: 監視 paths に CLAUDE.md と .claude/skills/** を追加。
• docs/ai/canonical/task-routing.md: 使い分けルールに Claude Code への配布先を 1 行追加（AGENTS.md / Cursor rule にも再生成で反映）。
• README.md: タイトルを python-project-template に、目的・構成・更新方針・併用ポリシーに Claude Code を追加。
• 生成物: CLAUDE.md、.claude/skills/{task-design-gate,python-uv-ci-setup,python-project-bootstrap,api-spec-sync,adr-management,git-commit}/SKILL.md。

採らなかった案: CLAUDE.md を AGENTS.md と同内容で複製（drift 対象が増えるだけ）、symlink（README の symlink 不使用方針に反する）、.claude/rules/ 分割（CLAUDE.md で全量読まれるので重複）、.claude/commands/（skills に統合済みの旧形式）。

影響範囲

• backend
• frontend
• docs
• infra
• CI

検証

• python3 scripts/sync_ai_context.py → CLAUDE.md と SKILL.md × 6 を生成。
• python3 scripts/sync_ai_context.py --check → [OK] Generated files are up to date.
• 生成した SKILL.md に 1 行追記 / CLAUDE.md を削除 → --check が exit 1 で該当パスを列挙。再生成で OK に戻る。
• 各 .claude/skills/<name>/SKILL.md と docs/ai/playbooks/<name>.md は diff -q で一致。
• リポジトリ直下で claude -p --model haiku --setting-sources project --strict-mcp-config を起動し、ツール不使用で回答させた結果:
  • 利用可能スキルに 6 Playbook 名がすべて列挙された
  • CLAUDE.md 経由で AGENTS.md の「uv add / uv remove / uv sync を使用し pip install は使用しない」を引用した
  • タスクルーティング表の 6 Playbook 名を順どおり列挙した

AI実行ログ（AIが作成した場合は必須）

• 使用したエージェント: Claude Code（Claude Fable 5.1）
• 使用した主な参照ドキュメント: AGENTS.md / git-commit Playbook / Claude Code 公式 docs（memory・skills）
• 自動生成後に人間が確認した観点: 仕様整合（@AGENTS.md import と SKILL.md 形式）/ 機密情報の不在 / --check と実機起動

チェックリスト

• 変更理由を説明できる
• 追加・更新したドキュメントを列挙した
• 機密情報を含んでいない
• 必要なテスト/検証を実施した

https://claude.ai/code/session_017RDs6b7t4eWt2KJK7Kus2t