Skip to content

docs(wedge): PR 1 — Phase A doc completion (anchors + drift + Phase C plan)#191

Merged
jukka-matti merged 19 commits into
mainfrom
feat/wedge-phase-a-doc-cleanup
May 17, 2026
Merged

docs(wedge): PR 1 — Phase A doc completion (anchors + drift + Phase C plan)#191
jukka-matti merged 19 commits into
mainfrom
feat/wedge-phase-a-doc-cleanup

Conversation

@jukka-matti
Copy link
Copy Markdown
Owner

Summary

Closes the wedge spec §13 Phase A commitment — rewrites 7 canonical anchor docs to reflect V1 architecture, fixes audit-caught drift, propagates €99→€120 across the docs/01-vision/ neighborhood, and creates the Phase C plan artifact. 26 files, +1331/-687 lines, 17 commits, docs-only.

Strategic decisions captured

Vocabulary: "wedge" retired from customer-facing docs. Use VariScout (today, V1) + VariScout Process (named-future). "Wedge" stays in historical artifacts (ADR-082, decision-log, sub-plans, commit messages, developer-facing CLAUDE.md sections).

Pricing: €120/month single SKU as current truth. €79/€199 preserved only in clearly-labeled historical migration contexts.

Membership model: project-membership ACL (Lead/Member/Sponsor per canAccess.ts) replaces tier-gating. tier-philosophy.md retired; membership-philosophy.md is the new canonical philosophy doc.

Two-product narrative: VariScout today + VariScout Process named-future, framed without hedging. Process product activation gated on 500+ V1 customers (next year+).

Phase A anchors

  • DATA-FLOW.md — single-SKU + project-membership ACL data isolation
  • positioning.md — 4 differentiated promises, tight ICP, two-product roadmap
  • business-bible.md — "the bet" framing, 10 hypotheses, three preconditions
  • membership-philosophy.md (renamed from tier-philosophy.md) — permissions matrix verbatim from canAccess.ts
  • roadmap.md — V1 SHIPPED + VariScout Process named-future horizon
  • CLAUDE.md (root) — opening summary updated (7-tab, €120, project-membership)
  • llms.txt — agent manifest reflects V1 anatomy

Drift fixes

  • OVERVIEW.md + USER-JOURNEYS.md — €99→€120 + scrub wedge customer-facing
  • ADR-082 body + wedge spec §5.1 body — €99→€120 + §15 Amendments footer
  • apps/azure/CLAUDE.md + packages/core/CLAUDE.md + apps/pwa/CLAUDE.md — tier-language retirement
  • docs/01-vision/{product-overview, market-analysis, evaluations/*} (7 files) — €99→€120 anchor-neighborhood cleanup

Phase C plan artifact

New: docs/superpowers/plans/2026-05-17-phase-c-doc-audit.md — 8 stale-pattern detection vectors, KEEP/AMEND/ARCHIVE/DELETE triage, parallel Explore audit method, 3 sequenced apply PRs.

Review trail

  • Sonnet spec reviewer: APPROVE_WITH_FOLLOWUP — flagged 7-file €99 drift in docs/01-vision/, fixed pre-merge in d41bfd4
  • Opus quality reviewer: APPROVE_WITH_FOLLOWUP — 1 BLOCKING (nav contradiction) + 5 IMPORTANT craft refinements; 4 folded pre-merge in cc65783; 3 strategic-conviction items deferred for user judgment

Plan + spec

  • Plan: docs/superpowers/plans/2026-05-17-pr-1-wedge-phase-a-doc-completion.md
  • Spec: docs/superpowers/specs/2026-05-17-wedge-phase-a-doc-completion-design.md

Test plan

  • pnpm docs:check green (532 docs validated)
  • Zero wedge in customer-facing anchor prose (only filename + ADR-title refs)
  • Zero €99/€79/€199 as current-truth across docs/
  • Zero retired-symbol references in CLAUDE.md files
  • tier-philosophy.md → membership-philosophy.md rename clean

Followups (NOT this PR)

  • 3 strategic-conviction craft items from Opus review (preconditions framing, H10 evidence depth, Sponsor signoff register) — user judgment
  • PR 1.5 — VariScout Process multi-file capture (named-future, NOT agent-canonical, ~1000-1500 lines Opus synthesis)
  • PR 2-4 — Phase C AMEND → ARCHIVE → DELETE per the new plan artifact

🤖 Generated with Claude Code

jukka-matti and others added 17 commits May 17, 2026 15:33
…ct-overview + market-analysis + 4 competitive benchmarks)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…positioning §3.1 payoff + business-bible §7 register + membership-philosophy gate language

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@vercel
Copy link
Copy Markdown

vercel Bot commented May 17, 2026

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

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

jukka-matti and others added 2 commits May 17, 2026 16:53
…€99→€120 (Opus final-review followup)

Resolves internal contradiction flagged by Opus final-branch review: six
anchor docs still described a 4-stage lifecycle (Charter → Approach → Improve
→ Sustainment) and called Improve a "Project stage" after the 2026-05-16
improve-tab amendment established the 3-stage model (Charter → Approach →
Sustainment) with Improve as a top-level verb tab. Also corrects the glossary
supersession entry (Improve stage → Improve tab direction was backwards) and
updates €99 SKU references to €120 per spec §13.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
…inition + Quick Action

Glossary #Project definition and canvas-response-path #Quick-Action description
still carried the 4-stage chain and "Improve stage" phrasing. Fixed to match
the 3-stage canonical truth; no other files changed.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@jukka-matti jukka-matti merged commit a0c336d into main May 17, 2026
1 of 3 checks passed
jukka-matti added a commit that referenced this pull request May 17, 2026
…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).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant