docs(wedge): PR 4 — Phase C ARCHIVE (19 pre-wedge docs to docs/archive/ + Coherence §3 markers) by jukka-matti · Pull Request #194 · jukka-matti/variscout

jukka-matti · 2026-05-17T15:55:01Z

Summary

Phase C ARCHIVE pass: move 19 superseded pre-wedge docs to docs/archive/<subfolder>/ with supersession headers + add section-level SUPERSEDED markers to the Coherence design spec §3. 5 commits, ~50 files touched (19 moves + Coherence + ~30 inbound link fixes), docs-only. Per feedback_consolidation_replace_not_umbrella: archive over delete (preserve institutional knowledge).

What moved

Group 1 — 8 pre-wedge specs → docs/archive/specs/

response-path-system-v1-design (5-path RPS, reduced to 3 in V1)
improvement-project-v1-design (already marked SUPERSEDED)
canvas-migration-design (pre-wedge canvas era)
variscout-vision-design (pre-wedge full vision)
consolidated-method-and-surface-overview-design
knowledge-tab-design (KB deferred to VariScout Process)
holistic-evaluation-vqi
adr049-evaluation-report

Group 2 — 8 pre-wedge plans → docs/archive/plans/ (new subfolder)

2026-05-14 projects-tab-foundation (4-stage, superseded by wedge 3-stage)
2026-05-09 response-path-system-v1 (5-path implementation)
2026-05-08 improvement-project-v1 (impl of SUPERSEDED spec)
2026-05-07 canvas-pr8-8a mode-aware-ctas (5-path CTA wiring)
2026-05-06 data-flow-foundation-f1-f2 (pre-wedge data flow)
2026-05-06 data-flow-foundation-f1-f2-audit
2026-05-06 canvas-pr4c-pr6-followup (pre-wedge canvas)
2026-04-27 actionable-current-process-state-panel

Group 3 — 1 ADR → docs/archive/adrs/

adr-033-pricing-simplification (superseded by ADR-082 single-€120 SKU)

Group 4 — 2 active docs → docs/archive/{products,technical}/

docs/08-products/azure/pricing-tiers.md → docs/archive/products/ (two-tier pricing obsolete)
docs/05-technical/architecture/tier-gating.md → docs/archive/technical/ (entire tier-gating API obsolete; replaced by canAccess/projectMembership)

Group 5 — Coherence design spec §3 markers (NOT archived; in-place edit)

docs/superpowers/specs/2026-05-14-variscout-coherence-design.md §3 "Persona model (Sessions A + C locked)" — added section-level SUPERSEDED blockquote pointing to wedge spec §3.5 + variscout-process/four-personas.md + membership-philosophy.md. The substantive design heritage (visual identity, motion, a11y, vocabulary locks, IA principles, surface model) stays in active /superpowers/specs/ for traceability.

Inbound link fixups (handled per-group)

Each group's commit included inline updates to active docs that linked to the moved files:

Group 3: 9 files (adr-007, adr-019, adr-082, index.md, market-analysis.md, business-bible.md, 08-products/azure/index.md, pricing-tiers.md, tier-gating.md)
Group 4: 5 files (adr-007, technical/architecture/index.md, archive/adrs/adr-006, 08-products/azure/index.md, arm-template.md)

Pre-commit dead-link + orphaned-file + cross-reference checks all clean.

Audit false positives skipped

The Phase C audit (PR 2 triage table) listed 17 specs in Group 1, but 9 were already in docs/archive/specs/ from prior cleanup work. The implementer correctly skipped those — net actual moves: 8 specs (not 17). Same audit-false-positive pattern noted for the web-first-deployment-design specs.

Plan + spec

Phase C plan: docs/superpowers/plans/2026-05-17-phase-c-doc-audit.md
Triage table embedded in plan (PR feat(wedge): PR-WV1-7 — Sponsor ACL wiring + ADR-059 dead-code cleanup #190 baseline)

Test plan

All 19 files in new archive locations (verified via diff stat)
Coherence §3 section-level SUPERSEDED marker present
pnpm docs:check green (no broken cross-refs, no orphans, frontmatter clean)
Inbound link updates clean

Next PRs in Phase C

PR 3 (AMEND): ~115-155 active doc files needing surgical edits across 8 stale-pattern batches
PR 5 (DELETE): 3 items (architecture.md §12 Teams SDK section + 2 "10 personas" line-level legacy refs)

🤖 Generated with Claude Code

Moves 8 specs superseded by the 2026-05-16 wedge pivot to docs/archive/specs/. Each file receives status:archived in frontmatter + a blockquote ARCHIVED header with the specific supersession reason + institutional-knowledge preservation note. Files moved: - 2026-05-09-response-path-system-v1-design.md (5-path RPS → wedge 3-path reduction) - 2026-05-08-improvement-project-v1-design.md (superseded by RPS V1 then wedge) - 2026-05-04-canvas-migration-design.md (migration completed; canvas is live substrate) - 2026-05-03-variscout-vision-design.md (5-path + multi-Hub → wedge 3-path + single-Hub) - 2026-04-29-consolidated-method-and-surface-overview-design.md (pre-wedge state-of-union) - 2026-04-02-knowledge-tab-design.md (tier-gating retires; scope narrows to project-level) - 2026-03-30-holistic-evaluation-vqi.md (pre-wedge holistic evaluation) - 2026-03-24-adr049-evaluation-report.md (point-in-time PR review, pre-wedge surface model) Inbound links fixed in 17 files (ADRs 059/068/070/078/080/081, decision-log, roadmap, investigations, methodology, variscout-process measurement-system + scope-line, 4 plan files, 4 active spec files, specs/index.md). 9 additional files (items 6 and 10-17 in the audit list) were already in docs/archive/specs/ from earlier work — no action needed. Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Moves 8 implementation plans superseded by the 2026-05-16 wedge pivot to docs/archive/plans/. Each file receives status:archived in frontmatter + an ARCHIVED blockquote header with specific supersession reason. Files moved: - 2026-05-14-projects-tab-foundation.md (4-stage IP detail; amended by wedge) - 2026-05-09-response-path-system-v1.md (5-path RPS; delivered, wedge reduced to 3) - 2026-05-08-improvement-project-v1.md (superseded by RPS V1 system-level plan) - 2026-05-07-canvas-pr8-8a-mode-aware-ctas.md (5-path tier-gating; wedge retired it) - 2026-05-06-data-flow-foundation-f1-f2.md (delivered; pre-wedge scope assumptions) - 2026-05-06-data-flow-foundation-f1-f2-audit.md (audit companion to f1-f2 plan) - 2026-05-06-canvas-pr4c-pr6-followup.md (delivered; pre-wedge retrospective) - 2026-04-27-actionable-current-process-state-panel-plan.md (delivered PRs #98/#99) Inbound links fixed in 11 files (adr-077, adr-080, decision-log, roadmap, f3-5-ingestion plan, f3-6-azure plan, projects-tab-launchpad-cascade plan, canvas-pr8-master plan × 2 edits, projects-tab-design spec, projects-tab-launchpad). Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…ded by ADR-082)

…U supersedes)

…ngle-persona)

