Un sistema de Context-Driven Development para Claude Code y Gemini CLI.

Sin contexto, no hay código. Sin plan, no hay implementación.

Contextor transforma tu flujo de trabajo:

Contexto → Especificación → Plan → Implementación

Clona este repositorio y copia los archivos a tu proyecto:

git clone https://github.com/alvarolizama/contextor.git /tmp/contextor

# Copia todo a tu proyecto
cp -r /tmp/contextor/.claude /tu-proyecto/
cp -r /tmp/contextor/.gemini /tu-proyecto/
cp /tmp/contextor/CLAUDE.md /tu-proyecto/
cp /tmp/contextor/GEMINI.md /tu-proyecto/

# Limpia
rm -rf /tmp/contextor

O manualmente, copia estas carpetas/archivos a la raíz de tu proyecto:

Los comandos usan el prefijo /contextor-:

/contextor-setup              # Inicializa el proyecto
/contextor-newtrack <nombre>  # Crea nueva feature/bugfix
/contextor-implement          # Implementa el track actual
/contextor-status             # Muestra estado del proyecto
/contextor-revert <target>    # Revierte cambios

Los comandos usan la sintaxis /contextor::

/contextor:setup              # Inicializa el proyecto
/contextor:newtrack <nombre>  # Crea nueva feature/bugfix
/contextor:implement          # Implementa el track actual
/contextor:status             # Muestra estado del proyecto
/contextor:revert <target>    # Revierte cambios

/contextor-setup        # Claude Code
/contextor:setup        # Gemini CLI

Te preguntará sobre:

• Visión del producto
• Stack tecnológico
• Flujo de trabajo del equipo
• Estándares de código

Genera archivos en contextor/:

• product.md - Definición del producto
• tech-stack.md - Tecnologías elegidas
• workflow.md - Procesos del equipo
• guidelines.md - Estándares de código

/contextor-newtrack auth-system    # Claude Code
/contextor:newtrack auth-system    # Gemini CLI

El asistente:

1. Lee todo el contexto del proyecto
2. Te pregunta qué quieres construir
3. Genera spec.md con requisitos detallados
4. Genera plan.md con tareas estructuradas
5. Espera tu aprobación antes de continuar

/contextor-implement    # Claude Code
/contextor:implement    # Gemini CLI

El asistente:

1. Ejecuta tareas del plan en orden
2. Sigue el workflow definido (TDD, etc.)
3. Hace commits atómicos por tarea
4. Actualiza el progreso en plan.md

/contextor-status    # Claude Code
/contextor:status    # Gemini CLI

Muestra:

• Resumen del proyecto
• Tracks activos y completados
• Progreso actual

/contextor-revert track:auth-system    # Claude Code
/contextor:revert track:auth-system    # Gemini CLI

Opciones:

• track:<nombre> - Revierte todo un track
• fase:<número> - Revierte una fase
• tarea:<número> - Revierte una tarea específica

Después de instalar y ejecutar setup:

tu-proyecto/
├── .claude/
│   └── skills/
│       ├── contextor-setup/
│       ├── contextor-newtrack/
│       ├── contextor-implement/
│       ├── contextor-status/
│       └── contextor-revert/
├── .gemini/
│   └── commands/contextor/
│       ├── setup.toml
│       ├── newtrack.toml
│       ├── implement.toml
│       ├── status.toml
│       └── revert.toml
├── CLAUDE.md
├── GEMINI.md
├── contextor/                    # Generado por /contextor-setup
│   ├── product.md
│   ├── tech-stack.md
│   ├── workflow.md
│   ├── guidelines.md
│   └── tracks/
│       └── mi-feature/
│           ├── spec.md
│           └── plan.md
└── ... (tu código)

• Los skills están en .claude/skills/<nombre>/SKILL.md
• Usan frontmatter YAML + instrucciones Markdown
• Se invocan con /contextor-<comando>

• Los slash commands están en .gemini/commands/contextor/*.toml
• Usan formato TOML con description y prompt
• Se invocan con /contextor:<comando>

1. Contexto es rey: Invierte tiempo en el setup
2. Revisa los planes: Siempre revisa spec.md y plan.md antes de implementar
3. Commits atómicos: Cada tarea = un commit semántico
4. Itera el contexto: Actualiza los archivos cuando el proyecto evolucione

MIT