AI駆動開発 リポジトリ運用キット
AGENTS.md・ADR・運用Runbook・レビューチェックリストを、本番運用に耐える粒度まで書き込んだドキュメント一式です。
コーディングエージェントに任せる範囲が広がるほど、判断の記録と手順の明文化が品質を決めます。このキットは、ひとりで運用しているリポジトリにそのまま置ける形で、指示書・意思決定記録・運用手順・レビュー基準・エージェント用コマンドをまとめたものです。空欄だらけの雛形ではなく、実際に運用されている文面をベースにしています。
収録内容
書き込み済みの AGENTS.md
セクション見出しだけの雛形ではなく、原則・境界・禁止事項・完了の定義まで文章として書かれた状態で入っています。プロジェクト固有の箇所は角括弧で明示してあるので、置き換える場所が一目で分かります。
ADR テンプレート+記述例7本
「ADRを書きましょう」で終わらせず、そのまま使えるテンプレートに加えて、実際に判断が割れる論点(永続化の追加、公開URL変更、外部ベンダー採用、AI生成コードの扱い、エラー処理方針、依存追加の基準)を題材にした記述例7本を収録しています。
運用 Runbook 7本
リリース、ロールバック、シークレットのローテーション、インシデント対応、依存更新、データ移行、権限棚卸し。ひとりで運用していると後回しになりがちな手順を、手順番号と判断基準つきで用意しています。
AI生成コード向けレビュー基準
人間が書いたコードとは壊れ方が違います。生成コード特有の失敗(もっともらしい嘘のAPI、握り潰された例外、テストの共犯化、過剰な抽象化)を検出するための、専用チェックリストを収録しています。
エージェント用コマンド定義
Claude Code の `.claude/commands/` にそのまま置けるコマンドを8本収録。計画立案、ADR起票、レビュー、AI生成コード検査、リリース前確認、Runbook作成、障害対応、作業引き継ぎを、毎回プロンプトを書き直さずに呼び出せます。他のエージェント向けに、非依存のプロンプトも4本入っています。
導入手順つき
新規リポジトリへの導入と、既に動いている既存リポジトリへの後付け導入の両方を README と UPGRADING.md に記載しています。全部入れる必要はなく、優先順位も示しています。
こんな人向け
- ひとり、または少人数でプロダクトを運用している開発者
- コーディングエージェントに実装を任せる範囲を広げたい人
- 判断の記録と運用手順を整えたいが、ゼロから書き起こす時間がない人
含まれるファイル
全49ファイル。この一覧はアーカイブの中身から生成しています。
/
- AGENTS.md
- CHANGELOG.md
- CLAUDE.md
- LICENSE.md
- README.md
- UPGRADING.md
.claude
- settings.json
.claude/commands
- adr.md
- ai-review.md
- handoff.md
- plan.md
- review.md
- runbook.md
- ship.md
- triage.md
.github
- pull_request_template.md
.github/ISSUE_TEMPLATE
- bug_report.md
- feature_request.md
.github/workflows
- ci.yml
docs
- architecture.md
- glossary.md
- product.md
docs/adr
- 0000-template.md
- 0001-record-architecture-decisions.md
- 0002-introduce-persistence.md
- 0003-change-public-urls.md
- 0004-adopt-external-vendor.md
- 0005-ai-generated-code-policy.md
- 0006-error-handling-and-observability.md
- 0007-dependency-policy.md
- README.md
docs/checklists
- ai-generated-code.md
- code-review.md
- dependency-intake.md
- release-readiness.md
- security-review.md
docs/operations
- 001-release.md
- 002-rollback.md
- 003-secret-rotation.md
- 004-incident-response.md
- 005-dependency-upgrade.md
- 006-data-migration.md
- 007-access-review.md
- README.md
prompts
- agent-onboarding.md
- bug-investigation.md
- README.md
- refactor-plan.md
- spec-to-tasks.md