Skip to content

javikin/oden

BranchesTags

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

4 Commits
.claude
.claude
 
 
.gitignore
.gitignore
 
 
INSTALL.md
INSTALL.md
 
 
README.md
README.md
 
 
install.sh
install.sh
 
 

Repository files navigation

Oden Forge

Forja proyectos profesionales desde cero usando la metodología Documentation-First Development.

Oden Forge es un sistema de skills para Claude Code que guía a desarrolladores a través de un wizard inteligente para crear proyectos completos siguiendo las mejores prácticas de la metodología Oden.

Filosofía

"Documenta y diseña COMPLETAMENTE antes de codificar"

La metodología Oden se basa en tres principios:

  1. Documentation-First: Todo se documenta antes de escribir código
  2. Design Sprint Adaptado: Diseño rápido → Validación → Iteración
  3. Entrega incremental: Valor tangible cada semana

Quick Start

# Clonar e instalar (reemplaza "mi-proyecto" con el nombre de tu proyecto)
git clone https://github.com/javikin/oden.git mi-proyecto
cd mi-proyecto
./install.sh

# En Claude Code, iniciar un nuevo proyecto
/oden:init

Comandos Disponibles

Inicialización y Setup

Comando Descripción
/oden:init Wizard interactivo para crear un proyecto desde cero
/oden:init-agents [cat] Instalar agentes de desarrollo (core, frontend, backend, mobile, devops, data)
/oden:init-mcp [cat] Instalar MCPs recomendados (essential, design, backend, testing, mobile, devops)
/oden:help Mostrar ayuda y guías

Fase Pre-Desarrollo

Comando Descripción
/oden:architect Crear technical-decisions.md (arquitectura, DB schema, stack)
/oden:analyze Análisis competitivo y requisitos de negocio
/oden:spec [módulo] Crear especificaciones detalladas por módulo (800+ líneas)
/oden:plan Plan de implementación semana por semana
/oden:checklist Verificar que todo esté listo antes de codificar

Fase Desarrollo

Comando Descripción
/oden:daily Registrar progreso diario (DAY_X_COMPLETED.md)
/oden:dev [agent] Invocar agentes de desarrollo (ver abajo)
/oden:review Code review automático antes de PR
/oden:test [sub] Testing - estrategia, ejecución, análisis
/oden:debug [sub] Debugging - analizar errores y soluciones
/oden:research [topic] Investigación técnica
/oden:git [sub] Git workflow - branches, PRs, gestión

Sincronización con GitHub (integración CCPM)

