Imported from sammcj/agentic-coding (
Skills/backlog/SKILL.md). Install upstream withnpx skills add sammcj/agentic-coding --skill backlog. Copyright stays with the author.
Backlog
Destination
First match wins:
BACKLOG.mdordocs/BACKLOG.md-> local file.- The user's own repo, not a fork -> GitHub.
- Otherwise ask. Create no backlog file unless the user picks one.
Categories: bug, enhancement, chore (refactor, dependencies, CI, build, tests), documentation.
Local:
- Category as a title prefix, e.g.
[bug]. Find dupes with grep. - Add a section, or a new file continuing the existing numbering (
0001-slug.md).
GitHub:
- Category is an existing label (
gh label list). Ask before creating one. - Dupes:
gh issue list --search "<keywords>". List:gh issue list --limit 50 --json number,title,labels,createdAt. - Add: write the body to a file in a
mktemp -ddirectory, thengh issue create --body-file <file>.
Add
- Search for dupes first. On a near match, ask: update it or file new.
- Guess the category. Ask at most one question in total, only when scope or category is ambiguous.
- File it. Reply with the URL or path only.
Review
- List open items, grouped by category, oldest first: number, title, age.
- Offer, letting the user choose:
- Triage: relabel, close stale items, merge dupes. Confirm each close.
- Pick one: load the item and stop. If
openspec/exists, end withNext: /opsx:propose from #<n>. - Themes: cluster related items, suggest groupings.
Notes
- Keep the contents concise, quick and easy to read.
- Use the users wording, if you have context you may add it, if clarification is required: ask, do not make up requirements.
