Skip to content

v1.0.0 - Initial Release: Production-Grade AI Development Framework

Latest
Latest

Choose a tag to compare

View all tags
@LuisLadino LuisLadino released this 15 Oct 00:20
· 34 commits to main since this release
v1.0.0
3fa6982 
# 🚀 Claude Development Framework v1.0.0

The first stable release of the Claude Development Framework—a production-grade system that transforms Claude into your team's AI development partner with perfect memory of your standards, patterns, and architectural decisions.

## 🎯 What's Included

### Core Framework
- **11 Powerful Commands** - `/start-task`, `/verify`, `/create-prd`, `/generate-tasks`, `/process-tasks`, `/research-stack`, `/import-standards`, `/add-standard`, `/standards`, `/learn`, `/update-framework`
- **Stack-Agnostic Design** - Works with ANY framework: React, Vue, Python, Rust, Go, Django, Rails, and more
- **Multi-Step Workflows** - Guided processes for complex tasks
- **MCP Integration** - Connect external documentation sources

### Installation System
- **One-Line Install** - `curl -fsSL https://raw.githubusercontent.com/LuisLadino/claude-dev-framework/main/scripts/install.sh | bash`
- **Clean Architecture** - No bloat, only essential framework files
- **Smart Merge** - Preserves existing `.claude/` directories
- **Easy Uninstall** - With backup options

### Key Features

