Commandes du pipeline
Référence des commandes du pipeline Apothem — le flux /plan et le catalogue des commandes d'audit.
Apothem fournit un pipeline /plan conscient de l'architecture, un pipeline
/research à treize étapes, ainsi qu'une séquence d'audit de onze commandes —
donnant à 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 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]Les étapes de planification
Le pipeline est livré sous forme de huit commandes slash de premier rang, une
par étape — chacune invocable de manière indépendante par /plan-<stage>.
| Étape | Rôle | Position |
|---|---|---|
| /plan-spec | Forge — de la prose à la spécification | Initiale |
| /plan-generate | Générateur — de la spécification à la suite de planification | Intermédiaire |
| /plan-review | Auditeur — audit forensique du plan | Intermédiaire |
| /plan-design | Architecte — _inputs/design.md pour les suites à architecture | Porte conditionnelle |
| /plan-execute | Exécuteur — exécution des phases | Terminale |
| /plan-status | Rapporteur — état en lecture seule | Lecture seule |
| /plan-audit | Gardien — enveloppe en boucle fermée de spec → generate → review | Orthogonale (pré-exécution) |
| /plan-amend | Intendant — amendement réentrant d'une suite existante | Réentrant |
/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 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 /plan-execute et /architecture-review
consomment. Si non, la suite revue passe directement à l'exécution.
Le pipeline de recherche
Le pipeline de recherche est livré sous forme de treize commandes slash de
premier rang, une par étape — chacune invocable de manière indépendante par
/research-<stage>, enchaînées par une Porte de Séquence et un Manifeste de
Transfert, sous dix mandats de rigueur (sources autoritatives, reproductibilité,
falsifiabilité, intégrité des citations, préenregistrement, éthique / conflits,
rigueur statistique, science ouverte / FAIR, conformité aux lignes directrices
de reporting, 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| Étape | Rôle | Position |
|---|---|---|
| /research-ideate | Formuler le problème — questions candidates à partir d'une graine de domaine | Initiale |
| /research-spec | Cadrer la question — hypothèses falsifiables + portée | Intermédiaire |
| /research-theory | Cadre conceptuel + théorie du changement | Intermédiaire |
| /research-sources | Collecte systématique des sources | Intermédiaire |
| /research-synthesis | Cartographie de l'état de l'art + analyse des lacunes | Intermédiaire |
| /research-proposal | Objectifs + faisabilité + impact + plan de préenregistrement | Intermédiaire |
| /research-design | Conception de l'étude + préenregistrement | Intermédiaire |
| /research-experiment | Exécuter + enregistrer, reproductible | Intermédiaire |
| /research-analysis | Résultats + statistiques | Intermédiaire |
| /research-paper | Brouillon d'article de premier plan | Intermédiaire |
| /research-review | Critique de niveau évaluation par les pairs | Intermédiaire |
| /research-publish | Dossier pour la revue + soumission | Intermédiaire |
| /research-disseminate | Diffusion + impact + archivage FAIR | Terminale |
L'orchestrateur de flux de travail enveloppé /research pilote ces étapes de la
question brute à l'article publié (il n'est pas lui-même une étape), vérifiant
indépendamment la sortie de chaque étape avant que la suivante ne s'appuie
dessus ; --quick n'exécute que /research-sources + /research-synthesis pour
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 d'opérationnalisation de la rigueur — comparaison multi-méthodes équitable, provenance des comparateurs, une charpente de programme d'expérimentation, un plan d'utilisation de calcul, une boucle d'expérimentation autonome optionnelle, une porte d'avancement de définition-du-fait-accompli, et l'aveuglement avec divulgation par étapes — qui ajoutent du détail opérationnel aux dix mandats sans les étendre.
Séquence d'audit
L'orchestrateur de flux de travail enveloppé /audit balaie les onze dimensions ci-dessous en une seule passe parallèle — l'analogue audit-forteresse de /plan et /research — synthétisant un unique rapport de constats dédupliqué et trié par sévérité (rapport seul ; la remédiation est routée vers /elevate). Chaque dimension est aussi invocable individuellement.
L'orchestrateur de flux de travail enveloppé /fortress ferme la boucle que /audit rapporte : il détecte via /audit, vérifie chaque constat, remédie à chaque survivant sur sa surface propriétaire, réaudite dans une boucle bornée et passe le résultat par la porte /release-readiness — l'analogue de durcissement de production de /plan et /research.
| Commande | Domaine de qualité |
|---|---|
| /code-review | Qualité du code |
| /code-audit | Corpus de code |
| /security-audit | OWASP / ASVS |
| /perf-audit | Performance |
| /architecture-review | Architecture |
| /ux-review | Expérience développeur |
| /a11y-audit | Accessibilité |
| /docs-review | Documentation |
| /dependency-audit | Dépendances |
| /supply-chain-audit | Chaîne d'approvisionnement |
| /threat-model-audit | Modèle de menaces |
Plateformes
Systèmes d'exploitation, shells et scripts d'installation pris en charge pour Apothem, plus le prérequis Python système pour le runtime autonome.
/plan-spec
/plan-spec — Affine de la prose libre ou des notes brutes en une spécification `_spec/spec.md` de niveau spec prête pour `/plan-generate`.