Framework de investigación estructurada y planificación para Claude Code. Transforma señales crudas en conocimiento validado y acción concreta.
/praxis [input]
│
┌────────┴────────┐
│ Reconocimiento │
│ (repo, tools, │
│ online) │
└────────┬────────┘
│
┌────────┴────────┐
│ Detección de │
│ fase │
└────────┬────────┘
│
┌──────────────┼──────────────┐
▼ ▼ ▼
/discover /hypothesize /roadmap
Exploración Investigación Planificación
abierta 5 fases epics→tasks
│ │ │
└──────────────┼──────────────┘
▼
Implementación
Cada fase es independiente. /praxis detecta en qué fase está el input y delega al skill correcto. Reinvocable sobre el mismo documento conforme avanza.
git clone https://github.com/pablontiv/praxis.git /home/praxis
cd /home/praxis
git config core.hooksPath .hooks
# Sincronizar skills globalmente
.hooks/pre-pushEsto copia los skills a ~/.claude/skills/, haciéndolos disponibles en cualquier proyecto de Claude Code. El hook pre-push también ejecuta esta sincronización automáticamente en cada push.
| Dependencia | Requerida por | Instalación |
|---|---|---|
rootline |
/roadmap (todos los subcomandos) |
curl -fsSL https://raw.githubusercontent.com/pablontiv/rootline/master/install.sh | bash |
backscroll |
/backscroll (búsqueda de sesiones, skill global del repo backscroll) |
cargo install --git https://github.com/pablontiv/backscroll.git |
rootline es un motor de base de datos sobre filesystem que trata directorios como tablas, archivos como records, y YAML frontmatter como metadata. /roadmap lo usa para validación, queries, auto-numbering, scaffolding y grafos de dependencia.
# Ver estado actual del framework
/praxis
# Iniciar flujo con un tema nuevo
/praxis nombre-del-tema
# Continuar un documento existente (detecta fase automáticamente)
/praxis docs/research/mi-investigacion.md
# Usar skills directamente (sin proxy)
/discover init mi-proyecto
/hypothesize tema-a-investigar
/roadmap texto libre para descomponer| Skill | Descripción | Cuándo se invoca |
|---|---|---|
/praxis [input] |
Proxy inteligente. Reconoce entorno, detecta fase, delega. | Punto de entrada principal. Usar siempre que no se sepa qué skill invocar. |
/discover [sub] |
Exploración abierta con ciclos Plan-Act-Observe-Reflect. | Ideas nuevas, preguntas abiertas, exploración sin hipótesis previa. |
/hypothesize [tema] |
Investigación estructurada de 5 fases con trazabilidad lógica. | Claims que necesitan validación, investigación con método, falsación. |
/roadmap [args] |
Descomposición en epics → features → stories → tasks. | Specs listos para planificar, trabajo listo para ejecutar. |
Punto de entrada único. Antes de delegar:
- Reconoce el entorno: estructura del repo, dependencias, git, framework state, búsqueda online
- Detecta la fase del input: marcadores de investigación, artefactos roadmap, líneas discover
- Delega al skill correcto con todo el contexto recolectado
Acepta: archivo .md, tema corto, o vacío (muestra estado).
Framework de R&D con líneas de investigación independientes.
| Subcomando | Qué hace |
|---|---|
init |
Inicializa el framework (MAP.md, directorios, templates) |
new-line [nombre] |
Crea nueva línea de investigación |
cycle [línea] |
Ejecuta un ciclo PAOR en una línea |
reflect [línea] |
Reflexión sobre ciclos acumulados |
theory [nombre] |
Documenta una teoría emergente |
status |
Muestra estado actual del framework |
update-map |
Actualiza MAP.md con estado real |
interlink |
Busca conexiones entre líneas |
review-patterns |
Revisa patrones emergentes |
research [tema] |
Investigación con anti-presuposiciones |
@file |
Analiza archivo externo (intake) |
Investigación de 5 fases con trazabilidad lógica completa:
- Fase 1: Idea → Tesis (axiomas, decisiones, modelo deseado)
- Fase 2: Tesis → Plan de investigación (hipótesis, CAPs, criterios)
- Fase 3: Investigación → Argumento actualizado (matriz premisa-evidencia)
- Fase 4: Argumento → Factibilidad (claims técnicos, Go/No-Go)
- Fase 5: Factibilidad → Prototipo (validación operacional)
Tres modos de entrada:
- CREAR: tema nuevo → flujo interactivo desde Paso 0
- SEGUIMIENTO: archivo existente → detecta fase y continúa
- DIRECTO: contenido con claims → extrae y estructura
Descomposición jerárquica: Epic > Feature > Story > Task.
| Subcomando | Qué hace |
|---|---|
| (texto libre) | Descomposición autónoma desde descripción |
pending |
Muestra tasks pendientes |
loop |
Ejecuta tasks secuencialmente |
plan |
Genera plan desde contexto de conversación |
Requiere rootline CLI — no opera sin ella.
| Agent | Descripción |
|---|---|
| grounded-theory-analyst | Análisis Grounded Theory (Glaser & Strauss). Read-only. Para datos cualitativos sin estructura previa. |
| sdd-validator | Valida cadena de trazabilidad del roadmap (Epic→Feature→Story→Task). Lee roadmap-root desde .claude/roadmap.local.md. |
Crear .claude/roadmap.local.md en la raíz del proyecto. Todas las opciones
tienen defaults sensibles — solo configurar lo que difiera.
| Opción | Default | Descripción |
|---|---|---|
roadmap-root |
(requerido) | Path al directorio de epics (ej: docs/epics) |
done-statuses |
['Completed', 'Obsolete'] |
Valores de estado que marcan un task/story como terminado |
active-statuses |
['Pending', 'Specified', 'In Progress'] |
Valores de estado que marcan trabajo en progreso |
leaf-filter |
'isIndex == false' |
Filtro rootline para excluir index files (READMEs) |
story-close-verify |
[] |
Comandos a ejecutar al cerrar una Story para verificar completitud |
pr-merge-strategy |
'squash' |
Estrategia de merge para PRs: squash, rebase, o merge |
commit-style |
'conventional' |
Formato de commit. Ver Commit styles |
auto-push |
true |
Push automático tras cada commit (sin --pr). false acumula commits localmente |
| Valor | Formato | Ejemplo |
|---|---|---|
conventional |
type(scope): description |
feat(auth): add JWT validation |
terse |
descripción corta, sin type/scope | add jwt validation |
Con conventional, el hook .githooks/commit-msg valida el formato.
Con terse, no se espera hook de formato.
---
roadmap-root: docs/epics
------
roadmap-root: docs/epics
done-statuses: ['Completed', 'Obsolete']
active-statuses: ['Pending', 'Specified', 'In Progress']
leaf-filter: 'isIndex == false'
story-close-verify: ['just test', 'just check']
pr-merge-strategy: 'squash'
commit-style: 'conventional'
auto-push: true
---
## Tipos de task
### research-document
```yaml
fuentes: # URLs o papers consultados
hallazgos: # resumen de findings
### Tipos de task (body del archivo)
El body markdown de `roadmap.local.md` puede definir tipos de task con templates
YAML project-specific. Si no se definen, se usan los templates genéricos del skill.
### State files (generados automáticamente)
| Archivo | Generado por | Propósito |
|---------|-------------|-----------|
| `MAP.md` | `/discover init` | Mapa general del framework |
| `.claude/rules/current-state.md` | `/discover` | Estado actual de líneas y fases |
| `.claude/rules/connections.md` | `/discover interlink` | Conexiones entre líneas |
## Estructura del Repo
.claude/ ├── skills/ │ ├── praxis/ ← proxy inteligente │ ├── discover/ ← exploración + templates │ ├── hypothesize/ ← investigación 5 fases │ ├── roadmap/ ← planificación + guías ├── agents/ ← grounded-theory, sdd-validator ├── rules/ ← praxis-pipeline.md └── hooks/ ← SessionStart hook .hooks/ ├── pre-push ← sincroniza skills en push └── post-merge ← sincroniza skills en pull