Skip to content

feat(skills): triage unattended with an afk argument - #166

Merged
kixelated merged 4 commits into
mainfrom
quest/m0/helpers/afk
Oct 21, 2026
Merged

kixelated merged 4 commits into
mainfrom
quest/m0/helpers/afk

Conversation

@kixelated

@kixelated kixelated commented Oct 21, 2026 •

Copy link
Copy Markdown
Owner

Completes quest/m0/helpers/afk.md.

Problem

Before stepping away, the user keeps typing the same instruction into /quest-complete: act on the recommended skip/iterate picks and only ask about merges.

Behavior

/quest-complete afk and /quest-spawn afk (new ## Unattended section in each skill):

  • The recommendation stands in for the user's pick of skip, /quest-ready, or /quest-iterate (and /quest-start in spawn), dispatched without asking.
  • Every recommended /quest-merge and /quest-delete is still asked as one simple question, recommendation first.
  • The recommendation also answers each simple decision an agent reports, including when resuming a headless /quest-spawn api agent.
  • A decision that is not simple becomes a skip, noted in the summary.
  • /quest-plan sessions (suggested follow-ups, and spawn's deprioritize) wait for the summary, since planning is an interview.
  • The rest of the argument still filters the PRs or quests in scope.

Also adds a two-line README note next to the /quest-spawn api paragraph, deletes the finished quest, and removes it from the helpers epic.

Decisions made unattended

  • Appended the afk text as its own section rather than editing existing lines, so it does not conflict with kixelated/quest#128, kixelated/quest#161, or kixelated/quest#162, which edit nearby lines in complete.md/spawn.md.
  • Spawn's deprioritize runs /quest-plan, so in afk mode it is held for the summary like other planning.
  • Added the README note (not named in the quest) so the argument is discoverable, matching how api is documented.

Validation

just check and just test pass in the Nix shell (vitest 232 + 257, shell hooks, lifecycle checks, Worker dry-run).

🤖 Generated with Claude Code

(Written by Claude Opus 5.5)

kixelated and others added 2 commits October 21, 2026 11:44
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
/quest-complete afk and /quest-spawn afk act on their recommendations without asking, except merges and deletes, which still get one simple question each. Decisions that are not simple become skips noted in the summary, and /quest-plan sessions wait for the summary.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@kixelated
kixelated marked this pull request as ready for review October 21, 2026 18:49
@kixelated

Copy link
Copy Markdown
Owner Author

Outcome: quest complete with no open decisions. Added an ## Unattended section to complete.md and spawn.md for the afk argument, plus a README note; just check and just test pass. Main had not moved since the claim, so no merge was needed. Marked ready; the three unattended choices are listed in the description.

(Written by Claude Opus 5.5)

@chatgpt-codex-connector

chatgpt-codex-connector Bot commented Oct 21, 2026 •

Copy link
Copy Markdown

Codex Review Summary

This comment shows the latest Codex review activity on this pull request.

Review Status Commit Review trigger
📝 Code Review ✅ Completed 2026-10-21T19:08:53.999220Z c67357a New commits
🔒 Security Review ✅ Completed 2026-10-21T19:08:24.583438Z c67357a New commits
ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review" or "@codex security review".

Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings.

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: 0c5ff6d329

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread assets/skills/spawn.md Outdated
Comment on lines +56 to +58
With an `afk` argument, the user has stepped away: your recommendation stands in for their pick of `/quest-start`, skip, `/quest-ready`, or `/quest-iterate`, so act on it without asking.
Still ask about each `/quest-merge` and `/quest-delete` you recommend, as one simple question with your recommendation first.
Skip a quest or PR whose decision is not simple, noting why in the summary instead of asking.

Copy link
Copy Markdown

Choose a reason for hiding this comment

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

P2 Badge Define AFK handling for headless-agent decisions

When afk is combined with api, a headless child that returns a decision still reaches the unconditional instruction on line 79 to ask the user before resuming. Because this new section only substitutes recommendations for the listed triage actions, it does not say whether to resume a child with its recommended answer or leave it stopped, so /quest-spawn afk api can block on a non-merge/delete question despite the advertised unattended behavior. Add an AFK-specific override for this resume path.

AGENTS.md reference: assets/AGENTS.md:L81-L82

Useful? React with 👍 / 👎.

@kixelated kixelated Oct 21, 2026 •

Copy link
Copy Markdown
Owner Author

Choose a reason for hiding this comment

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

Fixed in c67357a: in afk mode the recommendation now also answers each simple decision an agent reports, including when resuming a headless agent; a decision that is not simple is skipped and noted in the summary. Applied to complete.md too, where sub-agent decisions had the same gap.

(Written by Claude Opus 5.5)

kixelated and others added 2 commits October 21, 2026 12:01
Without this, /quest-spawn afk api still asked the user before resuming a
headless agent, and /quest-complete afk prompted for sub-agent decisions.

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

Copy link
Copy Markdown
Owner Author

Merge summary:

  • Merged main (6f20658, kixelated/quest#163) into the branch; no conflicts.
  • Addressed Codex's finding on 0c5ff6d (/quest-spawn afk api still asked before resuming a headless agent): in afk mode the recommendation now also answers each simple decision an agent reports, including when resuming a headless agent, and a decision that is not simple is skipped and noted in the summary. Applied the same rule to complete.md, where sub-agent decisions had the same gap.
  • Kept the README note and the decisions recorded in the description.
  • Codex reviewed c67357a with no findings; just check, just test, and CI pass.

Enabling squash auto-merge on c67357a.

(Written by Claude Opus 5.5)

@kixelated
kixelated merged commit c7ffb15 into main Oct 21, 2026
5 checks passed
kixelated added a commit that referenced this pull request Oct 21, 2026
Re-create the afk quest to replace the `afk` argument that landed in #166
with /quest-afk. Move ready-at-hand-back into guide-rules, since quest start
landed in #167 without it. Drop pr-states' Required on the landed quest
start, and the helpers README entries for landed quests.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@kixelated
kixelated deleted the quest/m0/helpers/afk branch October 21, 2026 21:05
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