Comandos do pipeline

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

Visão geral do pipelineCopy Anchor Link

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]

Os estágios de planejamentoCopy Anchor Link

O pipeline é distribuído como oito slash commands de primeira classe, um por estágio — cada um invocável de forma independente como /plan-<stage>. O orquestrador /plan os conduz de uma missão até uma suíte executada.

/plan-audit é ortogonal ao fluxo linear, e não um estágio dentro dele. Ele envolve /plan-spec → /plan-generate → /plan-review como um único ciclo fechado, executa somente os estágios anteriores que faltam, corrige ativamente os achados e deixa a suíte pronta para /plan-execute. Ele é distinto da sequência de revisão de auditoria abaixo, que audita uma base de código executada, e não uma suíte de planejamento.

/plan-design não é uma cerimônia universal. /plan-review classifica se a suíte altera superfícies que afetam a 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 pesquisaCopy Anchor Link

O pipeline de pesquisa é distribuído 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, falseabilidade, integridade das citações, pré-registro, ética / conflitos, rigor estatístico, ciência aberta / FAIR, conformidade com diretrizes de relato, 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

O orquestrador de fluxo de trabalho encapsulado /research conduz esses estágios da questão bruta até o artigo publicado (ele próprio não é um estágio), verificando a saída de cada estágio de forma independente antes que o estágio seguinte se apoie nela; --quick executa somente /research-sources + /research-synthesis, para um relatório com citações em uma única passagem.

Os estágios empíricos (fontes, desenho, 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 dos comparadores, uma estrutura de programa de experimentos, um plano de utilização de computação, um ciclo autônomo de experimentos opcional (opt-in), um portão de avanço baseado na definição de pronto, cegamento com divulgação em etapas, um registro de busca, alocação de estudo e planejamento de poder, disciplina de análise, contingências do plano, integridade de figuras e planejamento de palestras e pôsteres — que acrescentam detalhe operacional aos dez mandatos sem ampliá-los.

Sequência de revisão de auditoriaCopy Anchor Link

O orquestrador de fluxo de trabalho encapsulado /audit varre todas as onze dimensões abaixo em uma única passagem paralela — o análogo, na fortaleza de auditoria, de /plan e /research — e sintetiza um único relatório de achados deduplicado e triado por severidade (somente relatório; a remediação é encaminhada para /elevate). Cada dimensão também pode ser invocada individualmente.

O orquestrador de fluxo de trabalho encapsulado /fortress fecha o ciclo que o /audit relata: ele detecta por meio do /audit, verifica cada achado, corrige cada achado remanescente na superfície que o detém, audita novamente em um ciclo limitado e submete o resultado ao portão /release-readiness — o análogo de blindagem para produção de /plan e /research.

Todos os comandosCopy Anchor Link

Todos os comandos distribuídos, gerados a partir da definição de cada um sob src/apothem/commands/. Os comandos sem uma página escrita à mão recebem uma página gerada a partir da mesma definição.