Transform any project into an autonomous product builder with specialized agents that work 24/7 to build, test, and validate your code.

What is agentful?

agentful is an opinionated starter template for Claude Code that transforms it into a powerful autonomous development system. It's a pre-configured .claude/ directory that supercharges Claude Code with:

• 7 Specialized Agents - Orchestrator, Architect, Backend, Frontend, Tester, Reviewer, Fixer
• 4 Powerful Commands - Start, Status, Decide, Validate
• Dynamic Tech Stack Detection - Automatically generates agents for your specific stack
• Quality Gates - Type checking, Linting, Tests, Coverage, Security, Dead code detection (adapts to YOUR stack)
• 24/7 Development - Works while you sleep with Ralph Wiggum loops
• Progress Tracking - See exactly what's done and what's next
• Decision Handling - agentful asks, you answer, it continues

How It Works

Quick Start (30 seconds)

1. Initialize in your project

npx @itz4blitz/agentful init

2. Edit your product spec

Open PRODUCT.md and describe what you want to build:

## Overview
A task management app for remote teams.
 
## Tech Stack
- Next.js 14 + TypeScript
- Prisma + PostgreSQL
- Tailwind CSS
- Vitest + Playwright
 
## Features
1. Authentication (CRITICAL)
2. Project management (HIGH)
3. Task assignment (MEDIUM)

3. Start autonomous development

claude

Then type:

/agentful-start

That's it! agentful will:

1. Analyze your PRODUCT.md
2. Detect your tech stack
3. Generate specialized agents
4. Start building autonomously

Key Features

🤖 Specialized Agents

agentful includes specialized agents that work together:

🎯 Simple Commands

🌙 24/7 Development

For fully autonomous overnight development, use the Ralph Wiggum plugin inside Claude Code:

# First, start Claude Code
claude
 
# Then inside Claude Code, install the plugin
/plugin install ralph-wiggum@anthropics
 
# Run autonomous development loop
/ralph-loop "/agentful-start" --max-iterations 50 --completion-promise "AGENTFUL_COMPLETE"

agentful will work while you sleep, only stopping when:

• All features are complete (100%)
• All quality gates pass
• Or max iterations reached

See the 24/7 Development guide for detailed setup and usage.

📊 Quality Gates

Code must pass ALL gates before completion:

• ✅ All tests passing
• ✅ No type errors (type checking adapts to your stack)
• ✅ No lint errors
• ✅ No dead code (unused exports, files, dependencies)
• ✅ Test coverage ≥ 80%
• ✅ No security issues

📈 Progress Tracking

See exactly what's done and what's next:

/agentful-status

Output:

🔧 Working on: User authentication feature
   Phase: implementation
   Iterations: 12
 
Progress:
   ████████░░░░░░░░░░░ 40%
 
Quality Gates:
   ✅ Tests Passing
   ❌ No Type Errors (3 errors found)
   ✅ Coverage 80%
   ⚠️  2 pending decisions:
      1. Which auth library to use?
      2. Session duration?

Example Flow

# You
npx @itz4blitz/agentful init
 
# Edit PRODUCT.md with your requirements
 
# You
claude
 
# You
/agentful-start
 
# agentful
Detected Next.js + TypeScript + Prisma + Tailwind
→ Generated nextjs-agent, prisma-agent, tailwind-agent
 
# agentful
Starting work on authentication (priority: CRITICAL)
→ @backend implementing JWT service
→ @backend implementing login API route
→ @frontend creating login page
→ @tester writing auth tests
 
# agentful
Running validation...
→ TypeScript: ✅
→ Lint: ✅
→ Tests: ✅
→ Coverage: 82% ✅
→ Dead code: ✅
→ Security: ✅
 
# agentful
Authentication complete (100%)
Next: User profile feature...
 
[Continues 24/7 until complete]

What Gets Created

After initialization, your project will have:

your-project/
├── PRODUCT.md              # ← Edit this: your product spec
├── CLAUDE.md               # Project instructions for Claude
├── .claude/                # agentful configuration (version control)
│   ├── agents/             # Specialized agents
│   │   ├── orchestrator.md
│   │   ├── architect.md
│   │   ├── backend.md
│   │   ├── frontend.md
│   │   ├── tester.md
│   │   ├── reviewer.md
│   │   └── fixer.md
│   ├── commands/           # Slash commands
│   │   ├── agentful-start.md
│   │   ├── agentful-status.md
│   │   ├── agentful-decide.md
│   │   └── agentful-validate.md
│   ├── skills/             # Domain skills
│   │   ├── product-tracking/
│   │   └── validation/
│   └── settings.json       # Hooks and permissions
├── .agentful/              # Runtime state (gitignored)
│   ├── state.json          # Current work state
│   ├── completion.json     # Progress tracking
│   ├── decisions.json      # Pending/resolved decisions
│   └── architecture.json   # Detected tech stack
└── src/                    # Your code (generated by agentful)

Requirements

• Claude Code - Install here
• Node.js 18+ - For CLI tool

Optional: 24/7 Autonomous Development

For fully autonomous overnight development, install the Ralph Wiggum plugin inside Claude Code:

# 1. Start Claude Code in your project
claude
 
# 2. Inside Claude Code, install the plugin
/plugin install ralph-wiggum@anthropics
 
# 3. Then run autonomous loops
/ralph-loop "/agentful-start" --max-iterations 50 --completion-promise "AGENTFUL_COMPLETE"

See 24/7 Development for details.

What's Next?

Getting Started

• Installation - Set up agentful
• Quick Start - 5-minute walkthrough
• First Project - Build your first project
• Configuration - Basic configuration

Core Concepts

• Agents - Specialized agents
• Slash Commands - Available commands
• Quality Gates - Quality checks
• State Management - Track progress

Why agentful?

For Solo Developers

• Build complete products without burnout
• Work on high-level features while agentful handles implementation
• Ship faster with autonomous testing and validation

For Teams

• Accelerate feature development with AI-powered agents
• Maintain code quality with automated reviews
• Focus on architecture while agents handle implementation

For Prototypes

• Go from idea to working prototype in hours, not days
• Validate concepts quickly with autonomous development
• Iterate fast with 24/7 development cycles

Links

• GitHub: github.com/itz4blitz/agentful
• Issues: github.com/itz4blitz/agentful/issues
• Website: agentful.app
• Discord: Join Community