Commandes du pipeline

Apothem fournit un pipeline /plan conscient de l'architecture, un pipeline /research à treize étapes, ainsi qu'une séquence d'audit de onze commandes — ce qui donne à chaque projet un parcours structuré de la prose brute jusqu'à du code de niveau production revu sur plusieurs axes, et d'une idée brute jusqu'à un article diffusé et évalué par les pairs.

Vue d'ensemble du 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]

Les étapes de planificationCopy Anchor Link

Le pipeline est livré sous forme de huit commandes slash de premier rang, une par étape — chacune invocable indépendamment sous la forme /plan-<stage>. L'orchestrateur /plan les pilote d'une mission jusqu'à une suite exécutée.

/plan-audit est orthogonal au flux linéaire, et non une étape en son sein. Il enveloppe /plan-spec → /plan-generate → /plan-review en une seule boucle fermée, n'exécute que les étapes amont manquantes, remédie activement aux constats et laisse la suite prête pour /plan-execute. Il est distinct de la séquence de revue d'audit ci-dessous, qui audite une base de code exécutée plutôt qu'une suite de planification.

/plan-design n'est pas une cérémonie universelle. /plan-review détermine si la suite modifie des surfaces porteuses d'architecture. Si oui, /plan-design émet la trace de conception que consomment /plan-execute et /architecture-review. Si non, la suite revue passe directement à l'exécution.

Le pipeline de rechercheCopy Anchor Link

Le pipeline de recherche est livré sous forme de treize commandes slash de premier rang, une par étape — chacune invocable indépendamment sous la forme /research-<stage>, enchaînées par un Portail de séquence et un Manifeste de transfert, sous dix mandats de rigueur (sources faisant autorité, reproductibilité, falsifiabilité, intégrité des citations, préenregistrement, éthique / conflits d'intérêts, rigueur statistique, science ouverte / FAIR, conformité aux lignes directrices de rédaction, ancrage théorique / impact).

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

L'orchestrateur de flux de travail enveloppé /research pilote ces étapes de la question brute jusqu'à l'article publié (il n'est pas lui-même une étape), en vérifiant indépendamment la sortie de chaque étape avant que l'étape suivante ne s'appuie dessus ; --quick n'exécute que /research-sources + /research-synthesis pour produire un rapport cité en une seule passe.

Les étapes empiriques (sources, conception, expérience, analyse) et les étapes de rédaction (article, évaluation, publication, diffusion) s'appuient en outre sur des surfaces de rigueur opérationnelles — comparaison multi-méthodes équitable, provenance des comparateurs, une structure de programme d'expérimentation, un plan d'utilisation du calcul, une boucle d'expérimentation autonome optionnelle, un portail d'avancement fondé sur la définition de « fini », l'aveuglement avec divulgation par étapes, un registre de recherche, l'allocation de l'étude et la planification de la puissance, la discipline d'analyse, les plans de contingence, l'intégrité des figures et la planification des présentations et des posters — qui ajoutent du détail opérationnel aux dix mandats sans les étendre.

Séquence de revue d'auditCopy Anchor Link

L'orchestrateur de flux de travail enveloppé /audit balaie les onze dimensions ci-dessous en une seule passe parallèle — l'analogue, pour la forteresse d'audit, de /plan et /research — et synthétise un unique rapport de constats dédupliqué et trié par sévérité (rapport uniquement ; la remédiation est confiée à /elevate). Chaque dimension est aussi invocable individuellement.

L'orchestrateur de flux de travail enveloppé /fortress ferme la boucle dont /audit rend compte : il détecte via /audit, vérifie chaque constat, remédie à chaque constat retenu sur la surface dont il relève, réaudite dans une boucle bornée et soumet le résultat au portail /release-readiness — l'analogue, pour le durcissement de production, de /plan et /research.

Toutes les commandesCopy Anchor Link

Chaque commande livrée, générée à partir de sa définition sous src/apothem/commands/. Les commandes sans page rédigée à la main reçoivent une page générée à partir de la même définition.