agentic-tools
Claude Code plugin that implements a full autonomous code factory. Give it an idea — it produces a running application.
The Pipeline
/idea → /setup → /build → /test → /deploy → /ship
/status (anytime)
/teardown
| Skill | Purpose |
|---|
/idea | Raw idea → structured PRD with acceptance criteria and service manifest |
/setup | Detect required services, check vaults, generate .env, guide account creation |
/build | 7-phase implementation: plan → architect review → exec review → workers → critic → merge |
/test | Generate test suites for existing code without modifying implementation |
/deploy | Deploy to staging/production, run migrations, health check, rollback on failure |
/ship | Go-to-market engine: strategy doc, landing page, free tool, SEO, AEO infrastructure |
/status | Factory dashboard: active builds, scores, blockers, environment health |
/teardown | Clean up worktrees, delete merged branches, archive plans |
How It Works
/idea — Intake
Takes a raw concept and produces a Product Requirements Document with measurable acceptance criteria, technical requirements, and a service manifest listing every external dependency.
/setup — Environment
Reads the PRD (or scans the codebase), detects what services are needed, checks your credential vault (1Password CLI, AWS SSM, or .env files), and generates a complete environment configuration. For missing services, it produces a checklist with direct signup links.
/build — Implementation
The core engine. Runs a 7-phase pipeline with scored quality gates:
- Roadmap — Explore codebase, produce implementation plan
- Architect Review — Technical review, >= 9.5/10 to proceed
- Executive Review — Product/UX review, >= 9.5/10 to proceed
- Task Decomposition — Break plan into non-colliding worktree-safe tasks
- Ralph Swarm — Parallel worker agents on isolated git worktrees
- Critic Review — Code review per worker, >= 9.5/10 to commit
- Merge & Cleanup — Merge approved branches, clean worktrees
/test — Coverage
Analyzes existing code for coverage gaps, prioritizes by risk (auth, payments, data mutations first), and generates comprehensive test suites following existing patterns. Does not modify implementation.
/deploy — Ship
Pre-flight validation, database migrations, deployment to Vercel/hosting platform, post-deployment health checks, and automatic rollback if health checks fail. Production deploys require human confirmation.
/status — Dashboard
Read-only snapshot of the factory: active worktrees, review scores, blockers, environment health, backlog status. No subagents dispatched — reads local state directly.
/ship — Go-to-Market
Takes any app (codebase, URL, or description) and produces a tailored marketing strategy + working deliverables. Runs a 5-phase pipeline:
- Discover — Explore the product, understand positioning and differentiators
- Expert Reviews — Parallel UX architect + business executive subagent critiques
- Strategy — Prioritized GTM document covering 8 distribution strategies with 90-day action plan
- Build Deliverables — Landing page, free lead-gen tool, SEO guide pages, AEO infrastructure (parallel worktrees)
- Review & Deliver — Critic review, fix critical issues, create PRs
Adapts to product maturity: early-stage gets positioning + strategy, growth-stage gets concrete deliverables and scaling tactics.
/teardown — Cleanup
Removes merged worktrees and branches, archives completed plan files, prunes orphaned references. Never deletes unmerged work without human confirmation.
Installation
Add to your ~/.claude/settings.json:
{
"enabledPlugins": {
"agentic-tools@C:\\path\\to\\agentic-tools": true
}
}
Or clone and reference:
git clone https://github.com/KurtLehnardt/agentic-tools.git
Quick Start
# Start with an idea
/idea I want a SaaS that converts podcast episodes into blog posts
# Set up the environment
/setup
# Build it
/build
# Add test coverage
/test
# Ship it
/deploy
# Go to market
/ship
# Check on things
/status
# Clean up after merge
/teardown
Customization
Review Thresholds
Default pass threshold is 9.5/10. Edit scoring rules in:
skills/build/references/architect-review-prompt.mdskills/build/references/executive-review-prompt.mdskills/build/references/critic-review-prompt.md
Worker Behavior
Modify skills/build/references/ralph-worker-prompt.md for commit conventions, validation commands, scope rules.
Test Patterns
Modify skills/test/references/test-writer-prompt.md for test framework preferences, coverage targets.
Structure
