Repository navigation
feat: issues-only SDD backend for loadout spec and the wizard - #26
Draft
machado144 wants to merge 2 commits into
Draft
machado144 wants to merge 2 commits into
machado144 wants to merge 2 commits into
Conversation
* loadout spec --backend issues (or LOADOUT_SDD_BACKEND): init opens spec(NNN): name, list/status read the plan section, check/uncheck re-fetch and flip one box, #N refs, sync refused * plan steps addressed by **N. number or sdd marker, byte-preserving toggle shared with the file backends * wizard sdd.backend: issues generates issues-only spec/plan/handoff/resume commands, workflow skill and instruction Refs #25 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
✅ PR title follows the required formatCurrent title: |
…emplates Keeps the generated prose reviewable as markdown and clears the dupehound gate; output is unchanged. Refs #25 Co-Authored-By: Claude Opus 5.5 <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
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.
Refs #25 — spec 011 is pending review; this is a draft until it is approved.
What
Adds a third SDD backend,
issues, where each spec and its plan live in one GitHub issue and nothing is written to the repo. The flow matches the hand-editedspec-af/plan-af/handoff-af/resume-af/sdd-workflow-af/sddstore files, so re-running the wizard withsdd.backend: issuesregenerates them instead of reverting todocs/specs.loadout spec --backend issues(orLOADOUT_SDD_BACKEND=issues)init: numbers after both existingspec(NNN):issues and local spec files. It creates thespeclabel if missing and uses the template body with the plan placeholder (--style full|light).list/status: read issues by label. Steps are the checkboxes between<!-- plan:start -->/<!-- plan:end -->, addressed by their**N.number or ansdd:marker. Code fences and text outside the markers are ignored.check/uncheck: re-fetch the body and change only that checkbox character.sync: refused with a "not applicable" message, since the issue is the only copy.Wizard
sdd.backendgainsissues. With it,/spec,/plan,/handoff,/resume, the workflow skill, thesddinstruction andcontext-handoffdescribe the issues-only flow. With your custom names, the generated files differ from your current store copies only in three added hints:/spec-af: aloadout spec init … --backend issuesshortcut;/plan-afand the skill:loadout spec status/check … --backend issuesas the fetch-flip-write helper;context-handoff: its location and lifecycle lines now say "spec issue comment / untracked local file". Your store copy still says.agents/context/handoff.md, "safe to commit".localandgithuboutput is unchanged; tests compare it byte-for-byte for handoff/resume.Tests
internal/sdd/issues_test.go: plan-section parsing (number vs marker IDs, fences, outside-marker lines, CRLF), single-byte toggle, valid-ID errors, duplicate numbers,#Nresolve, slugify, andbackend: issuesinsdd.yaml.internal/wizard/content_issues_test.go: key phrases per artifact, no.plan.md/sdd.yamlin issues mode, light style, and the other backends unaffected.integration/spec_issues_test.go(real binary + stubghtracker): init numbering, label and body, nothing written to the repo, duplicate refused; list/check/uncheck/status with an edit made in the GitHub UI between commands preserved, everyissue editimmediately preceded byissue view; sync refused; env var selection; andwizard --answersinstalls the issues-only artifacts.go test -race ./...,-tags integration, golangci-lint (0 issues).🤖 Generated with Claude Code