Next.js Autonomous Development Template

A self-improving Next.js template with autonomous AI workflows powered by Claude Code.

Quick Start

# Copy this template to start a new project
cp -r ~/starters/nextjs-autonomous my-new-project
cd my-new-project

# Install dependencies
npm install

# Set up environment
cp .env.example .env
# Edit .env with your values

# Set up database
npm run db:setup

# Start development
npm run dev

Autonomous Workflows

This template includes powerful AI-driven workflows that handle development tasks autonomously.

/specify - Semi-Autonomous Feature Development

Creates spec, plan, and tasks, then awaits your approval before autonomous implementation.

/specify "Add email verification with OTP codes"

Best for: First time using a workflow, complex features, learning

/specify-auto - Fully Autonomous with Checkpoints

Runs autonomously with periodic checkpoints for oversight.

/specify-auto "Add dark mode support" --budget 15

Best for: Familiar workflows, well-defined specs, speed

/bugfix - Systematic Bug Resolution

Analyzes bug, implements fix, and updates memory to prevent recurrence.

/bugfix "Login fails with database error"

/security - Automated Security Audit

Scans for vulnerabilities and optionally fixes them autonomously.

/security --auto-fix

Self-Improving Memory

Every workflow updates .claude/memory/ with learnings:

• MEMORY.md: Core patterns (auto-loaded every session)
• common-bugs.md: Bug catalog with solutions
• security-patterns.md: Security best practices
• performance-patterns.md: Optimization techniques
• anti-patterns.md: Mistakes to avoid

Your project gets smarter over time.

File Organization

.claude/
├── skills/          # Workflow commands
├── agents/          # Specialized AI agents
├── memory/          # Self-improving knowledge base
└── config/          # Safety limits and settings

.specify/            # Feature specs and design docs
.vscode/             # VS Code settings (file nesting!)
scripts/             # Utility scripts
docs/                # Project documentation
src/                 # Source code

Safety Features

• Hard limits: Max cost, time, iterations
• Checkpoints: User approval at key stages
• Rollback: Everything in feature branches
• Circuit breakers: Auto-stop on repeated failures

Next Steps

1. Read docs/WORKFLOW.md for detailed workflow explanations
2. Customize .claude/config/loop-limits.json for your budget
3. Run your first workflow: /specify "your feature idea"
4. Watch your memory grow as you build

Links

• Workflow Guide
• Agent System
• Claude Code Docs