Complete E2E Development Workflow

For Solo Dev Startups Using Claude Code Agents

Target User: Solo dev running a startup, only engineer, entire company. Goal: Pull this repo into any project and have a full agent team ready to go. Built by: Paul @ UndeadList — learned the hard way what works.

The Reality Check

You're a solo dev. You don't have:

A QA team
A code reviewer
A DevOps engineer
Time to waste on AI agents going rogue

This workflow package gives you all of that via Claude Code subagents, with strict protocols to prevent the bullshit that wastes your time.

What's In This Repo

claude-code-agents/
├── .claude/
│   └── agents/
│       ├── # AUDIT AGENTS (11 - run in parallel)
│       ├── code-auditor.md         # Code quality, DRY, complexity
│       ├── bug-auditor.md          # Security vulns, auth gaps
│       ├── security-auditor.md     # OWASP deep scan
│       ├── doc-auditor.md          # Documentation gaps
│       ├── infra-auditor.md        # Config, env vars, headers
│       ├── ui-auditor.md           # Accessibility, UX
│       ├── db-auditor.md           # Database, N+1, indexes
│       ├── perf-auditor.md         # Performance, bundle size
│       ├── dep-auditor.md          # Dependencies, vulnerabilities
│       ├── seo-auditor.md          # SEO, meta tags, OpenGraph
│       ├── api-tester.md           # API endpoint testing
│       │
│       ├── # FIX/IMPLEMENT AGENTS (4)
│       ├── fix-planner.md          # Prioritizes findings into FIXES.md
│       ├── code-fixer.md           # Implements fixes
│       ├── test-runner.md          # Validates fixes
│       ├── test-writer.md          # Auto-generates tests
│       │
│       ├── # BROWSER AGENTS (4 - Chrome integration)
│       ├── browser-qa-agent.md     # Navigates UI, finds console errors
│       ├── fullstack-qa-orchestrator.md  # Find → Fix → Verify loop
│       ├── console-monitor.md      # Real-time console watching
│       ├── visual-diff.md          # Screenshot comparison
│       │
│       ├── # DEPLOY AGENTS (2)
│       ├── deploy-checker.md       # Pre-deployment validation
│       ├── env-validator.md        # Environment configuration
│       │
│       ├── # UTILITY AGENTS (2)
│       ├── pr-writer.md            # PR description generator
│       ├── seed-generator.md       # Test data creation
│       │
│       └── # SUPERVISORS (1)
│       └── architect-reviewer.md   # Oversees until production-ready
│
├── workflows/                      # Predefined agent chains
│   ├── pre-commit.md               # Before committing
│   ├── pre-deploy.md               # Before deployment
│   ├── full-audit.md               # Complete audit suite
│   ├── new-feature.md              # Test-first development
│   ├── bug-fix.md                  # Bug fix with regression prevention
│   └── release-prep.md             # Release preparation
│
├── CLAUDE.md.template              # Project config (customize per project)
├── setup-project.sh                # One command setup for new projects
├── install.sh                      # Quick agent install
└── README.md

Total: 24 agents + 6 workflows

Quick Start

Installation

# Option A: Full setup (creates CLAUDE.md, detects stack)
curl -s https://undeadlist.com/agents/setup.sh | bash

# Option B: Just agents
curl -s https://undeadlist.com/agents/install.sh | bash

# Option C: Via npm
npx claude-code-agents

This creates:

.claude/agents/ with all 24 agent definitions
.claude/audits/ for generated reports (gitignored)
CLAUDE.md with your project config
workflows/ with predefined agent chains

Workflows

Pre-Commit

claude "Run pre-commit workflow"

Runs code-auditor + test-runner before committing.

Pre-Deploy

claude "Run pre-deploy workflow"

Validates build, env vars, dependencies before deployment.

Full Audit

claude "Run full-audit workflow on src/"

All 11 auditors in parallel → fix-planner creates FIXES.md.

New Feature

claude "Run new-feature workflow for: [feature description]"

test-writer → code-fixer → test-runner → browser-qa (TDD approach).

Bug Fix

claude "Run bug-fix workflow for: [bug description]"

Write failing test → fix → verify (regression prevention).

Release Prep