vercel · 2026-05-17T15:55:05Z

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
mean-beoynd-lite-pwa	Ready	Preview, Comment	May 17, 2026 4:09pm
variscout_website	Ready	Preview, Comment	May 17, 2026 4:09pm

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

…livered agent-docs specs (#196) PR 5 of the Phase C arc. Original audit triaged 3 items for DELETE: 1. ~~architecture.md §12 Teams SDK section~~ — REMOVED FROM SCOPE: PR 3 Batch D rewrote §12 into "Teams Static Tab (Azure App)" as a current V1 reference (per final-review finding on #195). 2. agent-docs-architecture-design.md (delivered): "10 personas × 14 use cases × 3 tiers" complexity claim was pre-wedge; live USER-JOURNEYS.md was rewritten in Phase A. 3. agent-docs-architecture-phase1-foundation.md (delivered): Task 7's USER-JOURNEYS.md draft (10 personas) was pre-wedge. Both files describe a delivered architecture (5-layer model, skills, Tier 1/2 narrative split) that remains in force — line-delete would break spec coherence. Applied wedge supersession callout at top of each instead, preserving 10-persona content as historical record. Canonical persona artifact is now docs/01-vision/variscout-process/four-personas.md (named-future). Closes Phase C doc cleanup arc (PRs #191, #192, #193, #194, #195, this).

jukka-matti and others added 5 commits May 17, 2026 18:39

docs(wedge): archive Group 3 — ADR-033 to docs/archive/adrs/ (superse…

f8b6a45

…ded by ADR-082)

docs(wedge): archive Group 4 — pricing-tiers + tier-gating (single-SK…

1d2d910

…U supersedes)

docs(wedge): add §3 SUPERSEDED marker to Coherence design spec (V1 si…

274bed7

…ngle-persona)

vercel Bot deployed to Preview – mean-beoynd-lite-pwa May 17, 2026 15:55 View deployment

vercel Bot deployed to Preview – variscout_website May 17, 2026 15:57 View deployment

docs(wedge): fix 3 broken cross-refs to archived docs (PR 4 followup)

2a052aa

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

jukka-matti merged commit dd2177f into main May 17, 2026
1 of 3 checks passed

vercel Bot deployed to Preview – variscout_website May 17, 2026 16:04 View deployment

vercel Bot deployed to Preview – mean-beoynd-lite-pwa May 17, 2026 16:09 View deployment

This was referenced May 17, 2026

docs(wedge): PR 3 — Phase C AMEND (8 stale-pattern batches across 90 active docs) #195

Merged

docs(wedge): PR 5 — Phase C DELETE/amend — wedge supersession on 2 delivered agent-docs specs #196

Merged

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

docs(wedge): PR 4 — Phase C ARCHIVE (19 pre-wedge docs to docs/archive/ + Coherence §3 markers)#194

docs(wedge): PR 4 — Phase C ARCHIVE (19 pre-wedge docs to docs/archive/ + Coherence §3 markers)#194
jukka-matti merged 6 commits into
mainfrom
feat/wedge-phase-c-archive

jukka-matti commented May 17, 2026

Uh oh!

vercel Bot commented May 17, 2026 •

edited

Loading

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

Conversation

jukka-matti commented May 17, 2026

Summary

What moved

Group 1 — 8 pre-wedge specs → docs/archive/specs/

Group 2 — 8 pre-wedge plans → docs/archive/plans/ (new subfolder)

Group 3 — 1 ADR → docs/archive/adrs/

Group 4 — 2 active docs → docs/archive/{products,technical}/

Group 5 — Coherence design spec §3 markers (NOT archived; in-place edit)

Inbound link fixups (handled per-group)

Audit false positives skipped

Plan + spec

Test plan

Next PRs in Phase C

Uh oh!

vercel Bot commented May 17, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

1 participant

vercel Bot commented May 17, 2026 •

edited

Loading