V-model lifecycle lens + lead-owned convergence (SPEC-031)#11
Merged
Conversation
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>
a504f21 to
ab6f6d9
Compare
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What
Two layers, kept distinct:
BUILT (implemented in this PR):
WORKFLOW.mdgains## 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 tointegration-checker, the shared write to/kit:ship).docs/architecture.mdgains 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 newtests/test-meta.shguards; meta suite 257 → 284.PLANNED (ships as validated specs, NOT implemented here):
/kit:dispatch; the dispatch primitive is locked by ADR-0020 after a head-to-head bakeoff spike (SPEC-033) that proved theclaude agentsagent view is monitor-only (no CLI create), so dispatch builds on in-session worktree subagents./kit:megacomplement.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:reviewverdict: FIX THEN SHIP. 1 MEDIUM + 3 LOW found in the new guards (a self-disabling-guard risk + a dead branch), all fixed (af75b96). SeeREVIEW.md.Testing
bash tests/test-meta.sh284/284,bash tests/test-hooks.sh92/92. SPEC-031 was executed via/kit:execute(7/7 tasks worker→verifier-verified) and passed theintegration-checker(4/4 cross-task wiring seams).Notes
CHANGELOG [Unreleased]with the uncut SPEC-029/030; a release cut/tag is a separate act./kit:executecaught a self-defeating acceptance criterion mid-build (the blanket 8-phases grep), scoped to operating surfaces via AMEND-001 with maintainer sign-off.Checklist
🤖 Generated with Claude Code