Architecture v2: branch-based pipelines, five phases, multilane

[luisherranz]

Closes #177.

What this is

The full architecture v2 rewrite of the Radical Pipelines skill, written as if the previous architecture never existed (new pipelines only — no migration paths). Every decision was locked in the planning session and recorded in architecture-plan.md (first commit of this branch); GLOSSARY.md is the new canonical vocabulary.

The model in one paragraph

A pipeline is a chain of run branches (<branch-base>[_v<N>][_rev-<N>-<desc>], v1/base implicit); there is no pipeline-level branch — the latest run branch is the tip that merges. Lane branches carry multilane spec/design work (never merged, read by consolidators, kept as the permanent record). Forks branch at cut commits — no copying; inherited history carries the work itself. Diff bases are derived (merge-base + the start commit in pipeline.md), never captured. Worktrees are raw git worktree, created only by the orchestrator, which never changes directory; every agent gets Worktree path + Branch anchors and verifies before writing/committing. Phases are Intent → Spec → Design doc → Build → Document: the plans folded into Build/Document as inner gates, spec/design run as N consolidated lanes (N=1 = today's flow, degenerate case), and phases are self-sizing — depth follows the research record, gated by reviewers.

How it was built (one commit per work package)

1. Plan doc → 2. Glossary → 3. Pkg 1 core model (SKILL.md, pipeline-versioning.md, both workflows) → 4.–9. Pkgs 2–7 in parallel with disjoint file ownership (operations · conventions/passing/monitoring/guardrails · spec phase · design phase · build phase · document phase) → 10. integration fixes for the cross-package seams → 11. Pkg 8 README, .rp.md (now drift-free: exact convention names, artifacts-in-repo, npm test guardrail), changeset → 12. coherence pass: three adversarial review lenses over the merged whole, 51 findings triaged, 21 fixes applied (incl. one triple-confirmed blocker in the reviewers' diff-base derivation).

Issues resolved by this rewrite

Closes #176, closes #175, closes #173, closes #172, closes #160, closes #153, closes #104, closes #87, closes #76.

The branch also removes Pi as a supported agentic coding tool entirely, resolving the Pi unbundling issues by full removal: closes #140, closes #141, closes #142, closes #143.

Review pointers

• Start with GLOSSARY.md, then skills/radical-pipelines/reference/pipeline-versioning.md — everything else hangs off those two.
• architecture-plan.md records every decision, the rejected alternatives, and the parked workstreams (WS4 blocker protocol Rethink the blocker protocol: taxonomy, backtracking policy, single definition #178, WS5 behavior verification Review behavior verification end to end #179, WS6 Integrate Design the Integrate phase: the pipeline tail #180).
• Known deferred items (deliberate): the build/document phase files share near-identical batch machinery (extraction candidate); Linear workflow statuses need renaming to 3 - Build/4 - Document (operational).
• A set of small, independent follow-up PRs based on this branch addresses the still-valid open issues (Orchestrator must relay gate results to agents verbatim, not interpreted #157, Bound rejection loops with a per-phase iteration budget #174, Always confirm the revision intent before starting a revision run #171, Analysts can let an unverified premise become load-bearing rationale (spec + design) #170, Reviewers should not approve artifacts that defer a load-bearing risk on an unverified hedge #155, Gate failures must not be dismissed as environmental without base-ref proof #156, Search for related/duplicate issues before creating a new issue #103, Don't start a pipeline for an issue whose dependencies aren't closed yet #116, Setup should write only defined conventions into .rp.md, not arbitrary setup-time discoveries #100, Document the upstream write-access assumption in artifacts-in-fork mode #94).

🤖 Generated with Claude Code

https://claude.ai/code/session_01N5uKXZg1pBVWgk1882WF9P