Skip to Content

← All archived runs

Run: docs-pipeline-stage-drift

run.md

Run: docs-pipeline-stage-drift

  • lane: chore
  • branch: claude/pipeline-docs-update-f1dvmg
  • pr: #775

lane/output/notes.md

Chore: docs-pipeline-stage-drift

  • invariant: no behaviour change — documentation only. The apps/docs development-workflow page now describes the pipeline that actually exists; nothing in pipeline/, .claude/, CI or app code moves.

  • change: apps/docs/app/technical/development/workflow/page.mdx: the page still documented the pre-expansion three-stage pipeline (define → build → release). Corrected against pipeline/CONTEXT.md and .claude/skills/pipeline/SKILL.md:

    • the stage table is now the six stages — scope → design → define → build → verify → ship — with the approve substage nested under Scope, each row carrying its real gate (only Spec approved and Ready to merge are PR checkboxes; the others are conversational), plus a short paragraph on who owns which gate;
    • a new Fast lanes subsection for bug / tweak / chore — one PR, merge gate only;
    • the deprecated /pipeline release <slug> is gone from the table and from the quick-reference command block, which now lists all ten subcommands;
    • the label progression reads stage:define → stage:build → stage:verify → stage:ship, and notes that stage:* is derived from which run outputs exist;
    • the spec path is pipeline/runs/<slug>/03_define/output/spec.md, not 01_define/;
    • "Code review and merge (the Release stage)" is now "(the Verify and Ship stages)", split into what each stage does, pointing at 05_verify/CONTEXT.md and 06_ship/CONTEXT.md — the old pipeline/stages/03_release/CONTEXT.md path does not exist;
    • the intro prose says "the Build, Verify and Ship stages"; Branch management and Commits/PRs say Ship, not Release;
    • the investor-email line is now the ship note to #product-update, sent by ship-note.yaml on the merge with no deploy-status gate (matching _shared/github.md → Ship step 4).

  • change: apps/docs/app/technical/development/automation-offload/page.mdx: checked, no edit needed. It already refers to 04_build / 05_verify / 06_ship; its two 03_release mentions are deliberate legacy-numbering notes (§2's label table and the "was an agent action" summary row), which remain accurate.

  • change: apps/docs/app/reports/** deleted entirely (27 files) at the owner's request — the retired brainstorm pass's archive, no longer needed. It was already hidden from the docs nav and had no inbound links from any app; git history is the record. Removed with it:

    • apps/docs/app/_meta.ts: the reports: { display: "hidden" } entry and its comment;
    • pipeline/_shared/knowledge-map.md and pipeline/CONTEXT.md: the "legacy, off-limits" notes, rewritten to say the section no longer exists — a stage told to avoid a folder that is gone is the next stale rule.

    Note this removed the reports/platform/** pages too (BRD contents, lead ingestion, platform hardening, SLA timers, funnel losses, and the rest), not only reports/pipeline/**.

  • rollback: git revert the commits — docs and pipeline prose only, no code, no data. The deleted reports are recoverable from git history at the pre-revert commit.

Left alone deliberately

  • The same workflow page still documents pnpm dev, pnpm packages:dev, pnpm marketing:dev, pnpm docs:dev and pnpm storybook:dev, which no longer exist — CLAUDE.md records that web:dev is the only dev script and that turbo.json defines no dev task. That is real staleness on the same page, but a different subject with a different fix (either restore the turbo dev task or rewrite the daily-workflow sections around Vercel previews). Keeping this PR single-purpose; worth its own chore.