ドキュメントを活かす コマンド設計の実践

Transcript

1. ドキュメントを活かす コマンド設計の実践 Qiita Bash vol.6 Claude Code × Context Engineering
2. 自己紹介 所属：株式会社じげん 名前：前川和也 趣味：カメラ、漫画、コーヒー、洋服
3. 前提 •新規立ち上げプロジェクト •クリーンアーキテクチャ採用 •ソースコードと同じリポジトリでドキュメントも管理している Claude Codeにドキュメントを参照して実装してもらうが、、 ❌ ドキュメントのルールを守らない ❌ コード品質がバラバラ ❌ 長時間で崩れる（Context Rot）
4. Before - プロンプトで全てやっていた コードレビューを依頼するたびに • 「git diffで変更を見て、、、」 • 「backend-checklist.mdを参照して、、、」 • 「architecture.mdを参照して、、」 • いろいろ追加情報を与えている内に ◦ 関係ない指摘をしたり、本質的でない指摘をしてくる • 参照したドキュメント通りの修正をしない ◦ 依存関係の逆転を見逃す 結果
5. After - コマンド化 + Context Engineeringの導入 エージェント分割 用途ごとにContextを分離 + Just-in-time参照 必要な時に、必要な情報だけ Context Engineeringの原則 プロンプト → ContextEnginneringを取り入れたコマンド
6. 作成したコマンド 開発フロー全体をカバー /plan-implementation 要件定義、実装計画作成コマンド マークダウンで要件定義書、要件に基づいた実装計画書を作成する /tdd-excute 実装コマンド plan-implementationで作成した実装計画を元にphaseごとに実装する /code-review Git diff検出 → 自動レビュー
7. /code-review の設計 ① エージェント分割 /code-reviewの中でcode-quality-guardianエージェント起動 → レビュー専用のContextで実行 ② Just-in-time参照（3階層で段階的に） Level 1: プロジェクト固有原則（常時） work-principles.md, implementation-lessons.md Level 2: 技術スタック別（変更時のみ） Backend変更：backend-checklist.md Frontend変更：frontend-checklist.md Level 3: コーディング規約（詳細確認時のみ） php-backend.md, react-frontend.md
8. エージェント 呼び出し バックエンドのドキュメント読み込み 変更ファイルの 読み込み タスク実行 （エージェント）
9. 修正すべき事項の指摘 修正方法の提示 指摘と修正方法の提示
10. まとめ できたこと まだまだな部分 • Context安定 → コード品質向上 • コマンド化 → プロンプト工数削減 • 一貫性のある開発フロー • コマンド・エージェントを継続的にブラッシュアップ中 ◦ 精度は向上したが、おかしなものが出ることもある • ドキュメント肥大化への対応を模索中 ◦ 定期的に重複を削除したりなどは行っている