Add --issues mode: track the plan as GitHub/GitLab issues instead of PLAN.md#57
Merged
Conversation
…PLAN.md /do:replan --issues runs the full audit/triage/prune lifecycle against labeled issues. It always reads PLAN.md when present, migrates every open item out to the tracker (resolving open questions first so each filed issue is actionable), and empties PLAN.md to a note pointing at the Issues page — so PLAN.md stops churning and causing merge conflicts while work happens on issues. The issue number is the stable ID (cos/<task>/issue-<n>/<agent>). A shared lib/plan-issue-mode.md partial extends the flag to every command that records plan items: do:better, do:better-swift, and do:depfree file deferred findings as labeled issues instead of a PLAN.md audit section, and do:review/do:rpr file deferred findings as issues — so a repo can adopt issue-tracking consistently. Registers the new lib in the install/uninstall allowlists.
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.
Summary
Adds an opt-in
--issuesflag that lets a repo track its plan in the GitHub/GitLab issue tracker instead ofPLAN.md. The defaultPLAN.mdbehavior is unchanged./do:replan --issuesruns the full audit/triage/prune lifecycle against labeled issues (default labelplan, override with--issues-label <name>): closes done/stale issues with an evidence comment, files issues for opportunities it surfaces, and comments +drift-labels any item that would now remove a newer feature (never auto-closing a drift).PLAN.mdwhen present, migrates every open item out to the tracker, and emptiesPLAN.mdto a note pointing at the Issues page — soPLAN.mdstops churning and causing merge conflicts while work happens on issues. The issue number is the stable ID (cos/<task>/issue-<n>/<agent>branches); kebab-slugs don't apply in issue mode.PLAN.md.lib/plan-issue-mode.mdpartial extends the flag to every command that records plan items —/do:better,/do:better-swift, and/do:depfreefile deferred findings as labeled issues instead of writing a## … Auditsection toPLAN.md;/do:reviewand/do:rprfile a deferred finding as an issue instead of aPLAN.mdline.gh/glabVCS-host detection; aborts if neither CLI is authenticated rather than silently writingPLAN.md.Test plan
npm test— all 128 tests pass (includes theinstall.sh/uninstall.shLIBSallowlist snapshot, updated for the newlib/plan-issue-mode.md).transformCommand.glab label createto pass the required--color(the|| truewould otherwise have silently skipped label creation on GitLab).commands/do/replan.md: withghauthenticated, create aplan-labeled issue, run/do:replan --issues, and confirm close/create/comment +PLAN.mdemptied to the tracker note.