Skip to content
Apothem
Comandos del pipeline

Comandos del pipeline

Referencia de comandos del pipeline de Apothem: el flujo /plan y el catálogo de comandos de auditoría.

Apothem incluye un pipeline /plan consciente de la arquitectura, un pipeline /research de trece etapas y una secuencia de auditoría de once comandos, ofreciendo a cada proyecto una ruta estructurada desde la prosa en bruto hasta código de nivel de producción revisado en múltiples ejes, y desde una idea en bruto hasta un artículo difundido y revisado por pares.

Visión general del pipeline

flowchart LR
    accTitle: Plan pipeline command flow
    accDescr: Left-to-right flowchart of the apothem plan pipeline from the spec stage through the generate and review stages, then through a conditional architecture-bearing decision that either runs the design stage or skips directly to the execute stage. The orthogonal audit stage wraps the spec-through-review span as a closed remediation loop.
    A[/plan-spec] --> B[/plan-generate]
    B --> C[/plan-review]
    AUD[/plan-audit<br/>orthogonal: wraps spec → review] -.->|closed-loop remediation| A
    C --> Q{Architecture-bearing suite?}
    Q -->|yes| F[/plan-design<br/>emit _inputs/design.md]
    Q -->|no| D[/plan-execute]
    F --> D
    D --> E[/plan-status]
    D --> G[Audit review sequence]
    G --> H[Completion milestone]

Las etapas de planificación

El pipeline se distribuye como ocho comandos de barra de primera clase, uno por etapa, cada uno invocable de forma independiente como /plan-<stage>.

EtapaRolPosición
/plan-specForja — de prosa a especificaciónInicial
/plan-generateGenerador — de especificación a suite de planIntermedia
/plan-reviewAuditor — auditoría forense del planIntermedia
/plan-designArquitecto — _inputs/design.md para suites con arquitecturaCompuerta condicional
/plan-executeEjecutor — ejecución de fasesTerminal
/plan-statusReportador — estado de solo lecturaSolo lectura
/plan-auditGuardián — envoltura de ciclo cerrado de spec → generate → reviewOrtogonal (pre-ejecución)
/plan-amendAdministrador — enmienda reentrante de una suite existenteReentrante

/plan-audit es ortogonal al flujo lineal, no una etapa dentro de él. Envuelve /plan-spec → /plan-generate → /plan-review como un único ciclo cerrado, ejecuta solo las etapas previas faltantes, remedia activamente los hallazgos y deja la suite lista para /plan-execute. Es distinto de la secuencia de auditoría de abajo, que audita una base de código ejecutada en lugar de una suite de plan.

/plan-design no es una ceremonia universal. /plan-review clasifica si la suite cambia superficies con arquitectura. En caso afirmativo, /plan-design emite la traza de diseño que consumen /plan-execute y /architecture-review. En caso negativo, la suite revisada pasa directamente a la ejecución.

El pipeline de investigación

El pipeline de investigación se distribuye como trece comandos de barra de primera clase, uno por etapa, cada uno invocable de forma independiente como /research-<stage>, encadenados por una Compuerta de Secuencia y un Manifiesto de Traspaso, bajo diez mandatos de rigor (fuentes autorizadas, reproducibilidad, falsabilidad, integridad de citas, preregistro, ética / conflictos, rigor estadístico, ciencia abierta / FAIR, conformidad con las pautas de reporte, fundamentación teórica / impacto).

flowchart LR
    accTitle: Research pipeline command flow
    accDescr: Left-to-right flowchart of the apothem research pipeline from the ideate stage through spec, theory, sources, synthesis, proposal, study design, experiment, analysis, paper, and peer review to publish and disseminate, with a revision loop from review back to paper.
    RI[/research-ideate] --> RS[/research-spec]
    RS --> RT[/research-theory]
    RT --> RSO[/research-sources]
    RSO --> RSY[/research-synthesis]
    RSY --> RPR[/research-proposal]
    RPR --> RD[/research-design]
    RD --> RE[/research-experiment]
    RE --> RA[/research-analysis]
    RA --> RP[/research-paper]
    RP --> RR[/research-review]
    RR --> RPU[/research-publish]
    RPU --> RDI[/research-disseminate]
    RR -.->|revision loop| RP
EtapaRolPosición
/research-ideateFormular el problema — preguntas candidatas a partir de una semilla de dominioInicial
/research-specEnmarcar la pregunta — hipótesis falsables + alcanceIntermedia
/research-theoryMarco conceptual + teoría del cambioIntermedia
/research-sourcesRecolección sistemática de fuentesIntermedia
/research-synthesisMapa del SOTA + análisis de brechasIntermedia
/research-proposalObjetivos + factibilidad + impacto + plan de preregistroIntermedia
/research-designDiseño del estudio + preregistroIntermedia
/research-experimentEjecutar + registrar, reproducibleIntermedia
/research-analysisResultados + estadísticaIntermedia
/research-paperBorrador de artículo de primer nivelIntermedia
/research-reviewCrítica de nivel revisión por paresIntermedia
/research-publishPaquete para la sede + envíoIntermedia
/research-disseminateDifusión + impacto + archivo FAIRTerminal

El orquestador de flujo de trabajo envuelto /research impulsa estas etapas desde la pregunta en bruto hasta el artículo publicado (él mismo no es una etapa), comprobando de forma independiente la salida de cada etapa antes de que la siguiente se base en ella; --quick ejecuta solo /research-sources + /research-synthesis para un informe citado de una sola pasada.

Las etapas empíricas (fuentes, diseño, experimento, análisis) y las etapas de redacción (artículo, revisión, publicación, difusión) se apoyan además en superficies que operacionalizan el rigor —comparación justa entre múltiples métodos, procedencia de comparadores, un andamiaje de programa de experimentos, un plan de utilización de cómputo, un bucle de experimentación autónomo opcional, una compuerta de avance de definición de terminado, y cegamiento con divulgación por etapas— que añaden detalle operativo a los diez mandatos sin ampliarlos.

Secuencia de auditoría

El orquestador de flujo de trabajo envuelto /audit barre las once dimensiones de abajo como una única pasada paralela —el análogo de auditoría-fortaleza de /plan y /research— sintetizando un único informe de hallazgos deduplicado y clasificado por severidad (solo reporte; la remediación se enruta a /elevate). Cada dimensión también es invocable individualmente.

El orquestador de flujo de trabajo envuelto /fortress cierra el ciclo que /audit reporta: detecta mediante /audit, verifica cada hallazgo, remedia cada superviviente en su superficie propietaria, vuelve a auditar en un ciclo acotado y pasa el resultado por la compuerta /release-readiness —el análogo de endurecimiento de producción de /plan y /research.

ComandoÁrea de calidad
/code-reviewCalidad del código
/code-auditCorpus de código
/security-auditOWASP / ASVS
/perf-auditRendimiento
/architecture-reviewArquitectura
/ux-reviewExperiencia de desarrollo
/a11y-auditAccesibilidad
/docs-reviewDocumentación
/dependency-auditDependencias
/supply-chain-auditCadena de suministro
/threat-model-auditModelo de amenazas

On this page