claude "Run release-prep workflow for v1.0.0"

Full audit → fixes → deploy validation → PR generation.

Project Lifecycle

Phase 0: New Project Setup

curl -s https://undeadlist.com/agents/setup.sh | bash

Phase 1: Skeleton/Scaffolding

Before touching code, create your blueprint:

claude "Create a SETUP_BLUEPRINT.md for this project:
- Folder structure
- Tech stack decisions (with rationale)
- Dependencies list (don't install yet)
- Environment variables needed
- Database planning
- Success criteria checklist

Do NOT generate any code. Just the plan."

Phase 2: Initial Build

Strict rules for AI agents during build:

## RULES FOR THIS SESSION

1. **ASK BEFORE** modifying any file not directly related to current task
2. **NEVER** refactor "while you're in there"
3. **NEVER** update dependencies unless explicitly requested
4. **NEVER** change config files without approval
5. **ONE logical change per commit**
6. **VERIFY** the build works after each change

Phase 3: Development Loop

The core loop for any task:

┌─────────────────────────────────────────────────┐
│  1. Understand the task                         │
│  2. State what files you'll touch               │
│  3. Get approval                                │
│  4. Make ONE change                             │
│  5. Verify it works                             │
│  6. Commit                                      │
│  7. Repeat                                      │
└─────────────────────────────────────────────────┘

Phase 4: Pre-Launch Audit

Run the full parallel audit:

claude "Run full-audit workflow on src/"

Review .claude/audits/ for:

AUDIT_CODE.md, AUDIT_SECURITY.md, AUDIT_DB.md, AUDIT_PERF.md
FIXES.md (prioritized action items)

Phase 5: Browser QA

Enable Chrome integration:

/chrome

Run the full QA loop:

claude "Use fullstack-qa-orchestrator to:
1. Start dev server (npm run dev)
2. Navigate to http://localhost:3000
3. Test: homepage, auth flow, main features
4. Find console errors, UI bugs
5. Fix issues found
6. Re-test to verify
7. Repeat until clean"

Phase 6: Deploy

claude "Run pre-deploy workflow"

The Protocols

Protocol 1: No Unauthorized Changes

Every AI agent must follow:

## BEFORE ANY CHANGE

1. State what file you're modifying
2. State what change you're making
3. State why
4. Wait for "PROCEED" or "STOP"

## FORBIDDEN ACTIONS

- ❌ npm install / npx anything without approval
- ❌ Modifying package.json without approval
- ❌ Creating new files when editing existing works
- ❌ Refactoring unrelated code
- ❌ "Improvements" not requested
- ❌ Touching config files without approval

Protocol 2: Micro-Checkpoint Method

For complex changes:

## EVERY PHASE:

1. Agent states planned change
2. Agent calls architect-reviewer for verification
3. User says "PROCEED" or "STOP"
4. Agent makes ONE change
5. Agent verifies change applied correctly
6. Proceed to next phase only with approval

Protocol 3: Regression Prevention

Before any change:

# Baseline testing
curl -s http://localhost:3000/api/health  # API works
pnpm tsc --noEmit                          # TypeScript valid
pnpm test                                   # Tests pass

# After change - all must still work

Common Commands

Daily Development

# Start coding session
claude "Review CLAUDE.md, then help me with [task]"

# Quick check before commit
claude "Run pre-commit workflow"

# Verify a specific file
claude "Review [file] for bugs, especially [concern area]"

Pre-Launch

# Full audit
claude "Run full-audit workflow on src/"

# Browser QA
claude "Use fullstack-qa-orchestrator to test http://localhost:3000"

# Security focus
claude "Use security-auditor to deep scan src/api/"

Debugging

# Console monitoring
claude "Use console-monitor to watch http://localhost:3000"

# Specific bug
claude "Run bug-fix workflow for: [bug description]"

Files Generated

All reports go to .claude/audits/ (gitignored):

File	Source Agent
AUDIT_CODE.md	code-auditor
AUDIT_SECURITY.md	bug-auditor
AUDIT_SECURITY_DEEP.md	security-auditor
AUDIT_DOCS.md	doc-auditor
AUDIT_INFRA.md	infra-auditor
AUDIT_UI_UX.md	ui-auditor
AUDIT_DB.md	db-auditor
AUDIT_PERF.md	perf-auditor
AUDIT_DEPS.md	dep-auditor
AUDIT_SEO.md	seo-auditor
API_TEST_REPORT.md	api-tester
DEPLOY_CHECK.md	deploy-checker
ENV_REPORT.md	env-validator
FIXES.md	fix-planner
TEST_REPORT.md	test-runner
AUDIT_BROWSER_QA.md	browser-qa-agent
QA_SESSION_LOG.md	fullstack-qa-orchestrator

Quick Reference

Task	Command
New project setup	`curl -s https://undeadlist.com/agents/setup.sh \| bash`
Enable browser QA	`/chrome` in Claude Code
Pre-commit check	`"Run pre-commit workflow"`
Full audit	`"Run full-audit workflow on src/"`
Pre-deploy check	`"Run pre-deploy workflow"`
Browser test	`"Use browser-qa-agent to test localhost:3000"`
Full QA loop	`"Use fullstack-qa-orchestrator..."`
New feature	`"Run new-feature workflow for: [feature]"`
Bug fix	`"Run bug-fix workflow for: [bug]"`
Release prep	`"Run release-prep workflow for v1.0.0"`
Verify production-ready	`"Use architect-reviewer..."`

When AI Goes Rogue

Red Flags - STOP Immediately

Agent makes changes without asking
Agent installs packages without approval
Agent modifies config files unexpectedly
Agent claims success without verification
Agent skips checkpoints
Agent touches files outside scope

Recovery Commands

# Revert last change
git checkout -- [file]

# Revert all changes
git reset --hard HEAD

# Check what changed
git diff

Enforcement Phrases

"STOP. You didn't ask permission."
"STOP. That's not in scope."
"STOP. Verify it works before claiming done."
"STOP. One change at a time."

Uninstall

To remove the agents from your project:

# Remove agent definitions
rm -rf .claude/agents/

# Remove generated audit reports
rm -rf .claude/audits/

# Remove workflows
rm -rf workflows/

# Optionally remove CLAUDE.md if you created one
rm CLAUDE.md

Contributing

Found a better protocol? Agent that should exist?

PR it: https://github.com/undeadlist/claude-code-agents

License

MIT. Use it, fork it, enhance it.

Built by UndeadList The indie software flea market

Disclaimer: Claude Code is a product of Anthropic PBC. This project is not affiliated with or endorsed by Anthropic.

"Built, but undiscovered."

Name		Name	Last commit message	Last commit date
Latest commit History 17 Commits
.claude		.claude
.github		.github
assets		assets
badges		badges
bin		bin
workflows		workflows
.gitignore		.gitignore
CLAUDE.md		CLAUDE.md
CLAUDE.md.template		CLAUDE.md.template
CONTRIBUTING.md		CONTRIBUTING.md
LICENSE		LICENSE
README.md		README.md
install.sh		install.sh
package.json		package.json
setup-project.sh		setup-project.sh

License

undeadlist/claude-code-agents

Folders and files

Latest commit

History

Repository files navigation

Complete E2E Development Workflow

For Solo Dev Startups Using Claude Code Agents

The Reality Check

What's In This Repo

Quick Start

Installation

Workflows

Pre-Commit

Pre-Deploy

Full Audit

New Feature

Bug Fix

Release Prep

Project Lifecycle

Phase 0: New Project Setup

Phase 1: Skeleton/Scaffolding

Phase 2: Initial Build

Phase 3: Development Loop

Phase 4: Pre-Launch Audit

Phase 5: Browser QA

Phase 6: Deploy

The Protocols

Protocol 1: No Unauthorized Changes

Protocol 2: Micro-Checkpoint Method

Protocol 3: Regression Prevention

Common Commands

Daily Development

Pre-Launch

Debugging

Files Generated

Quick Reference

When AI Goes Rogue

Red Flags - STOP Immediately

Recovery Commands

Enforcement Phrases

Uninstall

Contributing

License

About

Resources

License

Contributing

Uh oh!

Stars

Watchers

Forks

Releases

Packages 0

Contributors 3

Uh oh!

Languages

Packages