Skip to content
Apothem
Comandos do pipeline

Comandos do pipeline

Referência de comandos do pipeline do Apothem — o fluxo /plan e o catálogo de comandos de auditoria.

O Apothem traz um pipeline /plan consciente da arquitetura, um pipeline /research de treze estágios, além de uma sequência de auditoria de onze comandos — dando a cada projeto um caminho estruturado da prosa bruta até código de nível de produção revisado em múltiplos eixos, e de uma ideia bruta até um artigo disseminado e revisado por pares.

Visão geral do 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]

Os estágios de planejamento

O pipeline é entregue como oito slash commands de primeira classe, um por estágio — cada um invocável de forma independente como /plan-<stage>.

EstágioPapelPosição
/plan-specForja — da prosa à especificaçãoInicial
/plan-generateGerador — da especificação à suíte de planoIntermediário
/plan-reviewAuditor — auditoria forense do planoIntermediário
/plan-designArquiteto — _inputs/design.md para suítes com arquiteturaPortão condicional
/plan-executeExecutor — execução de fasesTerminal
/plan-statusRelator — status somente leituraSomente leitura
/plan-auditGuardião — envoltório de ciclo fechado de spec → generate → reviewOrtogonal (pré-execução)
/plan-amendAdministrador — emenda reentrante de uma suíte existenteReentrante

/plan-audit é ortogonal ao fluxo linear, não um estágio dentro dele. Ele envolve /plan-spec → /plan-generate → /plan-review como um único ciclo fechado, executa apenas os estágios anteriores ausentes, remedia ativamente as descobertas e deixa a suíte pronta para /plan-execute. É distinto da sequência de auditoria abaixo, que audita uma base de código já executada em vez de uma suíte de plano.

/plan-design não é uma cerimônia universal. /plan-review classifica se a suíte altera superfícies com arquitetura. Se sim, /plan-design emite o rastro de design que /plan-execute e /architecture-review consomem. Se não, a suíte revisada segue diretamente para a execução.

O pipeline de pesquisa

O pipeline de pesquisa é entregue como treze slash commands de primeira classe, um por estágio — cada um invocável de forma independente como /research-<stage>, encadeados por um Portão de Sequência e um Manifesto de Repasse, sob dez mandatos de rigor (fontes autoritativas, reprodutibilidade, falsificabilidade, integridade de citações, pré-registro, ética / conflitos, rigor estatístico, ciência aberta / FAIR, conformidade com diretrizes de reporte, fundamentação 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
EstágioPapelPosição
/research-ideateFormular o problema — questões candidatas a partir de uma semente de domínioInicial
/research-specEnquadrar a questão — hipóteses falsificáveis + escopoIntermediário
/research-theoryArcabouço conceitual + teoria da mudançaIntermediário
/research-sourcesColeta sistemática de fontesIntermediário
/research-synthesisMapa do SOTA + análise de lacunasIntermediário
/research-proposalObjetivos + viabilidade + impacto + plano de pré-registroIntermediário
/research-designDesign do estudo + pré-registroIntermediário
/research-experimentExecutar + registrar, reproduzívelIntermediário
/research-analysisResultados + estatísticaIntermediário
/research-paperRascunho de artigo de alto nívelIntermediário
/research-reviewCrítica de nível revisão por paresIntermediário
/research-publishPacote para o veículo + submissãoIntermediário
/research-disseminateDisseminação + impacto + arquivamento FAIRTerminal

O orquestrador de fluxo de trabalho encapsulado /research impulsiona esses estágios da questão bruta ao artigo publicado (ele próprio não é um estágio), verificando a saída de cada estágio de forma independente antes que o próximo estágio se baseie nela; --quick executa apenas /research-sources + /research-synthesis para um relatório citado de passagem única.

Os estágios empíricos (fontes, projeto, experimento, análise) e os estágios de redação (artigo, revisão, publicação, disseminação) recorrem, além disso, a superfícies que operacionalizam o rigor — comparação multimétodo justa, procedência de comparadores, um andaime de programa de experimentos, um plano de utilização de computação, um laço autônomo de experimento opcional, um portão de avanço com definição de pronto, e cegamento com divulgação em estágios — que adicionam detalhe operacional aos dez mandatos sem estendê-los.

Sequência de auditoria

O orquestrador de fluxo de trabalho encapsulado /audit varre todas as onze dimensões abaixo como uma única passagem paralela — o análogo de auditoria-fortaleza de /plan e /research — sintetizando um único relatório de descobertas deduplicado e classificado por severidade (somente reporte; a remediação é roteada para /elevate). Cada dimensão também é invocável individualmente.

O orquestrador de fluxo de trabalho encapsulado /fortress fecha o ciclo que /audit reporta: ele detecta via /audit, verifica cada descoberta, remedia cada sobrevivente em sua superfície proprietária, reaudita em um ciclo limitado e passa o resultado pelo portão /release-readiness — o análogo de endurecimento de produção de /plan e /research.

ComandoÁrea de qualidade
/code-reviewQualidade do código
/code-auditCorpus de código
/security-auditOWASP / ASVS
/perf-auditDesempenho
/architecture-reviewArquitetura
/ux-reviewExperiência do desenvolvedor
/a11y-auditAcessibilidade
/docs-reviewDocumentação
/dependency-auditDependências
/supply-chain-auditCadeia de suprimentos
/threat-model-auditModelo de ameaças

On this page