mcpField
A
archon-dev

archon-dev

github.com/coleam00開発23.8k247 回インストール今日更新
リポジトリ

archon-dev について

archon-dev は、調査、計画、実装、レビュー、デバッグ、GitHub の各タスクに応じてクックブックへ案内する開発ワークフロースキルです。専用ディレクトリに成果物を整理し、プロジェクト固有の規約と根拠を重視します。

主な機能

  1. 01意図に応じたクックブックへの振り分け
  2. 02調査・計画・実装のワークフロー
  3. 03コードレビューとデバッグの指針
  4. 04GitHub の Issue とプルリクエスト対応
  5. 05プロジェクト成果物の整理

活用シーン

  1. 01コードベースの仕組みを調査
  2. 02要件から実装計画を作成
  3. 03プルリクエストのレビューや障害調査

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/coleam00/archon --skill archon-dev

インストール後、Claude Code で/archon-devを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

cookbooks/
commit.md
debug.md
implement.md
investigate.md
issue.md
plan.md
pr.md
prd.md
research.md
review.md

詳細

archon-dev

開発ワークフロー — 調査、計画、構築、レビュー、リリース。

現在の状態

  • ブランチ: !git branch --show-current 2>/dev/null || echo "not in git repo"
  • 成果物: !ls .claude/archon/ 2>/dev/null || echo "none yet"
  • 進行中の計画: !ls .claude/archon/plans/*.plan.md 2>/dev/null | head -5 || echo "none"

ルーティング

$ARGUMENTS を読み取り、読み込むクックブックを判断してください。

ユーザーがクックブックを明示的に指定している場合（例：「plan」「implement」）は、それを使用してください。 それ以外の場合は、キーワードから意図を判断してください。

意図キーワードクックブック
コードベースに関する質問、既存の内容の文書化"research", "how does", "what is", "where is", "trace", "find"cookbooks/research.md
戦略的調査、ライブラリの評価、実現可能性"investigate", "should we", "can we", "compare", "evaluate", "feasibility", "best way to", "best approach"cookbooks/investigate.md
製品要件の作成"prd", "requirements", "spec", "product requirement"cookbooks/prd.md
実装計画の作成"plan", "design", "architect", "write a plan"cookbooks/plan.md
既存の計画の実行"implement", "execute", "build", "code this", .plan.md へのパスcookbooks/implement.md
コードまたは PR のレビュー"review", "review PR", "code review", "review changes"cookbooks/review.md
デバッグまたは根本原因分析"debug", "rca", "root cause", "why is", "broken", "failing"cookbooks/debug.md
変更のコミット"commit", "save changes", "stage"cookbooks/commit.md
プルリクエストの作成"pr", "pull request", "create pr", "open pr"cookbooks/pr.md
GitHub への報告"issue", "report to gh", "log in github", "file a bug", "feature request", "create issue", "gh issue"cookbooks/issue.md

判断が曖昧な場合：どのクックブックを使用するか、ユーザーに尋ねてください。

ルーティング後：該当するクックブックファイルを読み、その指示に正確に従ってください。

ワークフローの連携

クックブックは相互に連携します。1つを完了したら、次のステップを提案してください。

research ──► investigate ──► prd ──► plan ──► implement ──► commit ──► pr
                              ▲                    │
             debug ───────────┘      review ◄──────┘
                 │
                 ▼
               issue ──► plan (if feature) or debug (if bug)

成果物ディレクトリ

すべての成果物は .claude/archon/ に保存します。初回使用時に必要に応じてサブディレクトリを作成してください。

.claude/archon/
├── prds/              # Product requirement documents
├── plans/             # Implementation plans
│   └── completed/     # Archived after implementation
├── reports/           # Implementation reports
├── issues/            # GitHub issue investigations
│   └── completed/
├── reviews/           # PR review reports
├── debug/             # Root cause analysis
└── research/          # Research findings

プロジェクトの検出

プロジェクト固有のコマンドをハードコードしないでください。動的に検出してください。

  • パッケージマネージャー：bun.lockb があれば bun、pnpm-lock.yaml があれば pnpm、yarn.lock があれば yarn、それ以外は npm
  • 検証コマンド：package.json のスクリプトに validate、check、または verify があるか確認します
  • テストコマンド：package.json に test スクリプトがあるか確認します
  • 規約：プロジェクト固有のルールについては CLAUDE.md を読みます

ルール

  1. 根拠に基づく：コードベースに関するすべての主張で file:line を参照してください
  2. 推測しない：確信が持てない場合は、まず調査してください
  3. 速やかに失敗させる：エラーは直ちに明らかにし、決して握りつぶさないでください
  4. CLAUDE.md を尊重する：プロジェクトの規約はクックブックの既定値に優先します
  5. AI による作成を記載しない：コミットや PR に「Generated with Claude」や「Co-Authored-By: Claude」を決して追加しないでください

コメント

Markdown 対応