wania-kazmi-claude-code-autonomous-agent-workflow

Autonomous Agent Boilerplate for Claude Code

Build entire projects from a single requirements file. This boilerplate doesn't just provide pre-configured agents — it autonomously generates the skills, agents, hooks, and code your project needs using the Spec-Kit-Plus workflow.

📦 What's Included Out of the Box:

• ✅ Spec-Kit-Plus Pre-Installed - Complete .claude/ and .specify/ framework ready to use
• ✅ 69 Production-Ready Components - 15 skills, 13 agents, 29 commands, 9 rules, 7 scripts, 6 templates
• ✅ Clean Slate - No session data, logs, or artifacts - fresh start for every user
• ✅ Multi-User Collaboration - Intelligent TODO merging, contributor tracking, session recovery
• ✅ Session Isolation - .gitignore configured to exclude all session-specific files
• ✅ Quality Gates - Component utilization enforcement, workflow validation, A-F grading
• ✅ Complete Documentation - 2,343 lines of comprehensive guides

---

🚀 The Core Idea

┌─────────────────────────────────────────────────────────────────────────────┐
│                                                                             │
│   YOU WRITE:                        BOILERPLATE GENERATES:                  │
│   ───────────                       ──────────────────────                  │
│                                                                             │
│   requirements/my-app.md    →→→     ✓ Skills for YOUR tech stack           │
│                                     ✓ Agents for YOUR project needs        │
│                                     ✓ Hooks for YOUR workflow              │
│                                     ✓ Complete project with tests          │
│                                     ✓ 80%+ code coverage                   │
│                                     ✓ Security-reviewed code               │
│                                                                             │
└─────────────────────────────────────────────────────────────────────────────┘

One command. Full project. No manual setup.

claude "/sp.autonomous requirements/my-app.md"

---

📋 Table of Contents

• How It Works
• Quick Start
• The Spec-Kit-Plus Workflow
  • Phase Details
  • What Gets Generated
  • Architecture: Autonomous Enforcement
  • Workflow Status Commands
• Writing Requirements
• Pre-Loaded Components
• Manual Mode (Optional)
• Understanding the Structure
• Customization
• Troubleshooting
• FAQ

---

🎯 How It Works

Step 1: You Write Requirements

Create a simple markdown file describing what you want to build:

# My E-Commerce API

## Features
- User authentication (JWT)
- Product catalog with search
- Shopping cart
- Order processing

## Technical
- Backend: Node.js + Express
- Database: PostgreSQL + Prisma
- Testing: Jest

Step 2: Run One Command

claude "/sp.autonomous requirements/my-app.md"

Note: Spec-Kit-Plus is pre-installed in this boilerplate. The .claude/ and .specify/ directories contain all necessary templates, scripts, and configurations. No initialization required!

Step 3: Boilerplate Takes Over

The autonomous workflow:

1. Verifies Spec-Kit-Plus installation (pre-installed in this boilerplate)
2. Creates feature branch automatically (if on main/master)
3. Analyzes your requirements file
4. Detects technologies (Node.js, Express, PostgreSQL, Prisma, Jest)
5. Generates custom skills for your stack (if needed)
6. Generates specialized agents for your project (if needed)
7. Generates quality hooks for your workflow (if needed)
8. Creates specification, plan, and task breakdown
9. Implements each feature using TDD
10. Reviews code for security and quality
11. Delivers complete project with tests

Result: A production-ready project with 80%+ test coverage, security-reviewed code, proper documentation, and all work done on a feature branch ready for PR.

Automatic Branch Creation

When you start a new autonomous build: