How I Turned Claude Code Into My Entire Development Team
The 14KB tool that gives Claude Code a brain
How I Turned Claude Code Into My Entire Development Team
The Breaking Point
I've been using Claude Code for a while now, and I kept running into the same problem. I'd start a project with enthusiasm, but somewhere between "cool idea" and "working software," I'd get lost.
Not because Claude couldn't help—it absolutely could—but because I didn't have a consistent way to leverage its capabilities.
That's when I discovered the BMAD Method (Breakthrough Method of Agile AI-driven Development). It was brilliant but way too complex. Hundreds of files, state management, complex orchestration... it was fighting against Claude Code's natural abilities instead of embracing them.
So I built something better.
Enter claude-forge
npx claude-forge init
That's it. One command, and Claude Code becomes your entire development team.
The Problem with AI Coding
Here's what usually happens when coding with AI:
💭 You have an idea
🤖 You ask Claude to build something
🤔 Claude builds something, but is it the right thing?
🔄 You iterate endlessly without clear direction
😕 You end up with working code that doesn't solve the actual problem
Sound familiar?
The Solution: Structured Conversations
claude-forge gives Claude Code a methodology—a way of thinking about projects that mirrors how real development teams work. But here's the key insight: it doesn't require any special commands or complex state management.
Instead, it teaches Claude to naturally guide you through these phases:
1. 🎯 Ideation (Analyst)
"Let's forge a new project"
Claude becomes an analyst, asking probing questions:
What problem are you solving?
Who has this problem?
What would success look like?
2. 📋 Planning (Product Manager)
"Let's create a PRD"
Claude transforms into a PM, taking your ideas and structuring them into requirements, user stories, and success metrics. The stories live right in the PRD with checkboxes—no separate tracking needed.
3. 🏗️ Architecture (Architect)
"How should we build this?"
Claude switches to architect mode, designing the technical approach, choosing the stack, and making key decisions that will guide implementation.
4. 💻 Implementation (Developer)
"Let's build"
Claude becomes a developer, working through the story list one by one, checking them off as completed. No sprints, no ceremonies—just steady progress.
Why This Works
🗣️ Natural Language
You don't memorize commands. Just say what you want to do.
🧠 No State Files
Claude Code already remembers your conversation. Why duplicate that in JSON files?
📝 Markdown All The Way
Everything is readable, versionable, portable markdown.
⚡ Getting Real Philosophy
Inspired by 37signals—no BS, just build.
A Real Example
Here's an actual conversation after installing claude-forge:
Me: Let's forge a todo app
Claude: Great! I'll help you explore this idea as your Analyst.
Let me ask some questions to understand what you're trying to build...
What problem are you solving with this todo app?
What makes it different from existing solutions?
Me: I want a todo app that actually helps me focus on what matters,
not just collect tasks
Claude: Interesting! So it's about prioritization and focus,
not just task management. Who would use this?
What does their day look like?
[... conversation continues naturally ...]
Claude: Based on our discussion, I'll create a project brief.
Would you like me to move on to creating a PRD next?
See what happened? No commands, no configuration—just a natural conversation that produces real artifacts.
The Technical Details
claude-forge installs a simple structure in your project:
.claude/
├── methods/
│ └── forge.md # The methodology
├── personas/ # 6 development roles
│ ├── analyst.md
│ ├── pm.md
│ ├── architect.md
│ ├── ux.md
│ ├── po.md
│ └── dev.md
└── templates/ # Document templates
├── project-brief.md
├── prd.md
└── architecture.md
That's it. ~14KB total. Claude Code loads these files and understands how to guide your project.
The Philosophy
This isn't about replacing human developers. It's about having a consistent, thoughtful approach to building software with AI assistance.
✨ It's about starting with "why" before jumping to "how."
✨ It's about building the right thing, not just building something.
Try It Yourself
npx claude-forge init
Then just tell Claude: "Let's forge a new project"
What's Next?
I'm already working on v2 ideas:
🎯 Even simpler personas
📄 More templates
🔧 Better integration with Claude Code's latest features
👥 Community-contributed workflows
But honestly? v1 does exactly what I need. It turns chaos into clarity, ideas into implementation, Claude Code into a team.
🔗 Links
P.S. This entire tool was built using itself. I started with "Let's forge a tool to help Claude Code follow a methodology" and claude-forge guided me through its own creation. Meta? Yes. Effective? Absolutely.