Команды конвейера

Apothem поставляет учитывающий архитектуру конвейер /plan, тринадцатиэтапный конвейер /research, а также последовательность аудита из одиннадцати команд — это даёт каждому проекту структурированный путь от сырой прозы к коду продакшен-уровня, проверенному по множеству осей, и от сырой идеи к распространённой статье, прошедшей рецензирование.

Обзор конвейераCopy 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]

Этапы планированияCopy Anchor Link

Конвейер поставляется в виде восьми полноценных слэш-команд, по одной на этап; каждую можно вызвать независимо как /plan-<stage>. Оркестратор /plan ведёт их от миссии до выполненного набора планов.

/plan-audit ортогонален линейному потоку и не является этапом внутри него. Он оборачивает /plan-spec → /plan-generate → /plan-review в единый замкнутый цикл, запускает только недостающие предшествующие этапы, активно устраняет находки и оставляет набор планов готовым к /plan-execute. Он отличается от описанной ниже последовательности аудита, которая проверяет выполненную кодовую базу, а не набор планов.

/plan-design — не универсальная церемония. /plan-review определяет, изменяет ли набор планов поверхности, затрагивающие архитектуру. Если да, /plan-design выпускает трассу проектирования, которую используют /plan-execute и /architecture-review. Если нет, проверенный набор планов переходит непосредственно к выполнению.

Исследовательский конвейерCopy Anchor Link

Исследовательский конвейер поставляется в виде тринадцати полноценных слэш-команд, по одной на этап; каждую можно вызвать независимо как /research-<stage>, а связывают их Шлюз последовательности и Манифест передачи, под действием десяти мандатов строгости (авторитетные источники, воспроизводимость, фальсифицируемость, целостность цитирования, предрегистрация, этика / конфликты интересов, статистическая строгость, открытая наука / FAIR, соответствие руководствам по отчётности, теоретическая обоснованность / влияние).

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

Оркестратор /research в виде обёрнутого рабочего процесса ведёт эти этапы от сырого вопроса до опубликованной статьи (сам он этапом не является), независимо проверяя результат каждого этапа, прежде чем следующий этап начнёт на нём строиться; --quick запускает только /research-sources + /research-synthesis для однократного отчёта с цитатами.

Эмпирические этапы (источники, проектирование, эксперимент, анализ) и этапы написания (статья, рецензирование, публикация, распространение) дополнительно опираются на поверхности, операционализирующие строгость, — честное сравнение нескольких методов, происхождение базовых методов для сравнения, каркас программы экспериментов, план использования вычислительных ресурсов, включаемый по желанию автономный цикл экспериментов, шлюз продвижения по критериям готовности (definition of done), ослепление с поэтапным раскрытием, запись поиска, планирование распределения в исследовании и мощности, дисциплина анализа, запасные планы, целостность рисунков и планирование докладов и постеров, — которые добавляют операционные детали к десяти мандатам, не расширяя их.

Последовательность аудитаCopy Anchor Link

Оркестратор /audit в виде обёрнутого рабочего процесса проходит по всем одиннадцати измерениям ниже за один параллельный проход — аналог /plan и /research для последовательности аудиторских проверок — и синтезирует один дедуплицированный отчёт о находках, отсортированный по серьёзности (только отчёт; устранение передаётся в /elevate). Каждое измерение можно также вызвать отдельно.

Оркестратор /fortress в виде обёрнутого рабочего процесса замыкает цикл, о результатах которого сообщает /audit: он выявляет проблемы через /audit, проверяет каждую находку, устраняет каждую подтвердившуюся находку на поверхности, которой она принадлежит, повторяет аудит в ограниченном цикле и пропускает результат через шлюз /release-readiness — аналог /plan и /research для упрочнения к продакшену.

Все командыCopy Anchor Link

Каждая поставляемая команда, сгенерированная из её определения в src/apothem/commands/. Команды без написанной вручную страницы получают страницу, сгенерированную из того же определения.