[calvin-archastro]

Problem and intent

I dogfooded archdev plan collab against archdev.ai on 2026-10-21, with an agent following this skill:

person: Ask "fill out the plan" ──▶ ask.request {id, intent:"edit", range, quote:""}
agent (per skill): `suggest` over range ──▶ suggestion lands in the doc
page: prompt stays "Queued", status said ready, approval not blocked by it

The page (firstlanding services/go/archdev/web/src/plan-collab/plan-session.ts) marks a prompt done only when it receives agent.reply {request: <id>}. The skill told agents to answer ask.request with only a suggestion, so an agent that followed it exactly left every Ask queued forever.

The page also sends two signals the skill never mentions: run.stop {run} (Stop agent) and plan.tasks.request {request, revision} (Break into tasks). An agent following the skill ignored both.

What changed

• ask.request documents its intent field. chat means answer in the reply without editing; edit means suggest, then reply. Every ask.request and agent.request now ends with agent.reply, with an example command.
• An Ask with no selection (empty range and quote) inserts at that position.
• New sections cover run.stop (send run.status stopped) and plan.tasks.request → plan.tasks.result {request, revision, tasks[]}, using the page's DraftTask shape (key, title, risk, area, dependsOn).
• A note says ghost completions need --model @alias in practice. In one session the page sent 56 complete.request and 28 cancels, and every hand-driven complete failed with "canceled, replaced or unknown".
• Plugin copies were regenerated with tools/plugin-gen (npm run build). npm run check reports that the 148 generated files match the catalog.

Scope: skill text only. Risk: low. User impact: agents using the skill clear the page's queued prompts and handle Stop and Break into tasks.

Testing

• npm run check passes.
• npm test reported one failing assertion locally. I couldn't rerun it to identify which, so this PR's plugins CI run is the gate. Main is green.
• Companion page fix: https://archdev.ai/ArchAstro/firstlanding/pull/19498. With it, the plan page counts a waiting prompt against approval.

🤖 Generated with Claude Code