Skip to content

Include issue comments during /issue-init (#45)#46

Merged
jepegit merged 1 commit into
mainfrom
45-include-issue-comments
Apr 19, 2026
Merged

Include issue comments during /issue-init (#45)#46
jepegit merged 1 commit into
mainfrom
45-include-issue-comments

Conversation

@jepegit
Copy link
Copy Markdown
Owner

@jepegit jepegit commented Apr 19, 2026

Closes #45.

Summary

/issue-init now triages the GitHub issue comment thread into a curated section of issue<N>_original.md, so clarifications, extra tasks, and walked-back decisions posted in comments are visible to downstream commands. The original issue body stays byte-for-byte unchanged.

  • /issue-init command (src/issue_flow/templates/commands/issue-init.md.j2): fetch adds comments (gh issue view --json title,body,url,number,comments); new step 2a triages them via the new skill; file-content format grows an optional ## Comments (curated summary) section with three buckets (Additional tasks, Clarifications / constraints, Superseded / retracted); output now reports triage counts.
  • issueflow-issue-init skill: mirrors the command — fetch shape, triage step, curated block in the Write section, triage counts in the Report step.
  • New issueflow-issue-comments skill (src/issue_flow/templates/skills/issueflow_issue_comments/SKILL.md.j2): chronological precedence (later comments win), the three buckets, noise filtering (bots / LGTMs / emoji-only), paraphrase rules, disagreement handling, maintainer-authority tie-breaker, exact output contract, and edge cases (zero comments, all-noise, multi-author disagreement, external links, large code blocks).
  • Manifest + tests: skill registered in TEMPLATE_MANIFEST; manifest count bumped 20 → 21; three new focused tests cover the command's comment-fetching + delegation, the init skill's delegation, and the new skill's triage rules.

Section is omitted entirely when there are no comments or all comments are noise, so existing behavior for comment-less issues is unchanged.

Test plan

  • uv run pytest -q — 71 passed.
  • No linter errors on changed files.
  • Optional smoke: run uv run issue-flow update in a scratch project and confirm .cursor/skills/issueflow-issue-comments/SKILL.md is emitted alongside the updated .cursor/commands/issue-init.md and .cursor/skills/issueflow-issue-init/SKILL.md.
  • Optional end-to-end: re-run /issue-init against an issue that has real comments and confirm the curated section contains sensibly bucketed bullets.

Made with Cursor

- Fetch comments alongside the issue body via
  `gh issue view --json title,body,url,number,comments` and triage them
  into a new optional "Comments (curated summary)" section in
  issue<N>_original.md (three buckets: Additional tasks, Clarifications /
  constraints, Superseded / retracted). The issue body itself stays
  byte-for-byte.
- New `issueflow-issue-comments` skill describes the triage rules
  (chronological precedence, noise filtering, maintainer-authority
  tie-breaker, output contract, edge cases) and is delegated to from
  both the /issue-init command and the issueflow-issue-init skill.
- Register the new skill in TEMPLATE_MANIFEST; bump the manifest-count
  test and add focused tests that check the command fetches comments,
  the init skill delegates, and the new skill documents the triage
  rules.
- Append an [Unreleased] entry to HISTORY.md.

Made-with: Cursor
@jepegit jepegit linked an issue Apr 19, 2026 that may be closed by this pull request
@jepegit jepegit merged commit 454174b into main Apr 19, 2026
1 check passed
@jepegit jepegit deleted the 45-include-issue-comments branch April 19, 2026 21:43
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.

include issue comments

1 participant