Repository navigation
docs(quest): plan /quest-afk and the rules agents kept needing - #175
Conversation
… moq transcript audit Rewrite afk.md as a /quest-afk skill that skips every decision, add the guide-rules and complete-loop quests, and fold the ready-at-hand-back fix into start.md and the merge method and merged-PR refusal into pr-states.md. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Codex Review SummaryThis comment shows the latest Codex review activity on this pull request.
ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
Codex reacts with 👀 while any review is running, comments if it has suggestions, and reacts with 👍 once all reviews finish with no findings. |
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: b7b9ff6460
ℹ️ 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".
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
There was a problem hiding this comment.
💡 Codex Review
Here are some automated review suggestions for this pull request.
Reviewed commit: 1c654831bf
ℹ️ 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".
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
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>
|
@codex review (Written by Claude Opus 5.5) |
🛡️ Codex Security Review · Automatically triggeredSecurity review completed. No security issues were found in this pull request. Reviewed commit: Only the user who started this review can view the report in Codex. ℹ️ About Codex security reviews in GitHubThis is an experimental Codex feature. Security reviews are triggered when:
Once complete, Codex will leave suggestions, or a comment if no findings are found. |
|
Codex Review: Didn't find any major issues. 🚀 Reviewed commit: ℹ️ About Codex in GitHubYour team has set up Codex to review pull requests in this repo. Reviews are triggered when you
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". |
|
Merge summary for f50ce08:
Enabling squash auto-merge, bound to this head. (Written by Claude Opus 5.5) |
Plans quest changes from a month-long audit of the moq maintainer's Claude Code transcripts. The audit looked for steering the maintainer typed again and again. Each finding was checked against the skill text on
main. Where an existing quest already covered a finding, the finding went into that quest.Changes
quest/m0/helpers/afk.md. It now plans/quest-afk, a skill of its own that replaces theafkargument kixelated/quest#166 landed on two skills. The skill skips every decision and leaves it on the PR. It keeps starting agents and PRs for work already agreed. The guide gains a rule that every quest skill ends with a final summary in sections. There is no wind-down mode.quest/m0/helpers/guide-rules.md[S]. It covers:plan;audit;iteratedeferring to the repo on maintainer-owned decisions.quest/m0/helpers/complete-loop.md[S]./quest-completere-scans PRs whenever a sub-agent reports or a merge wait wakes. "Accept all" never covers a merge. Holds persist across refreshes and sub-agents. Review rounds are counted from the PR timeline.guide-rules.md(planned forstart.md): mark the PR ready when the quest is complete, and list choices made without asking in its body. This drops the skill's "settled every decision, including choices you made without asking" gate.pr-states.md:--landdefaults to a merge commit, and the repo's instructions can name another method;quest/m0/helpers/README.md: afk and guide-rules rank first, and complete-loop follows pr-states.Merging main
Main landed several of these helpers while this PR was open, so merging it changed the plan:
afkargument and deletedafk.md. The recorded decision stands, soafk.mdis re-created to replace that argument: delete the## Unattendedsections incompleteandspawnand the README'safksentence, and add/quest-afk.start.md. Neither folded item is on main: the guide marks a complete quest ready, but thestartskill still has the "settled every decision" gate, and nothing asks to list choices made without asking. Both moved intoguide-rules.md, since no other live quest owns thestartskill.pr-states.mdkeeps main's text and drops itsRequiredlink to the landed quest start. Its merge-method and merged-PR-refusal items stay: the PR state commands don't exist yet, and the merge skill still names no method.complete-loop.mdand the otherguide-rules.mditems were re-checked against main's guide and skills after kixelated/quest#157, kixelated/quest#159, kixelated/quest#164, kixelated/quest#167, kixelated/quest#169, and kixelated/quest#172. None had landed. The claim-push exemption now namesquest start, which makes that push.Dropped: filtering CodeRabbit and Codex notices in
quest wait. Vendor-specific filters would break the core's independence.At the user's request, the old one-line skills were removed ahead of
/quest-afk:The moq.pro commit landed on
maindirectly, throughpush.default=upstream, which is a mistake. That is the hazard the guide's explicit-refspec rule warns about.Two of the user's answers were interpreted:
gh pr merge --merge, a merge commit.Correct either if that's not what was meant.
Decision paper trail
Round 1: overlap and scope
Goal: agents stop needing repeated steering on the 11 findings, planned as quest changes folded into in-flight quests, with no direct skill edits.
Finding 1, wind-down and away modes:
Findings 2–11 except 10b:
Finding 10b,
quest waitdropping CodeRabbit and Codex notices:Round 2: /quest-afk
What it still does on its own:
Wind-down:
/quest-afk stop(recommended)Return:
Delete the old skills:
Round 3: details and placement
Final summary form:
Merge method when the repo names none:
Ranks:
Follow-ups
mergelabel queue (moq-dev/moq.pro#2510). This needs/quest-planin moq.pro.just checkandjust testpass.(Written by Claude Opus 5.5)
🤖 Generated with Claude Code