Spec 081: Executor docs, tests, and rename cleanup#70
Merged
mrmaxsteel merged 23 commits intomainfrom Mar 11, 2026
Merged
Conversation
…th package spec, update all import paths and comments
Bug mindspec-ogzs: WorktreeRemove now always passes --force to bd worktree remove, since mindspec merges bead work into the spec branch before removal (unpushed-commits check is a false positive). Bug mindspec-7i8q: complete.Run now resolves the spec from the bead's parent epic when multiple specs are active, eliminating the need for --spec when the bead ID is provided. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
CompleteBead now checks that the bead branch is an ancestor of the spec branch before proceeding with worktree removal and branch deletion. If the merge failed, cleanup is aborted to prevent data loss. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…GENTS.md architecture section with two-layer model (workflow layer + execution engine), update all execution/workflow domain docs to reference MindspecExecutor and internal/spec/, add plan quality responsibility section to workflow architecture
Reposition MindSpec as a planning & governance layer upstream of agent orchestrators. Add Architecture: Two Layers section explaining the separation between planning (specs, decomposition, quality gates) and execution (bead dispatch, merge topology, finalization). Reference arXiv:2512.08296 on task decomposition quality. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Beads isn't just a state store — it's the contract between the two layers. Each bead is a self-contained work packet (requirements, context, dependencies, acceptance criteria) that a fresh agent can pick up without session history. This is what makes pluggable orchestration possible. Updated: README.md, AGENTS.md, workflow/architecture.md, execution/architecture.md. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Drop "Two Layers" since beads as a third subsection made it misleading. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…dings in HISTORY.md, verify no outdated assumptions or broken expectations, SingleBead smoke test passes
The implement.md template says "STOP" after mindspec complete, but SpecToIdle expects the agent to continue to approve impl. This is the likely root cause of Haiku's consistent SpecToIdle failures — Haiku interprets "STOP" literally while Opus reasons past it. Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
…StopDoesNotBlockApproveImpl), fix instruct templates (remove stale auto-claims text), strengthen CLI STOP message, remove dead --no-next flag, update HISTORY.md
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
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
1 participant
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.
Summary
GitExecutor→MindspecExecutor(including file renamegit.go→mindspec_executor.go)internal/specinit/→internal/spec/to match domain conventionsgitopsterminology from codebase and docsStopAfterCompleteandStopDoesNotBlockApproveImpl--no-nextflagTest plan
make buildpassesgo vet ./...cleanTestLLM_StopAfterCompletepasses (Opus)TestLLM_StopDoesNotBlockApproveImplpasses (Opus)TestLLM_SingleBeadpasses (no regression)🤖 Generated with Claude Code