Agent Skills › coleam00/Archon › archon-dev

archon-dev

GitHub

Archon项目的核心开发工作流技能，通过路由至10个专用手册覆盖研究、调查、PRD编写、规划、实现、审查、调试、提交及发布等全生命周期任务。

.claude/skills/archon-dev/SKILL.md coleam00/Archon

Trigger Scenarios

代码库研究与探索技术选型与可行性评估产品需求文档编写实施计划制定功能代码实现代码或PR审查故障排查与根因分析代码提交与PR创建

Install

npx skills add coleam00/Archon --skill archon-dev -g -y

More Options

Non-standard path

npx skills add https://github.com/coleam00/Archon/tree/dev/.claude/skills/archon-dev -g -y

Use without installing

npx skills use coleam00/Archon@archon-dev

指定 Agent (Claude Code)

npx skills add coleam00/Archon --skill archon-dev -a claude-code -g -y

安装 repo 全部 skill

npx skills add coleam00/Archon --all -g -y

预览 repo 内 skill

npx skills add coleam00/Archon --list

SKILL.md

Frontmatter

{
    "name": "archon-dev",
    "description": "The PRIMARY development workflow for the Archon project (remote-coding-agent).\nUse this skill instead of any PRP skills when working on Archon code.\nRoutes to 10 specialized cookbooks based on what the user is trying to do:\n\nRESEARCH    — \"how does the orchestrator work?\", \"where is session state defined?\",\n              \"trace the workflow execution flow\", \"what is IWorkflowStore?\"\nINVESTIGATE — \"should we use Drizzle or Prisma?\", \"what's the best way to add WebSockets?\",\n              \"can we migrate to Turso?\", \"how do other projects handle rate limiting?\"\nPRD         — \"write a PRD for dark mode\", \"spec out the notification feature\",\n              \"product requirements for webhook retry\"\nPLAN        — \"plan the auth refactor\", \"design the caching layer\",\n              \"create an implementation plan for #42\"\nIMPLEMENT   — \"implement the plan\", \"execute .claude\/archon\/plans\/auth.plan.md\",\n              \"build the feature from the plan\", \"code this up\"\nREVIEW      — \"review PR #123\", \"review my changes\", \"code review the diff\"\nDEBUG       — \"debug the failing test\", \"why is streaming broken?\",\n              \"root cause analysis on the timeout issue\"\nCOMMIT      — \"commit these changes\", \"commit the auth refactor\"\nPR          — \"create a PR\", \"open a pull request for this branch\"\nISSUE       — \"report this to gh\", \"create a gh issue\", \"log it in github\",\n              \"file a bug for this\", \"create a feature request\"\n\nThis skill triggers on ANY development task: researching, investigating,\nplanning, building, reviewing, debugging, committing, or shipping code.\nNOT for: Running Archon CLI workflows in worktrees (use \/archon instead).\n",
    "argument-hint": "[cookbook] [task description or issue number]"
}

archon-dev

Development workflow — research, plan, build, review, ship.

Current State

Branch: !git branch --show-current 2>/dev/null || echo "not in git repo"
Artifacts: !ls .claude/archon/ 2>/dev/null || echo "none yet"
Active plans: !ls .claude/archon/plans/*.plan.md 2>/dev/null | head -5 || echo "none"

Routing

Read $ARGUMENTS and determine which cookbook to load.

If the user explicitly names a cookbook (e.g., "plan", "implement"), use that. Otherwise, match intent from keywords:

Intent	Keywords	Cookbook
Codebase questions, document what exists	"research", "how does", "what is", "where is", "trace", "find"	cookbooks/research.md
Strategic research, library eval, feasibility	"investigate", "should we", "can we", "compare", "evaluate", "feasibility", "best way to", "best approach"	cookbooks/investigate.md
Write product requirements	"prd", "requirements", "spec", "product requirement"	cookbooks/prd.md
Create implementation plan	"plan", "design", "architect", "write a plan"	cookbooks/plan.md
Execute an existing plan	"implement", "execute", "build", "code this", path to `.plan.md`	cookbooks/implement.md
Review code or PR	"review", "review PR", "code review", "review changes"	cookbooks/review.md
Debug or root cause analysis	"debug", "rca", "root cause", "why is", "broken", "failing"	cookbooks/debug.md
Commit changes	"commit", "save changes", "stage"	cookbooks/commit.md
Create pull request	"pr", "pull request", "create pr", "open pr"	cookbooks/pr.md
Report to GitHub	"issue", "report to gh", "log in github", "file a bug", "feature request", "create issue", "gh issue"	cookbooks/issue.md

If ambiguous: Ask the user which cookbook to use.

After routing: Read the matched cookbook file and follow its instructions exactly.

Workflow Chains

Cookbooks feed into each other. After completing one, suggest the next:

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

Artifact Directory

All artifacts go to .claude/archon/. Create subdirectories as needed on first use.

.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

Project Detection

Do NOT hardcode project-specific commands. Detect dynamically:

Package manager: Check for bun.lockb → bun, pnpm-lock.yaml → pnpm, yarn.lock → yarn, else npm
Validation command: Check package.json scripts for validate, check, or verify
Test command: Check for test script in package.json
Conventions: Read CLAUDE.md for project-specific rules

Rules

Evidence-based: Every claim about the codebase must reference file:line
No speculation: If uncertain, investigate first
Fail fast: Surface errors immediately, never swallow them
Respect CLAUDE.md: Project conventions override cookbook defaults
No AI attribution: Never add "Generated with Claude" or "Co-Authored-By: Claude" to commits or PRs