#### 🧠 Architectural Memory
```yaml
# Claude remembers your decisions forever
architecture_patterns:
  - "Event-driven microservices with CQRS"
  - "Hexagonal architecture for domain isolation"
  - "No circular dependencies (enforced)"

🔍 Intelligent Stack Research

/research-stack

Claude researches YOUR stack online:


- Official documentation


- Current best practices (2024-2025)


- Framework-specific patterns


- Version-specific features

📋 Interactive PRD Generation

/create-prd


12-question workflow creates comprehensive PRDs


Adapts to your tech stack automatically


Saves to .claude/tasks/ (no project root clutter)

📊 Codebase Analysis

/import-standards analyze codebase


Discovers actual patterns in your code


Suggests edits to existing standards


Creates new standards files automatically

📦 Installation

New Project

cd your-project

curl -fsSL https://raw.githubusercontent.com/LuisLadino/claude-dev-framework/main/scripts/install.sh | bash

/research-stack  # Generate standards for your stack

Existing Claude Code Setup

# Installer automatically detects and merges

curl -fsSL https://raw.githubusercontent.com/LuisLadino/claude-dev-framework/main/scripts/install.sh | bash


Choose option 2: Merge with existing

🎓 Documentation

💡 Who Is This For?

Senior/Staff Engineers

  • Problem: Context loss between Claude sessions, tribal knowledge not captured, team scaling challenges
  • Solution: Codify your expertise once, scale it to everyone
  • ROI: 10-20 hours/week saved per developer

Engineering Leaders

  • Problem: Junior devs shipping code that doesn't meet standards, code review bottleneck, inconsistent patterns
  • Solution: Framework enforces your standards automatically
  • Result: Linear team velocity (not logarithmic)

Solo Developers

  • Problem: Repeating yourself to Claude, inconsistent outputs, forgetting architectural decisions
  • Solution: Standards that persist across sessions
  • Benefit: Consistent, production-grade code

🌟 What Makes This Special

Stack-Agnostic

# Works with ANY stack via /research-stack

✅ Frontend: React, Vue, Svelte, Angular, Solid

✅ Backend: FastAPI, Django, Express, Rails, Laravel

✅ Systems: Rust, Go, C++, Zig

✅ Mobile: React Native, Flutter, Swift, Kotlin

✅ And literally any other framework

No Lock-In

# Your standards are just markdown files

.claude/your-stack/

├── coding-standards/

│   ├── python-standards.md    # Plain markdown

│   └── fastapi-patterns.md    # Easy to read/edit

└── architecture/

└── decisions.md            # Version control friendly


Keep them, migrate them, or delete them anytime

Production-Ready

  • Security standards enforced by default
  • Observability built into generated code
  • Testing strategies included
  • Accessibility patterns included
  • Performance considerations documented

📊 Framework vs. Raw Claude

Aspect Raw Claude With Framework
Context Persistence Lost every session Permanent memory
Standards Enforcement Manual reminders Automatic
Team Consistency Varies by person Identical output
Architectural Decisions Forgotten Always followed
Onboarding Time Weeks Hours
Code Review Time Hours Minutes
Setup Time N/A 2 minutes

🔧 Technical Details

What Gets Installed

.claude/
├── CLAUDE.md              # Main framework instructions
├── commands/              # 11 slash commands
├── workflows/             # Multi-step processes
├── tools/                 # MCP and tool configs
├── config/                # Environment settings
├── your-stack/            # Your custom standards (empty)
└── tasks/                 # Generated PRDs/tasks

What Stays on GitHub Only

❌ templates/              # You generate actual standards
❌ docs/                   # Full documentation
❌ CHANGELOG.md            # Project history
❌ examples/               # Example configs

Total Install Size: ~20 essential files (not 100+ with bloat)

🚦 Getting Started (5 Minutes)

  1. Install Framework

    curl -fsSL https://raw.githubusercontent.com/LuisLadino/claude-dev-framework/main/scripts/install.sh | bash

  2. Generate Standards

    /research-stack
# Tell Claude your stack: "Next.js 15 with TypeScript and Tailwind"

  3. Start Coding

    /start-task "Add user authentication"
# Claude follows your standards automatically

🐛 Known Issues

None reported yet! This is the initial stable release.

🤝 Contributing

We welcome contributions! See CONTRIBUTING.md for:

  • Bug reports
  • Feature requests
  • Documentation improvements
  • New stack templates

📄 License

MIT License - Use it however you want, commercially or personally.

🙏 Acknowledgments

Built with Claude Code by Anthropic.

 

Special thanks to the developer community for feedback and inspiration.

📈 What's Next?

Roadmap for future releases:

  •  VSCode extension for easier command access
  •  Web dashboard for standards visualization
  •  Team collaboration features
  •  Pre-built standards packs (security, accessibility, performance)
  •  GitHub Actions integration
  •  IDE integrations (JetBrains, Cursor, etc.)

Ready to scale your development with AI?

curl -fsSL https://raw.githubusercontent.com/LuisLadino/claude-dev-framework/main/scripts/install.sh | bash

⭐ Star this repo if you find it useful!
🐛 Report issues on GitHub Issues
💬 Join discussions on GitHub Discussions

# 🚀 Claude Development Framework v1.0.0

The first stable release of the Claude Development Framework—a production-grade system that transforms Claude into your team's AI development partner with perfect memory of your standards, patterns, and architectural decisions.

🎯 What's Included

Core Framework

  • 11 Powerful Commands - /start-task, /verify, /create-prd, /generate-tasks, /process-tasks, /research-stack, /import-standards, /add-standard, /standards, /learn, /update-framework
  • Stack-Agnostic Design - Works with ANY framework: React, Vue, Python, Rust, Go, Django, Rails, and more
  • Multi-Step Workflows - Guided processes for complex tasks
  • MCP Integration - Connect external documentation sources

Installation System

  • One-Line Install - curl -fsSL https://raw.githubusercontent.com/LuisLadino/claude-dev-framework/main/scripts/install.sh | bash
  • Clean Architecture - No bloat, only essential framework files
  • Smart Merge - Preserves existing .claude/ directories
  • Easy Uninstall - With backup options

Key Features

🧠 Architectural Memory

# Claude remembers your decisions forever
architecture_patterns:
  - "Event-driven microservices with CQRS"
  - "Hexagonal architecture for domain isolation"
  - "No circular dependencies (enforced)"
🔍 Intelligent Stack Research
/research-stack

# Claude researches YOUR stack online:
# - Official documentation
# - Current best practices (2024-2025)
# - Framework-specific patterns
# - Version-specific features
📋 Interactive PRD Generation
/create-prd

# 12-question workflow creates comprehensive PRDs
# Adapts to your tech stack automatically
# Saves to .claude/tasks/ (no project root clutter)
📊 Codebase Analysis
/import-standards analyze codebase

# Discovers actual patterns in your code
# Suggests edits to existing standards
# Creates new standards files automatically
📦 Installation
New Project
cd your-project
curl -fsSL https://raw.githubusercontent.com/LuisLadino/claude-dev-framework/main/scripts/install.sh | bash
/research-stack  # Generate standards for your stack
Existing Claude Code Setup
# Installer automatically detects and merges
curl -fsSL https://raw.githubusercontent.com/LuisLadino/claude-dev-framework/main/scripts/install.sh | bash
# Choose option 2: Merge with existing
🎓 Documentation
[Getting Started](https://github.com/LuisLadino/claude-dev-framework/blob/main/docs/getting-started.md) - Complete setup guide with migration paths
[Philosophy](https://github.com/LuisLadino/claude-dev-framework/blob/main/docs/philosophy.md) - Why this framework exists
[Customization Guide](https://github.com/LuisLadino/claude-dev-framework/blob/main/docs/customization-guide.md) - Extend the framework
[FAQ](https://github.com/LuisLadino/claude-dev-framework/blob/main/docs/faq.md) - Common questions and troubleshooting
💡 Who Is This For?
Senior/Staff Engineers
Problem: Context loss between Claude sessions, tribal knowledge not captured, team scaling challenges
Solution: Codify your expertise once, scale it to everyone
ROI: 10-20 hours/week saved per developer
Engineering Leaders
Problem: Junior devs shipping code that doesn't meet standards, code review bottleneck, inconsistent patterns
Solution: Framework enforces your standards automatically
Result: Linear team velocity (not logarithmic)
Solo Developers
Problem: Repeating yourself to Claude, inconsistent outputs, forgetting architectural decisions
Solution: Standards that persist across sessions
Benefit: Consistent, production-grade code
🌟 What Makes This Special
Stack-Agnostic
# Works with ANY stack via /research-stack
✅ Frontend: React, Vue, Svelte, Angular, Solid
✅ Backend: FastAPI, Django, Express, Rails, Laravel
✅ Systems: Rust, Go, C++, Zig
✅ Mobile: React Native, Flutter, Swift, Kotlin
✅ And literally any other framework
No Lock-In
# Your standards are just markdown files
.claude/your-stack/
├── coding-standards/
│   ├── python-standards.md    # Plain markdown
│   └── fastapi-patterns.md    # Easy to read/edit
└── architecture/
    └── decisions.md            # Version control friendly

# Keep them, migrate them, or delete them anytime
Production-Ready
Security standards enforced by default
Observability built into generated code
Testing strategies included
Accessibility patterns included
Performance considerations documented
📊 Framework vs. Raw Claude
Aspect	Raw Claude	With Framework
Context Persistence	Lost every session	Permanent memory
Standards Enforcement	Manual reminders	Automatic
Team Consistency	Varies by person	Identical output
Architectural Decisions	Forgotten	Always followed
Onboarding Time	Weeks	Hours
Code Review Time	Hours	Minutes
Setup Time	N/A	2 minutes
🔧 Technical Details
What Gets Installed
.claude/
├── CLAUDE.md              # Main framework instructions
├── commands/              # 11 slash commands
├── workflows/             # Multi-step processes
├── tools/                 # MCP and tool configs
├── config/                # Environment settings
├── your-stack/            # Your custom standards (empty)
└── tasks/                 # Generated PRDs/tasks
What Stays on GitHub Only
❌ templates/              # You generate actual standards
❌ docs/                   # Full documentation
❌ CHANGELOG.md            # Project history
❌ examples/               # Example configs
Total Install Size: ~20 essential files (not 100+ with bloat)
🚦 Getting Started (5 Minutes)
Install Framework
curl -fsSL https://raw.githubusercontent.com/LuisLadino/claude-dev-framework/main/scripts/install.sh | bash
Generate Standards
/research-stack
# Tell Claude your stack: "Next.js 15 with TypeScript and Tailwind"
Start Coding
/start-task "Add user authentication"
# Claude follows your standards automatically
🐛 Known Issues
None reported yet! This is the initial stable release.
🤝 Contributing
We welcome contributions! See [CONTRIBUTING.md](https://github.com/LuisLadino/claude-dev-framework/blob/main/CONTRIBUTING.md) for:
Bug reports
Feature requests
Documentation improvements
New stack templates
📄 License
MIT License - Use it however you want, commercially or personally.
🙏 Acknowledgments
Built with [Claude Code](https://claude.com/claude-code) by Anthropic. Special thanks to the developer community for feedback and inspiration.
📈 What's Next?
Roadmap for future releases:
 VSCode extension for easier command access
 Web dashboard for standards visualization
 Team collaboration features
 Pre-built standards packs (security, accessibility, performance)
 GitHub Actions integration
 IDE integrations (JetBrains, Cursor, etc.)
Ready to scale your development with AI?
curl -fsSL https://raw.githubusercontent.com/LuisLadino/claude-dev-framework/main/scripts/install.sh | bash
⭐ Star this repo if you find it useful!
🐛 Report issues on [GitHub Issues](https://github.com/LuisLadino/claude-dev-framework/issues)
💬 Join discussions on [GitHub Discussions](https://github.com/LuisLadino/claude-dev-framework/discussions)
Assets 2
Loading