oden-forge
v3.0.0
Published
Living Quality Gates for Claude Code - Enforce 80%+ test coverage, detect patterns, and prevent bad code from reaching production with automatic quality enforcement
Maintainers
Readme
Oden Forge v3.0 🚀
Living Quality Gates for Professional Development
"Your tools should stop bad code before it becomes your problem"
🎯 Filosofía Core v3
"Híbrido Adaptativo + Zero-Setup Friction + Intelligent Orchestration"
🆕 Novedades v3
- Living Quality Gates: Enforcement automático de cobertura 80%+
- Auto-Detection Intelligence: Detecta stack y configura automáticamente
- Pattern Detection: Identifica duplicados y deriva arquitectural
- Context Preservation: Mantiene contexto entre sesiones
- ADR Management: Detecta decisiones faltantes automáticamente
⚡ Instalación (60 segundos)
# Instalar globalmente
npm install -g oden-forge
# Setup automático en tu proyecto
cd tu-proyecto
/oden:init¡Listo! Las quality gates están activas.
🛡️ Quality Gates en Acción
Cobertura Obligatoria
$ /oden:test gates
🛡️ TESTING QUALITY GATES ACTIVE
✅ Pre-commit: 80% coverage enforced
✅ Framework detection: Jest, Vitest, Go, Rust...
✅ Coverage trending: 78% → 85% ↗️Detección de Patrones
$ /oden:context detect
🔍 PATTERN ANALYSIS COMPLETE
✅ 3x formatCurrency implementations found
✅ God file detected: UserService.ts (2,392 lines)
🚀 Refactoring suggestions readyADRs Automáticos
$ /oden:adr suggest
🏗️ MISSING ADR DETECTED
✅ Database choice (PostgreSQL vs MongoDB)
✅ State management (Redux vs Zustand)
📝 ADR templates ready for creation🎮 Comandos Principales
Setup
/oden:init # Setup automático completo
/oden:help # Documentación completaPre-Desarrollo
/oden:architect # Technical decisions + DB schema
/oden:spec module # Especificación detallada por módulo
/oden:checklist # Verificar todo listoFeature Pipeline
/oden:prd feature # PRD con brainstorming inteligente
/oden:epic feature # PRD → Epic técnico
/oden:work feature # Implementación automáticaQuality Gates
/oden:test gates # Verificar quality gates
/oden:adr suggest # Detectar ADRs faltantes
/oden:context detect # Análisis de patrones
/oden:review scope # Code review automáticoVer todos los comandos: Guía Completa de Comandos
🏆 Built With Oden
Tu.coach
AI coaching platform con quality gates desde el día uno. 85%+ cobertura enforced.
Oden Forge
Oden Forge se construye usando Oden Forge. Self-hosting con 90%+ cobertura.
Oden Food
Restaurant platform con living ADRs y pattern detection que previno duplicación de código.
🔥 Lo Que Previene
| Problema | Solución | |----------|----------| | 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 |
🚀 Workflows Completos
Nuevo Proyecto
1. npm install -g oden-forge
2. /oden:init
3. /oden:architect
4. /oden:spec auth
5. /oden:checklistImplementar Feature
1. /oden:prd user-dashboard
2. /oden:epic user-dashboard
3. /oden:work user-dashboard
4. /oden:test gates
5. /oden:review featureRutina Diaria
1. /oden:daily
2. /oden:work #123
3. /oden:test gates
4. /oden:context detect
5. /oden:git commit📊 Métricas de Éxito
Quality Gates
- ✅ 80%+ cobertura enforced automáticamente
- ✅ Pattern detection previene duplicación
- ✅ ADR compliance 95%+ decisiones documentadas
- ✅ Context preservation entre sesiones
Productividad
- ✅ 60 segundos setup inicial
- ✅ Documentation-First methodology
- ✅ Zero-config para stacks populares
- ✅ Auto-detection de frameworks
Resultados Reales
- 🔥 Menos tiempo debugging: Código que no pasa gates no llega a producción
- 📈 Mejor cobertura: De ~40% típico a 85%+ enforced
- ⚡ Setup más rápido: De horas de configuración a 60 segundos
- 🧠 Menos decisiones fatiga: ADRs automáticos para decisiones comunes
🏗️ Para Quién es Oden Forge
👥 Teams
- Startups: MVP profesional en 8-10 semanas con quality gates desde día uno
- Enterprise: Productos enterprise-ready en 14-20 semanas con 0 deuda técnica
- Consultoras: Metodología estándar para todos los proyectos
👨💻 Desarrolladores
- Senior: Enforcement automático de mejores prácticas sin micromanaging
- Junior: Guías automáticas y quality gates que enseñan mientras trabajas
- Freelancers: Metodología profesional sin setup complejo
🔧 Claude Code Integration
Oden Forge está diseñado específicamente para Claude Code:
- ✅ Native integration con comandos
/oden: - ✅ Context preservation optimizado para Claude
- ✅ MCP support para funcionalidades extendidas
- ✅ Agent orchestration con sub-agentes especializados
📚 Documentación
- Landing Page - Overview y features
- Installation Guide - Setup paso a paso
- Command Reference - Todos los comandos
- GitHub Repository - Código fuente
🛠️ Troubleshooting
Instalación
# Si no encuentra el comando
npm install -g oden-forge@latest
# Verificar instalación
/oden:helpQuality Gates
# Verificar que funcionan
/oden:test gates
# Ver estado detallado
/oden:context detectCommon Issues
# Debug automático
/oden:debug🤝 Contribuir
git clone https://github.com/javikin/oden.git
cd oden
npm installPrincipios de contribución:
- Quality gates activos en el desarrollo
- Documentation-First para nuevos features
- 80%+ cobertura obligatorio
- ADRs para decisiones arquitecturales
📄 Licencia
MIT License - Ver LICENSE para más detalles.
⭐ Star en GitHub | 📦 NPM Package | 📚 Documentación
Built with quality gates for developers who value craftsmanship
