Comandos de la canalización
Referencia de los comandos de la canalización de Apothem — el flujo /plan y el catálogo de comandos de auditoría.
Apothem distribuye una canalización /plan consciente de la arquitectura, una
canalización /research de trece etapas y una secuencia de auditoría de once
comandos, que dan a cada proyecto una ruta estructurada desde la prosa en bruto
hasta un 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 de la canalización
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, and the re-entrant amend stage revises an existing suite and returns it to review.
A[/plan-spec] --> B[/plan-generate]
B --> C[/plan-review]
AUD[/plan-audit<br/>orthogonal: wraps spec → review] -.->|closed-loop remediation| A
AM[/plan-amend<br/>re-entrant: revises an existing suite] -.->|re-review| C
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
La canalización se distribuye como ocho comandos de barra de primera clase, uno
por etapa, cada uno invocable de forma independiente como /plan-<stage>. El
orquestador /plan las conduce desde una misión hasta una
suite ejecutada.
| Etapa | Función | Posición |
|---|---|---|
| /plan-spec | Forja — de la prosa a la especificación | Inicio |
| /plan-generate | Generador — de la especificación a la suite de plan | Intermedia |
| /plan-review | Auditor — auditoría forense del plan | Intermedia |
| /plan-design | Arquitecto — _inputs/design.md para las suites que afectan a la arquitectura | Puerta condicional |
| /plan-execute | Ejecutor — ejecución de fases | Final |
| /plan-status | Informador — estado de solo lectura | Solo lectura |
| /plan-audit | Guardián — envoltura de ciclo cerrado de spec → generate → review | Ortogonal (antes de execute) |
| /plan-amend | Administrador — enmienda reentrante de una suite existente | Reentrante |
/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 que faltan, remedia activamente los hallazgos y
deja la suite lista para /plan-execute. Es distinto de la secuencia de
revisión de auditoría que se describe más 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 que afectan a la 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.
La canalización de investigación
La canalización 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 Puerta de secuencia y un Manifiesto de
traspaso, bajo diez mandatos de rigor (fuentes autorizadas, reproducibilidad,
falsabilidad, integridad de las citas, prerregistro, ética / conflictos, rigor
estadístico, ciencia abierta / FAIR, conformidad con las guías de publicación de
resultados, 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| Etapa | Función | Posición |
|---|---|---|
| /research-ideate | Formular el problema — preguntas candidatas a partir de una semilla de dominio | Inicio |
| /research-spec | Enmarcar la pregunta — hipótesis falsables + alcance | Intermedia |
| /research-theory | Marco conceptual + teoría del cambio | Intermedia |
| /research-sources | Recopilación sistemática de fuentes con un registro de búsqueda reejecutable | Intermedia |
| /research-synthesis | Mapa del estado del arte (SOTA) + análisis de lagunas | Intermedia |
| /research-proposal | Objetivos + viabilidad + contingencias + impacto + plan de datos + plan de prerregistro; matriz de la convocatoria de financiación o respuesta de reenvío | Intermedia |
| /research-design | Diseño del estudio + prerregistro | Intermedia |
| /research-experiment | Ejecutar + registrar, de forma reproducible | Intermedia |
| /research-analysis | Resultados + estadística | Intermedia |
| /research-paper | Borrador de artículo de primer nivel | Intermedia |
| /research-review | Crítica con el nivel de una revisión por pares | Intermedia |
| /research-publish | Paquete para el medio de publicación + envío | Intermedia |
| /research-disseminate | Difusión + impacto + archivo FAIR | Final |
El orquestador de flujo de trabajo envuelto /research
conduce estas etapas desde la pregunta en bruto hasta el artículo publicado (él
mismo no es una etapa), y comprueba de forma independiente la salida de cada
etapa antes de que la siguiente se construya sobre ella; --quick ejecuta solo
/research-sources + /research-synthesis para obtener un informe con citas en
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 llevan el rigor a la práctica — comparación justa entre varios métodos, procedencia de los comparadores, un andamiaje de programa de experimentos, un plan de uso de cómputo, un bucle de experimentación autónomo opcional, una puerta de avance basada en la definición de terminado, enmascaramiento con divulgación por etapas, un registro de búsqueda, la asignación del estudio y la planificación de la potencia, la disciplina de análisis, las contingencias del plan, la integridad de las figuras y la planificación de charlas y pósteres — que agregan detalle operativo a los diez mandatos sin ampliarlos.
Secuencia de revisión de auditoría
El orquestador de flujo de trabajo envuelto /audit recorre las once dimensiones siguientes en una única pasada paralela — el equivalente de /plan y /research para la secuencia de auditoría — y sintetiza un único informe de hallazgos, deduplicado y clasificado por severidad (solo informa; la remediación se deriva a /elevate). Cada dimensión también se puede invocar por separado.
El orquestador de flujo de trabajo envuelto /fortress cierra el ciclo que informa /audit: detecta mediante /audit, verifica cada hallazgo, remedia cada hallazgo que sobrevive en la superficie a la que pertenece, vuelve a auditar en un ciclo acotado y somete el resultado a la puerta /release-readiness — el equivalente de /plan y /research para el endurecimiento de producción.
| Comando | Área de calidad |
|---|---|
| /code-review | Calidad del código |
| /code-audit | Corpus de código |
| /security-audit | OWASP / ASVS |
| /perf-audit | Rendimiento |
| /architecture-review | Arquitectura |
| /ux-review | Experiencia de desarrollo |
| /a11y-audit | Accesibilidad |
| /docs-review | Documentación |
| /dependency-audit | Dependencias |
| /supply-chain-audit | Cadena de suministro |
| /threat-model-audit | Modelo de amenazas |
Todos los comandos
Cada comando distribuido, generado a partir de su definición bajo
src/apothem/commands/. Los comandos sin una página escrita a mano reciben una
página generada a partir de la misma definición.
| Command | Summary |
|---|---|
| /plan | Runs the planning pipeline (spec, generate, review, design) with independent verification, confirming at each hand-off; execute stays a manual step the … |
| /plan-spec | Turns free-form prose, notes or rough requirements into a spec-grade _spec/spec.md that keeps the author's wording and settles open questions by inquiry. |
| /plan-generate | Generates a full plan suite (master plan, progress log, decision notes, per-phase files) from a written spec or raw prose. |
| /plan-review | Reads an existing plan suite line by line for fidelity, consistency, completeness and risk, then applies only the revisions the user approves. |
| /plan-design | Writes the architectural design for a reviewed plan suite at _inputs/design.md: components, interfaces, decisions and diagrams. |
| /plan-execute | Use to implement one phase of a reviewed plan suite: reads the phase file and progress notes, verifies prerequisites and review scorecards, implements each … |
| /plan-amend | Changes an existing plan suite without losing resolved decisions, re-deriving only the affected spec, phases and notes. |
| /plan-audit | Audits a plan suite across spec, generate and review, then fixes findings in a loop without per-revision approval until none remain or the cap is hit. |
| /plan-status | Reports plan-suite progress from its tracking files across tasks, phases and artifacts, read-only. |
| /research | Runs the research pipeline from idea to peer-reviewed paper, verifying each stage hand-off and halting before data collection or publication. |
| /research-ideate | Finds a research question from zero by scanning opportunities, gaps, and invalidated hypotheses, then ranking candidates. |
| /research-spec | Frames a research question or notes into a testable spec: falsifiable hypotheses, inclusion and exclusion scope, success metrics. |
| /research-theory | Builds the conceptual framework for a framed research question: theory of change, constructs with operational definitions and a conceptual-model diagram. |
| /research-sources | Collects and screens the literature for a ratified research spec: deduplication, ranking and extraction with provenance. |
| /research-synthesis | Reconciles collected sources into a state-of-the-art map, a literature matrix and a research-gap statement. |
| /research-proposal | Turns a research gap and theoretical framework into a fundable proposal: SMART aims, feasibility, risk register with contingencies, impact pathway, data … |
| /research-design | Turns a synthesized research gap into testable predictions, a study design and a frozen preregistration. |
| /research-experiment | Runs the preregistered study protocol and records raw data with provenance: experiment log, data, and reproducibility manifest (environment, seed, version … |
| /research-analysis | Runs the preregistered statistical analysis on collected data: effect sizes with confidence intervals, multiple-comparison correction, robustness checks, … |
| /research-paper | Assembles a paper draft from the synthesis, study design, and analysis, with every citation checked to resolve. |
| /research-review | Hostile peer review of a paper, from a research suite or a supplied PDF or text: scores novelty, rigor, reproducibility, ethics; ranks revisions. |
| /research-publish | Builds the venue submission package for a reviewed paper: template formatting, cover letter, data and code availability statement, ethics and conflict … |
| /research-disseminate | Plans post-acceptance dissemination and impact: preprint announcement, FAIR data and code archive, altmetrics tracking, rebuttal loop. |
| /audit | Sweeps a repository across all eleven review dimensions in one multi-agent run and returns one verified, severity-ranked report; it never fixes anything. |
| /a11y-audit | Audits rendered pages of a web surface against WCAG 2.2 AA and reports severity-ranked findings per page, without fixing anything. |
| /architecture-review | Reviews a repository against its design document and layer rules, reporting boundary violations, coupling and wiring gaps as ranked findings. |
| /code-audit | Cross-file forensic audit: hidden coupling, type-hint gaps, coverage holes, dead and duplicate code. |
| /code-review | Reviews source files one at a time for readability, naming, complexity, idiom fit and comment quality, and reports severity-ranked findings without editing. |
| /dependency-audit | Audits direct and transitive dependencies for known vulnerabilities, license conflicts, deprecation and loose pins, ranking findings per dependency. |
| /docs-review | Reviews documentation pages for prose clarity, broken links, code-block tags, citations and public-API coverage, reporting severity-ranked findings per page. |
| /perf-audit | Audits an Apothem installation's per-class budgets (hooks, ecosystem verification, conformity gate, tests, agents, shell, lint) with its benchmark drivers, … |
| /security-audit | Audits a repository's security posture: secrets, injection, unsafe deserialization, path traversal, vulnerable dependencies. |
| /supply-chain-audit | Audits a repository's release pipeline: build provenance, artifact signing, SBOM completeness, pinned CI actions and minimum permissions. |
| /threat-model-audit | Threat-models a repository with STRIDE per element and trust boundaries, classifying actors and rating residual risk. |
| /ux-review | Reviews a repository's developer experience from a first-time user's view: CLI ergonomics, error messages, install flow and docs discoverability. |
| /fortress | Hardens a repository end to end: runs the audit sweep, verifies each finding, remediates survivors through the surgical-guard, secret-rotation and vuln-triage … |
| /elevate | Whole-repository elevation: runs the audit sweep, then critiques naming, structure, storytelling and extensibility, remediates what it finds (deletions are … |
| /eval | Runs one evaluation campaign for a language model or prompt: scores each output over a dataset and reports metrics by category plus regressions against a … |
| /freshify | Use when a repository must be made fresh and release-clean: purges caches and stale artifacts, removes legacy narrative and back-references, normalizes file … |
| /github-deploy-fresh | Use when a GitHub repository needs one clean first release on origin/main: a single v0.1.0 release commit, green workflow cards, a first-version changelog, and … |
| /github-deploy-next | Use to run the next release cycle on a GitHub repository: merge ready pull requests, resolve the issues the release addresses, derive the SemVer bump from … |
| /projectify | Builds the Description, Instruction and knowledge files for a chat-app Project or custom assistant through guided questions, within the platform's context … |
| /release-readiness | Pre-release gate sweep: use before shipping a repository to check lint, format, types, tests, dependency and supply-chain risk, visibility surfaces, changelog … |
| /test-suite | Authors and runs behavior-first tests for a repository, triages failures and reports coverage gaps on critical paths. |
| /workflow | Use to run a non-trivial mission as an independent multi-agent workflow: parallel subagents under named return contracts, refute-by-default verification of … |