Skip to content

issue-create: add open-questions resolution pass; drop handoff prompt#77

Merged
SnowboardTechie merged 2 commits into
mainfrom
bryan/intelligent-ptolemy-278db0
May 3, 2026
Merged

issue-create: add open-questions resolution pass; drop handoff prompt#77
SnowboardTechie merged 2 commits into
mainfrom
bryan/intelligent-ptolemy-278db0

Conversation

@SnowboardTechie
Copy link
Copy Markdown
Owner

Summary

Adds a collaborative open-questions resolution pass to the /issue-create skill: when the rendered draft contains an Open questions section, the skill walks each item with a stated lean (or "no lean — your call"), accepts confirm / override <text> / defer, and re-renders with resolutions baked into Scope / Hints / Acceptance. Strips the post-create "Start working on this now?" handoff prompt — fresh-context /issue-work agents are the right shape for implementation work, and the auto-prompt was always declined.

Closes #70.

Test plan

  • Re-read modified SKILL.md end-to-end after edits — new Stage 3.3 flow is unambiguous (detection trigger, lean priority, per-question shape, default-commit rule, deferred-marker, misfit-prompt, re-render rules, zero-questions short-circuit), 3.3 → 3.4 renumber clean, Stage 4.7 report block intact (handoff tail removed), line 10 + Related entry rewritten for manual pairing, CHANGELOG entry observable-change framing.
  • Three-lens self-review (/pr-self-review in pre-pr mode) — pass 1: 1 Major + 2 Minor + 2 Nit; three findings accepted in commit 8795449, one pushed back (CHANGELOG Resolves matches repo convention; issue-create: default to collaborative open-questions pass; drop post-create issue-work handoff #70 should auto-close), one skipped (Stage 4 heading drift-fix; reviewer agreed). Pass 2: 0/0/0/0 across correctness / security / simplicity. Loop exit clean.
  • No automated test surface — skill bodies are LLM instructions, not code; runtime exercise happens on the next /issue-create invocation.

Changelog

  • Non-release PR — added a bullet under ## [Unreleased] in CHANGELOG.md.

Inserts a new Stage 3.3 between draft render and approval that walks
each Open questions item with a stated lean (or "no lean — your call")
and re-renders with resolutions baked into Scope / Hints / Acceptance.
Strips the "Start working on this now?" prompt and conditional
/issue-work invocation from Stage 4.7; the Pairs with relationship
survives but the auto-handoff mechanism does not. Stage 4 + 4.7 titles
trimmed since "& hand off" / "+ handoff" are no longer accurate.

Resolves #70.
- Drop "(or equivalent free-form open-ended)" parenthetical from the
  template-derived-draft sentence so the detection trigger stays bound
  to the plan's literal "Open questions" non-goal.
- Add a data-anchoring sentence after the per-question prompt so an
  instruction-shaped {question text} is treated as content, not as an
  instruction (matters when the draft was templated from a third-party
  repo).
- Complete the "On `yes` ..." sentence fragment with an explicit
  predicate so the LLM doesn't have to reconstruct intent.

Findings from /pr-self-review on 17564ca.
@SnowboardTechie SnowboardTechie added enhancement New feature or request quick win Small, self-contained scope — good candidate for a focused session labels May 3, 2026
@SnowboardTechie SnowboardTechie marked this pull request as ready for review May 3, 2026 23:04
@SnowboardTechie SnowboardTechie merged commit 6cf4d04 into main May 3, 2026
3 checks passed
@SnowboardTechie SnowboardTechie deleted the bryan/intelligent-ptolemy-278db0 branch May 3, 2026 23:04
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

enhancement New feature or request quick win Small, self-contained scope — good candidate for a focused session

Projects

None yet

Development

Successfully merging this pull request may close these issues.

issue-create: default to collaborative open-questions pass; drop post-create issue-work handoff

1 participant