Skip to content

V-model lifecycle lens + lead-owned convergence (SPEC-031)#11

Merged
tieubao merged 1 commit into
masterfrom
docs/backlog-reeval
May 23, 2026
Merged

V-model lifecycle lens + lead-owned convergence (SPEC-031)#11
tieubao merged 1 commit into
masterfrom
docs/backlog-reeval

Conversation

@tieubao

@tieubao tieubao commented May 22, 2026

Copy link
Copy Markdown
Member

What

Two layers, kept distinct:

BUILT (implemented in this PR):

  • SPEC-031 (ID-034) V-model lifecycle lens + lead-owned convergence contract. WORKFLOW.md gains ## The V-model lens (each define phase mirrored by its verify phase, as a lens over the cycle table, not a second table), a lane×phase depth matrix (5 lanes × 13 phases), and ## Lead-owned convergence (the enumerated hands-off shared-surface list the lead integrates once via /kit:ship; non-duplication clause delegates cross-task wiring to integration-checker, the shared write to /kit:ship). docs/architecture.md gains a command/agent → V-phase inventory. ADR-0018 records the frame. The "8 phases" hard count is reworded to count-agnostic "lifecycle phases" (PHILOSOPHY, kit-health, SPEC-003/004/007). 4 new tests/test-meta.sh guards; meta suite 257 → 284.

PLANNED (ships as validated specs, NOT implemented here):

  • SPEC-032 (ID-035) concurrent /kit:dispatch; the dispatch primitive is locked by ADR-0020 after a head-to-head bakeoff spike (SPEC-033) that proved the claude agents agent view is monitor-only (no CLI create), so dispatch builds on in-session worktree subagents.
  • SPEC-034 (ID-037) the sequential/dependent /kit:mega complement.
  • Decision brief, parallelism + agent-view research notes, ADRs linearized 0017-0020.

Why

The I2 pivot toward concurrent/multi-goal workflows. SPEC-031 is the trust contract SPEC-032's dispatch rides on (it owns the hands-off list the disjointness gate imports). Source: docs/specs/DECISION-BRIEF.md.

Review

/kit:review verdict: FIX THEN SHIP. 1 MEDIUM + 3 LOW found in the new guards (a self-disabling-guard risk + a dead branch), all fixed (af75b96). See REVIEW.md.

Testing

bash tests/test-meta.sh 284/284, bash tests/test-hooks.sh 92/92. SPEC-031 was executed via /kit:execute (7/7 tasks worker→verifier-verified) and passed the integration-checker (4/4 cross-task wiring seams).

Notes

  • No version bump: accumulates in CHANGELOG [Unreleased] with the uncut SPEC-029/030; a release cut/tag is a separate act.
  • SPEC-032 / SPEC-034 implementation is queued (separate future PRs).
  • /kit:execute caught a self-defeating acceptance criterion mid-build (the blanket 8-phases grep), scoped to operating surfaces via AMEND-001 with maintainer sign-off.

Checklist

  • Tests pass (284 meta / 92 hooks)
  • Docs updated (WORKFLOW, architecture, README, CHANGELOG, ADR-0018)
  • Review fixes applied
  • No regressions (CI to confirm)

🤖 Generated with Claude Code

Clean baseline collapsing the docs/backlog-reeval branch (24 commits). Full pre-squash history preserved at origin tag pre-squash-backup.

- V-model lens over the lifecycle (ADR-0018): build-left/test-right, lane-by-phase depth matrix, lead-owned convergence, /kit:verify (SPEC-035).

- Concurrent + multi-session goal execution: /kit:dispatch worktree fan-out behind a disjointness gate (SPEC-032, ADR-0019/0020), cross-session running-goal registry (SPEC-036, ADR-0022); lib/dispatch-gate.sh, lib/goal-registry.sh, lib/lane-classify.sh.

- Goal-file lifecycle: filesystem-authoritative drafts, archive-on-ship to .claude/goals/done/ via lib/goal-drafts.sh wired into /kit:ship (SPEC-037, ADR-0023; supersedes the never-built INDEX.md from ADR-0011).

- Doc consolidation: removed RUNBOOK/ORCHESTRATION/PLAYBOOK/operating-layer-vision and stale version handoffs.

- Onboarding: README front door with a concrete first /kit: cycle; docs/README.md maps the design-record tree and states it is not needed to USE the kit.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@tieubao tieubao force-pushed the docs/backlog-reeval branch from a504f21 to ab6f6d9 Compare May 23, 2026 06:34
@tieubao tieubao merged commit 4efa331 into master May 23, 2026
2 checks passed
@tieubao tieubao deleted the docs/backlog-reeval branch May 23, 2026 06:35
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