Skip to content

docs: add llm-github-issues autonomous issue-processing pattern#694

Merged
svenmalvik merged 1 commit into
mainfrom
manifold/llm-issue
Jun 12, 2026
Merged

docs: add llm-github-issues autonomous issue-processing pattern#694
svenmalvik merged 1 commit into
mainfrom
manifold/llm-issue

Conversation

@svenmalvik

Copy link
Copy Markdown
Collaborator

Summary

  • Adds docs/llm-github-issues.md, a self-contained pattern doc in the style of docs/llm-wiki.md: a scheduled agent (once a day) reads every issue labeled llm-github-issue, understands and reproduces it, specs/plans/implements a fix, and delivers one reviewable PR per issue.
  • Core inversion: every human touchpoint becomes asynchronous state — work starts from a label, questions become a feedback-needed label + thread comment, answers are comments, delivery is a PR (never a merge).
  • Defines a fully gh-queryable state machine (Queued / Blocked / Delivered / Done) so the sweep is stateless, plus rules for reproduction, tests before/after with evidence and screenshots, one-PR-per-issue with a collective-PR overlap rule, and a bootstrap sequence (labels → gh-process-issues skill → daily routine → trial issue).
  • Design only: no labels, skills, or schedules are created by this PR.

Test plan

  • Doc review — verify the workflow rules match the intended process
  • Cited gh commands were verified against this repo's gh CLI (closedByPullRequestsReferences field, pr list --search)

🤖 Generated with Claude Code

Sibling pattern doc to docs/llm-wiki.md: a once-a-day scheduled agent drains
issues labeled llm-github-issue into one reviewable PR each, with every human
touchpoint asynchronous (feedback-needed label + thread comments instead of
questions). Design only — labels, skill, and routine are bootstrap steps, not
yet implemented.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@svenmalvik svenmalvik requested a review from a team June 12, 2026 19:46
@svenmalvik svenmalvik merged commit fedfddb into main Jun 12, 2026
@svenmalvik svenmalvik deleted the manifold/llm-issue branch June 12, 2026 19:47
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant