ai-dev
Claude Code plugin for AI-driven development workflows. Language-agnostic harness engineering — autonomous issue resolution, Codex-assisted technical design, context-isolated investigation, multi-agent code review, and structured review gating.
Core philosophy: depth over breadth. Every feature proposal is filtered through project-defined Core Values and a one-step distance test. The system is designed to prevent feature bloat by enforcing "what NOT to build" as a first-class concept.
v3.0 highlights:
- Codex integration: Technical design verification via Codex MCP in
/dev, /dig, /decompose (optional, with fallback)
- Context isolation:
/dev-investigate runs in a forked context, keeping investigation token costs out of the main session
- Structured review gating:
/dev-all validates review.json artifacts before auto-merge (Critical → skip, Warning → user confirmation)
- Lifecycle hooks: SubagentStart/Stop, TaskCompleted, SessionEnd logging for observability
Install
As Plugin (for personal use)
# Register marketplace
/plugin marketplace add rioX432/ai-dev-templates
# Install
/plugin install ai-dev@ai-dev-templates
As Project Files (for team use)
# Initialize a new project with templates
/ai-dev:init-project /path/to/project
# Or sync updates to existing projects
/ai-dev:sync
Common skills/agents/rules are copied to .claude/skills/, .claude/agents/, .claude/rules/ so all team members can use them without installing the plugin.
Auto-Sync via GitHub Actions
When this repo is pushed, GitHub Actions automatically creates PRs to sync common files to configured projects. See .github/workflows/sync-to-projects.yml.
Skills
| Skill | Description |
|---|
/ai-dev:dev {issue} | E2E: investigate (forked) → Codex design → dig → decompose → implement → test → review → PR |
/ai-dev:dev-all [issues] | Autonomous issue processing: /dev per issue via /goal → review validation → conditional merge |
/ai-dev:dev-investigate | Context-isolated codebase investigation (runs with context: fork) |
/ai-dev:review | Multi-agent parallel code review (Bug/Security + Architecture/Quality) |
/ai-dev:pr | PR creation using project template with issue linking |
/ai-dev:dig | Structured ambiguity resolution with auto-decide rules + Codex design review |
/ai-dev:decompose | Task decomposition into ordered subtasks + Codex architecture validation |
/ai-dev:audit [scope] | Codebase health + visual bug audit with parallel scanners → GitHub Issues |
/ai-dev:competitive-audit [focus] | Core Value-filtered competitive analysis: user pain points → max 3 issues + Won't Do recording |
/ai-dev:ux-audit [target] | UI/UX comprehensive audit: heuristics, accessibility, visual, platform guidelines → GitHub Issues |
/ai-dev:tech-debt | Technical debt scan → GitHub Issues for high-severity findings |
/ai-dev:monitor | KPI monitoring: crash rates, reviews, metrics → priorities (PoC) |
/ai-dev:update-docs [scope] | Documentation audit & update (architecture, changelog, readme, oss) |
/ai-dev:sync | Sync common files to target projects |
/ai-dev:think <topic> [repo] | Zero-base deep research: structured investigation → synthesis → proposal with counter-arguments |
/ai-dev:init-project {path} | Initialize a project with templates (includes Core Values + Won't Do sections) |
Agents
| Agent | Model | Constraints | Role |
|---|
security-reviewer | sonnet | maxTurns: 20, read-only | OWASP vulnerability scanner |
test-writer | sonnet | maxTurns: 30 | Unit test generation |
ui-reviewer | sonnet | maxTurns: 20, read-only | UI/UX quality reviewer (accessibility, platform guidelines, design personality) |
perf-reviewer | sonnet | maxTurns: 20, read-only | Compose/CMP performance reviewer (recomposition, lazy layout, main thread, memory) |
repo-analyzer | sonnet | maxTurns: 30 | GitHub repo feature/Issue/PR analysis (for /think) |
deep-researcher | sonnet | maxTurns: 20 | Web/SNS supplemental research (collector only) |
case-analyzer | sonnet | maxTurns: 20 | Individual case deep dive analysis |
social-scanner | sonnet | maxTurns: 20 | X/Reddit/HN/community sentiment scan |
source-verifier | sonnet | maxTurns: 30 | URL existence + claim consistency check |
counter-argument | sonnet | maxTurns: 15 | Proposal stress-test: counter-arguments, risks |
Hooks
