Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

27 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Oden Forge v3.0 🚀

NPM Version Downloads Documentation

Living Quality Gates for Professional Development

"Your tools should stop bad code before it becomes your problem"

🎯 Core Philosophy v3

"Adaptive Hybrid + Zero-Setup Friction + Intelligent Orchestration"

🆕 What's New in v3

  • Living Quality Gates: Automatic 80%+ coverage enforcement
  • Auto-Detection Intelligence: Detects stack and configures automatically
  • Pattern Detection: Identifies duplicates and architectural drift
  • Context Preservation: Maintains context between sessions
  • ADR Management: Automatically detects missing decisions

⚡ Installation (60 seconds)

# Install globally
npm install -g oden-forge

# Auto-setup in your project
cd your-project
/oden:init

Done! Quality gates are now active.

🛡️ Quality Gates in Action

Mandatory Coverage

$ /oden:test gates
🛡️ TESTING QUALITY GATES ACTIVE
✅ Pre-commit: 80% coverage enforced
✅ Framework detection: Jest, Vitest, Go, Rust...
✅ Coverage trending: 78% → 85% ↗️

Pattern Detection

$ /oden:context detect
🔍 PATTERN ANALYSIS COMPLETE
✅ 3x formatCurrency implementations found
✅ God file detected: UserService.ts (2,392 lines)
🚀 Refactoring suggestions ready

Automatic ADRs

$ /oden:adr suggest
🏗️ MISSING ADR DETECTED
✅ Database choice (PostgreSQL vs MongoDB)
✅ State management (Redux vs Zustand)
📝 ADR templates ready for creation

🎮 Main Commands

Setup

/oden:init          # Complete automatic setup
/oden:help          # Full documentation

Pre-Development

/oden:architect     # Technical decisions + DB schema
/oden:spec module   # Detailed module specification
/oden:checklist     # Verify everything is ready

Feature Pipeline

/oden:prd feature   # PRD with intelligent brainstorming
/oden:epic feature  # PRD → Technical Epic
/oden:work feature  # Automatic implementation

Quality Gates

/oden:test gates    # Verify quality gates
/oden:adr suggest   # Detect missing ADRs
/oden:context detect # Pattern analysis
/oden:review scope  # Automatic code review

See all commands: Complete Command Guide

🏆 Built With Oden

AI coaching platform with quality gates from day one. 85%+ coverage enforced.

Oden Forge is built using Oden Forge. Self-hosting with 90%+ coverage.

Restaurant platform with living ADRs and pattern detection that prevented code duplication.

🔥 What It Prevents

Problem Solution
Commits without tests 80% coverage required
Duplicate code everywhere Pattern detection
Lost context between sessions Automatic preservation
Missing architecture decisions ADR auto-detection
God files and tech debt Smart refactoring suggestions

🚀 Complete Workflows

New Project

1. npm install -g oden-forge
2. /oden:init
3. /oden:architect
4. /oden:spec auth
5. /oden:checklist

Implement Feature

1. /oden:prd user-dashboard
2. /oden:epic user-dashboard
3. /oden:work user-dashboard
4. /oden:test gates
5. /oden:review feature

Daily Routine

1. /oden:daily
2. /oden:work #123
3. /oden:test gates
4. /oden:context detect
5. /oden:git commit

📊 Success Metrics

Quality Gates

  • 80%+ coverage enforced automatically
  • Pattern detection prevents duplication
  • ADR compliance 95%+ decisions documented
  • Context preservation between sessions

Productivity

  • 60 seconds initial setup
  • Documentation-First methodology
  • Zero-config for popular stacks
  • Auto-detection of frameworks

Real Results

  • 🔥 Less debugging time: Code that doesn't pass gates never reaches production
  • 📈 Better coverage: From ~40% typical to 85%+ enforced
  • ⚡ Faster setup: From hours of configuration to 60 seconds
  • 🧠 Less decision fatigue: Automatic ADRs for common decisions

🏗️ Who Is Oden Forge For

👥 Teams

  • Startups: Professional MVP in 8-10 weeks with quality gates from day one
  • Enterprise: Enterprise-ready products in 14-20 weeks with zero tech debt
  • Consulting: Standard methodology for all projects

👨‍💻 Developers

  • Senior: Automatic best practices enforcement without micromanaging
  • Junior: Automatic guides and quality gates that teach while you work
  • Freelancers: Professional methodology without complex setup

🔧 Claude Code Integration

Oden Forge is designed specifically for Claude Code:

  • Native integration with /oden: commands
  • Context preservation optimized for Claude
  • MCP support for extended functionality
  • Agent orchestration with specialized sub-agents

📚 Documentation

🛠️ Troubleshooting

Installation

# If command not found
npm install -g oden-forge@latest

# Verify installation
/oden:help

Quality Gates

# Verify they're working
/oden:test gates

# See detailed status
/oden:context detect

Common Issues

# Automatic debugging
/oden:debug

🤝 Contributing

git clone https://github.com/javikin/oden.git
cd oden
npm install

Contribution principles:

  • Quality gates active in development
  • Documentation-First for new features
  • 80%+ coverage mandatory
  • ADRs for architectural decisions

📄 License

MIT License - See LICENSE for details.


⭐ Star on GitHub | 📦 NPM Package | 📚 Documentation

Built with quality gates for developers who value craftsmanship

About

Documentation-First Development Toolkit for Claude Code

Resources

Stars

7 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages