docs(reference): clarify five-phase pipeline vs PII review gate (#127)
Reconciles a contradiction between this file (which previously said
"6 public phases") and README.md / docs/explanation/architecture.md /
docs/tutorials/* (which all say "5 public phases"). The other docs are
right: only five phases produce versioned markdown snapshots. PII
Review is a permission gate that runs before any `_step_*` method
executes — it is rendered as a stage indicator in the viewer for user
visibility, but it is not a versioned transformation.
Updates:
- Opening paragraph explicitly distinguishes the five versioned
conversion phases from the PII Review gate.
- Public phases table renumbered: PII Review labelled as "(gate)"
without a phase number; Extraction → Assembly numbered 1–5.
- Heading "Public phases → internal steps" → "Public stages →
internal steps" so the umbrella term covers both the gate and the
numbered phases.
No code changes, no behaviour change. Documentation only.
Co-authored-by: Claude Opus 4.7 (1M context) <noreply@anthropic.com>