Skip to content

feat(skills)!: follow-ups land as quests in the PR that found them - #582

Merged
kixelated merged 6 commits into
mainfrom
quest/m0/follow-ups
Nov 9, 2026
Merged

kixelated merged 6 commits into
mainfrom
quest/m0/follow-ups

Conversation

@kixelated

@kixelated kixelated commented Nov 9, 2026 •

Copy link
Copy Markdown
Collaborator

Finishes quest/m0/follow-ups.md: follow-ups stop living in PR bodies until someone runs /quest-plan on them.

Summary

  • Guide, Creation: a session that finds work worth a quest adds it to its own PR, as a new quest (placed and sized by the usual rules) or an edit to the quest that owns the work. Decisions it can make go in the Plan as recommendations; open ones are Maintainer: decision items under Waiting. The PR body's ## Follow-ups section links each follow-up with its open decisions, and they don't keep the PR a draft. A PR that adds follow-ups lands only on the user's pick. The round that picks it also asks which follow-ups to keep and settles their open decisions. The answers are recorded in the quest files, and dropped follow-ups are removed, before it lands.
  • Guide, Execution / Summaries / Questions and quest context: the "follow-ups only through /quest-plan" and "suggest in the PR body" wording is gone.
  • /quest-merge: follow-up decisions don't block the pick, but the pick round's answers have to be recorded (by /quest-iterate) before the PR is queued. Called directly, it asks those questions itself. Recording the answers is a new review exemption. It no longer plans follow-ups after queueing.
  • /quest-start, /quest-iterate: open follow-up decisions don't keep a finished quest away from /quest-review or a PR from being marked ready.
  • /quest-complete: a PR that adds or expands quests loses the standing pick. The pick question carries the follow-ups' keep and decision questions, and the answers go into the /quest-iterate brief. A blanket "use your recommendations" settles those too. The post-queue planning steps are gone, including the one in "finish up".
  • assets/CONTEXT.md: the follow-up rule now says to add follow-ups to your PR as quests (9,404 of 10,000 characters after merging main with feat(hooks): enforce the mechanical rules with PreToolUse hooks #553). Audited for other rules this PR leaves stale, contradicted, or duplicated: none.
  • Root AGENTS.md, CONTRIBUTING.md: the standing /quest-complete pick now excludes a PR that adds or expands quests.
  • /quest-iterate, /quest-review, /quest-spawn, /quest-afk, /quest-plan, /quest-recurring: updated to match. Iterate and review now load the guide's Creation section.

Choices made without asking

  • Open follow-up decisions go in the quest file as Maintainer: items under ## Waiting, which reuses the existing format. If a PR ever lands outside the skills without them answered, they still show up in quest waiting.
  • A follow-up for work that another repository's quest tree owns stays in ## Follow-ups for /quest-plan there. This repository's PR can't add it.
  • Edits to existing quests count as follow-ups, and so does adding a quest, so both need the user's pick. /quest-plan PRs that add quests also lose the standing pick, as the quest's reasoning implies.

Decisions

Settled by the maintainer in /quest-complete on 2026-11-09:

  • ✅ /quest-merge picked; the coordinator queues it (rejected: skip; delete).
  • ✅ Keep the assets/CONTEXT.md edit and audit CONTEXT.md for consistency with this PR (rejected: revert it and track it separately).
  • ✅ Update the root AGENTS.md and CONTRIBUTING.md standing-pick wording to exclude PRs that add or expand quests (rejected: leave them).

Public API

Only shipped skills and rules change; there is no CLI or wire change. This is breaking for agents that relied on /quest-merge and /quest-complete planning follow-ups after queueing. Migration: put follow-ups in the PR as quest files.

Validation

just check and just test pass. test/skills.test.ts caught /quest-afk going over Claude Code's 30,000-character inline limit, and trimming /quest-complete fixed it. quest check --base origin/main passes.

Follow-ups

None. Broader CONTEXT.md trimming: none recommended; it sits about 600 characters under the cap and nothing else in it overlaps this change.

Models

Size: M
Implementer: Claude Code, claude-opus-5-5, medium effort
Implementer: Claude Code, claude-opus-5-5, low effort (iterate, S)

🤖 Generated with Claude Code

(Written by Claude Opus 5.5 with medium)

Review

Rewritten by quest review after each round.

  • Reviewer: Codex, gpt-6.1-sol, medium effort
  • Session: 01a1c155-3465-7172-b0f4-ac59dab3186e, round 5
  • Head: af4f19f
  • Base: origin/main at 37963bf
  • Score: 10/10, The incremental changes align the unattended workflow with the reviewed follow-up decision rules and introduce no new issues.
  • Findings: none

Quest-Claim: 74279dc163f4508f
@pullfrog

pullfrog Bot commented Nov 9, 2026

Copy link
Copy Markdown

Pullfrog  | Review this ➔

Follow-up quests are added to the PR that finds them, with decisions
pre-answered by recommendation and open ones as Maintainer: Waiting items.
The round that picks the PR to merge asks which to keep and settles the
open decisions; a PR adding quests never takes the standing pick.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@kixelated kixelated changed the title Follow-ups land in the PR that found them feat(skills)!: follow-ups land as quests in the PR that found them Nov 9, 2026
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@kixelated
kixelated marked this pull request as ready for review November 9, 2026 17:27
@coderabbitai

coderabbitai Bot commented Nov 9, 2026 •

Copy link
Copy Markdown

Warning

Review limit reached

You've used all free OSS reviews for now. Wait for the free limit to reset to keep reviewing this public repository.

Next included review available in 36 minutes.

Check out review usage here.

View limit details

Limit details: You’ve used the included review currently available.

Learn how review limits work.

Review configuration:

Run configuration

  • Source mode: Auto
  • Repository: Unavailable
  • Branch: Unavailable
  • File: No configuration file from this repository applied
  • Commit: Unavailable
  • Layers: Organization UI
  • Review profile: CHILL
  • Plan: Advanced
  • Run ID: 2659a4c4-528c-46f1-b6a9-67fc141c325d
Commits

Reviewing files that changed from the base of the PR and between 37963bf and af4f19f.

Files selected for processing: 14

  • AGENTS.md
  • CONTRIBUTING.md
  • assets/AGENTS.md
  • assets/CONTEXT.md
  • assets/skills/afk.md
  • assets/skills/complete.md
  • assets/skills/iterate.md
  • assets/skills/merge.md
  • assets/skills/plan.md
  • assets/skills/recurring.md
  • assets/skills/review.md
  • assets/skills/spawn.md
  • assets/skills/start.md
  • quest/m0/follow-ups.md
  • Autofix · Keep fixing CodeRabbit findings and required CI, and resolving merge conflicts

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

Share

@kixelated kixelated left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Automated review by review (OpenAI)

Head: 7600d5c
Base: fcca33e

[P2] Carry the follow-up readiness exception into the AFK workflow
Location: assets/skills/afk.md:17-20

The guide now says unresolved follow-up decisions neither keep a finished PR in draft nor prevent its eventual merge pick, and start/iterate/review have been updated accordingly. AFK still says a started agent reviews only with "no decisions" and that any decision an agent reports means "Its PR stays a draft". Moreover, AFK's omit list removes Creation, so its composed instructions do not even contain the new follow-up rule that could qualify those statements (compose applies that omission to the inherited skills too). A finished quest whose only question belongs to a newly added follow-up therefore receives conflicting readiness instructions specifically in the unattended workflow.

Direction: distinguish follow-up questions from blockers to the original quest in AFK as well. Preserve those questions for the user's merge-pick round while allowing the finished PR to be reviewed and marked ready, and include the necessary follow-up handling rule in AFK's composed instructions without enabling an unattended interview. Check the inline-size limit after that change.

The rest of the reviewed flow records or drops follow-ups before queueing and removes the standing pick from quest additions/expansions.

Verification limits: GitHub-only static review of all 12 changed files, the complete relevant skills, the skill composer, and composition/size tests. No repository code, tests, builds, or live agent workflow was executed. GitHub's check/queue/lifecycle jobs were skipped and CodeRabbit was neutral, not a completed full validation run.

(Written by review (OpenAI))

kixelated and others added 2 commits November 9, 2026 09:34
…RIBUTING.md; tighten CONTEXT.md follow-up rule

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

@kixelated kixelated left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Automated review by review (OpenAI)

Reviewed head: 2d14ebb
Previous reviewed head: 7600d5c

The new standing-pick wording in AGENTS.md and CONTRIBUTING.md and the shortened CONTEXT.md rule are consistent with the intended flow. I found no new actionable issue in those incremental changes or their integration with the base merge.

The previous P2 finding remains unresolved at this head: assets/skills/afk.md:17-19 still limits review to “no decisions” and says any reported decision keeps the PR a draft, while its omit list still removes Creation. A finished quest with only follow-up decisions therefore still receives conflicting readiness instructions.

Direction: retain the follow-up readiness exception in AFK while leaving all follow-up answers for the user's merge-pick round, and verify the composed skill remains within its size limit.

Verification limits: GitHub-only static review of the incremental commits, current PR diff, and relevant instructions. No repository code, tests, builds, or live agent workflow executed. The current head's visible check/queue/lifecycle jobs are skipped and CodeRabbit is neutral, so they do not establish a full passing validation run.

(Written by review (OpenAI))

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@kixelated

Copy link
Copy Markdown
Collaborator Author

Fixed in af4f19f: /quest-afk now has a started agent run /quest-review when the only open decisions are its follow-ups'. An agent's decision on its own quest keeps the PR a draft, and a follow-up's decision waits for the PR's pick round. The standing pick wording now defers to /quest-complete, which excludes PRs that add quests. AFK still answers no decision itself, so it runs no unattended interview. Composed /quest-afk is within the 30,000-character limit (test/skills.test.ts passes). I checked the other composed skills for the same gap: start, iterate, review, merge, spawn, complete, and recurring already carve out follow-ups, and unblock has no readiness gate.

(Written by Claude Opus 5.5 with low)

@kixelated
kixelated added this pull request to the merge queue Nov 9, 2026

@kixelated kixelated left a comment

Copy link
Copy Markdown
Collaborator Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Automated review by review (OpenAI)

Reviewed head: af4f19f
Previous reviewed head: 2d14ebb

The previous AFK readiness P2 is addressed. AFK now explicitly permits review when only follow-up decisions remain and distinguishes those from decisions that keep the original quest's PR in draft. Its own text carries the exception despite omitting Creation, and it leaves the answers for the user's pick round. Deferring standing-pick eligibility to complete also avoids restating the old, broader condition.

No new actionable findings in this incremental change. The direction is consistent with the reviewed follow-up workflow and preserves the prohibition on unattended decision-making.

Verification limits: GitHub-only static review of the incremental commit, complete AFK instructions, and the author's response. I did not run code, tests, builds, skill composition, or a live agent workflow. The author reports the composed-skill size test passes; I have not independently executed that test.

(Written by review (OpenAI))

Merged via the queue into main with commit bd7980f Nov 9, 2026
6 checks passed
@kixelated
kixelated deleted the quest/m0/follow-ups branch November 9, 2026 17:49
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