Comando Descripción
/oden:sync setup Configurar proyecto para sync con GitHub
/oden:sync prd [nombre] Crear PRD (Product Requirement Document)
/oden:sync epic [nombre] Convertir PRD a Epic técnico
/oden:sync tasks [nombre] Descomponer Epic en tasks
/oden:sync github [nombre] Push Epic y tasks a GitHub como issues
/oden:sync start [nombre] Iniciar desarrollo en epic (worktree)
/oden:sync issue [#] Trabajar en un issue específico
/oden:sync close [#] Cerrar issue completado
/oden:sync status Ver estado de sincronización

Agentes de Desarrollo (/oden:dev)

Durante la implementación, invoca agentes especializados:

Desarrollo de Código

Comando Agente Uso
/oden:dev fullstack fullstack-developer Desarrollo end-to-end
/oden:dev frontend frontend-developer UI/React components
/oden:dev backend backend-architect APIs y servicios
/oden:dev mobile mobile-developer React Native/Flutter
/oden:dev ios ios-developer Swift/SwiftUI nativo

Base de Datos

Comando Agente Uso
/oden:dev db database-architect Diseño de schema
/oden:dev db-optimize database-optimization Optimizar queries
/oden:dev supabase supabase-schema-architect Supabase específico

Testing y QA

Comando Agente Uso
/oden:dev test test-engineer Estrategia de testing
/oden:dev debug debugger Debugging de errores
/oden:dev review code-reviewer Code review

DevOps

Comando Agente Uso
/oden:dev devops devops-engineer CI/CD, infraestructura
/oden:dev deploy deployment-engineer Deployments
/oden:dev perf performance-engineer Performance tuning

Utilidades

Comando Agente Uso
/oden:dev git git-flow-manager Git workflow
/oden:dev docs technical-writer Documentación
/oden:dev analyze-code code-analyzer Análisis de código

Testing (/oden:test)

Comando Descripción
/oden:test strategy Crear estrategia de testing
/oden:test run Ejecutar tests y analizar
/oden:test fix Analizar fallos y sugerir fixes
/oden:test coverage Analizar cobertura
/oden:test generate [mod] Generar tests desde specs

Debugging (/oden:debug)

Comando Descripción
/oden:debug error [msg] Analizar error y sugerir solución
/oden:debug logs [file] Analizar logs para patrones
/oden:debug trace [fn] Trazar flujo de función
/oden:debug perf [area] Analizar performance
/oden:debug compare [branch] Comparar para encontrar regresión

Research (/oden:research)

Comando Descripción
/oden:research how [pregunta] Cómo implementar algo
/oden:research compare [a] vs [b] Comparar tecnologías
/oden:research best-practice [topic] Mejores prácticas
/oden:research library [name] Investigar librería
/oden:research docs [lib] [topic] Buscar documentación

Git Workflow (/oden:git)

Comando Descripción
/oden:git start [feature] Iniciar nueva feature
/oden:git sync Sincronizar con main
/oden:git pr Preparar y crear PR
/oden:git status Estado detallado
/oden:git finish Finalizar feature

El Wizard /oden:init

El wizard te guía a través de:

1. Tipo de Proyecto

  • Web Application (React, Next.js, Vue, etc.)
  • Mobile App (React Native, Flutter, iOS, Android)
  • Backend/API (Node.js, Python, Go, etc.)
  • Full-Stack (combinaciones)

2. Nivel de Experiencia

  • Principiante: Explicaciones detalladas + guías de System Design
  • Intermedio: Guías contextuales + mejores prácticas
  • Avanzado: Solo lo esencial, decisiones rápidas

3. Scope del Proyecto

  • MVP (8-10 semanas): 30-40% features, rápido al mercado
  • Modo Turbo (14-20 semanas): 100% profesional, enterprise-ready

4. Stack Tecnológico

Basado en tus respuestas, recomienda:

  • Framework frontend/backend
  • Base de datos
  • Servicios cloud
  • Herramientas de desarrollo

5. Estructura de Documentación

Crea automáticamente:

docs/
├── README.md
├── guides/
├── reference/
│   ├── technical-decisions.md
│   ├── competitive-analysis.md
│   ├── implementation-plan.md
│   └── modules/
├── development/
│   ├── current/
│   └── completed/
├── archived/
└── temp/

Agentes Pre-Desarrollo

Agente Rol Entregables
technical-architect Arquitectura y decisiones técnicas technical-decisions.md (2000+ líneas)
domain-expert Análisis de competencia y requisitos competitive-analysis.md, user stories
spec-writer Especificaciones detalladas Specs de 800-1200 líneas por módulo
implementation-planner Planificación semana por semana implementation-plan.md
daily-logger Documentación de progreso DAY_X_COMPLETED.md

Métricas de Éxito

Durante Desarrollo

  • 100% de módulos definidos antes de codificar
  • 0 dependencias circulares
  • Documentación > 8,000 líneas antes de primera línea de código
  • Progreso diario documentado

Post-Lanzamiento

  • Performance: < 100ms latencia crítica
  • Uptime: 99.9%
  • User satisfaction: NPS > 50

Estructura del Proyecto

oden/
├── .claude/
│   ├── commands/oden/      # 52 comandos unificados
│   ├── scripts/oden/       # 14 scripts de soporte
│   ├── hooks/              # Hooks de git
│   ├── rules/              # 10 reglas de metodología
│   ├── prds/               # PRDs locales
│   └── epics/              # Epics locales
├── install.sh              # Instalador automático
├── INSTALL.md              # Guía de instalación
└── README.md

Flujo de Trabajo Completo

┌─────────────────────────────────────────────────────────────┐
│                  SETUP INICIAL                              │
├─────────────────────────────────────────────────────────────┤
│  /oden:init             →  Wizard de proyecto               │
│  /oden:init-agents      →  Instalar agentes de desarrollo   │
│  /oden:init-mcp         →  Instalar MCPs recomendados       │
│  /oden:sync setup       →  Configurar GitHub                │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│                    PRE-DESARROLLO (1-2 semanas)             │
├─────────────────────────────────────────────────────────────┤
│  /oden:architect     →  technical-decisions.md (2000+ loc)  │
│     ↓                                                       │
│  /oden:analyze       →  competitive-analysis.md             │
│     ↓                                                       │
│  /oden:spec auth     →  auth-spec.md (800+ loc)            │
│  /oden:spec orders   →  orders-spec.md (800+ loc)          │
│     ↓                                                       │
│  /oden:plan          →  implementation-plan.md              │
│     ↓                                                       │
│  /oden:checklist     →  ✅ Ready to code!                  │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│                    CREAR FEATURES (CCPM)                    │
├─────────────────────────────────────────────────────────────┤
│  /oden:sync prd auth      →  Crear PRD                      │
│     ↓                                                       │
│  /oden:sync epic auth     →  Convertir a Epic técnico       │
│     ↓                                                       │
│  /oden:sync tasks auth    →  Descomponer en tasks           │
│     ↓                                                       │
│  /oden:sync github auth   →  Push a GitHub como issues      │
└─────────────────────────────────────────────────────────────┘
                            ↓
┌─────────────────────────────────────────────────────────────┐
│                    DESARROLLO (8-18 semanas)                │
├─────────────────────────────────────────────────────────────┤
│  /oden:sync start auth    →  Iniciar epic (worktree)        │
│     ↓                                                       │
│  /oden:sync issue #123    →  Trabajar en issue              │
│  /oden:dev fullstack      →  Implementar según specs        │
│  /oden:test run           →  Ejecutar tests                 │
│  /oden:debug error        →  Resolver problemas             │
│     ↓                                                       │
│  /oden:daily              →  DAY_X_COMPLETED.md             │
│     ↓                                                       │
│  /oden:sync close #123    →  Cerrar issue                   │
│  /oden:review             →  Code review                    │
│  /oden:git pr             →  Create PR                      │
└─────────────────────────────────────────────────────────────┘

Requisitos

# GitHub CLI instalado y autenticado (para sync con GitHub)
gh auth status

# Git configurado
git --version

Inspiración

Oden está inspirado en:

  • CCPM - Claude Code Project Manager
  • Metodología Oden - Documentation-First Development
  • Design Sprints de Google Ventures

Contribuir

¿Ideas para mejorar Oden Forge? Abre un issue o PR.

Licencia

MIT

About

Documentation-First Development Toolkit for Claude Code

Resources

Readme
Activity

Stars

1 star

Watchers

0 watching

Forks

0 forks
Report repository

Releases

No releases published

Packages

No packages published

Languages