fix(ship-feature): doc-sync + doc-commit before FINISH — fixes docs stranded outside PR

Reorder: DOC SYNC moves from STEP 9 (post-FINISH) to STEP 8 (pre-FINISH); FINISH → 9. doc-syncer PATCHES public docs but never commits them, and finishing-a-development-branch integrates only committed history — so on the push+PR path the patched docs were uncommitted and never reached the PR (twin of the capitalize PR-strand fix, BDR-034). STEP 8 now chains lib/doc-commit.md: surgical commit of the PATCHED_FILES, never git add -A, never .claude/ (rc 4 loud anomaly), no-op if nothing patched. Twin-chantier HTML comment removed — the twin is fixed, 'deferred' is now false.

Ref-coherence (part of the reorder — a swap flips meanings, it doesn't just drop a number): STEP 7 capitalize body refs 'STEP 8 FINISH' → 'STEP 9 FINISH' (lines 159, 189). README.md pipeline illustration completed — STEP 4-7 ends in capitalize (not 'finish'), STEP 8 = sync README, STEP 9 = finish; it had been silently wrong since e8eff7e moved DOC SYNC 8→9 without updating it, so completed rather than left accidentally-correct. Historical records (BDR-034, journal, CHANGELOG) left as-is — they said 'STEP 8' when it was true; append-only.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Ho5EQCFTSvYamuRtVZpp2d

README.md

@@ -149,8 +149,9 @@ cd my-existing-project/
 # → STEP 0: plugin check
 # → STEP 1-2: brainstorm + plan (superpowers)
 # → STEP 3: validation gate — user approval required
-# → STEP 4-7: implement (TDD) → review → finish
-# → STEP 8: sync README
+# → STEP 4-7: implement (TDD) → review → capitalize (memory)
+# → STEP 8: sync README (doc-sync)
+# → STEP 9: finish (merge / PR)
 ```
 
 For small features (1-5 files), use `/feat` instead — no orchestration overhead.