afk-resolve

Resolves one wayfinder Decision ticket autonomously via research, docs-only PR, and ticket closure.

1|1|Updated Oct 3, 2021
One-click install
npx skills add https://github.com/benjr70/Smart-Smoker-V2 --skill afk-resolve-benjr70
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: afk-resolve
Source: https://github.com/benjr70/Smart-Smoker-V2/tree/main/.claude/skills/afk-resolve
Command: npx skills add https://github.com/benjr70/Smart-Smoker-V2 --skill afk-resolve-benjr70

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Decision tickets in a wayfinder Map require research, documentation, PR review, and ticket bookkeeping that normally demand a human; this Skill resolves one such ticket end to end without human involvement. ## Core Features & Use Cases - Autonomous research resolution: Claims a ticket, runs primary-source research via the research skill, and persists findings to docs/research/<map-slug>/<ticket-slug>.md behind a docs-only PR. - Gated merge and closure: Hands CI to /pr-watch, merges only through the docs-only gate's own merge command, then posts the resolution comment, closes the ticket, and appends the Map's Decisions so far. - Fog graduation and failure handling: Spawns up to 3 new sub-tickets from answers under strict depth/routing guardrails, and labels unresolvable tickets AFK:failed with a documented reason instead of inventing answers. - Use Case: A /afk-pickup run selects a wayfinder:research ticket asking which notification library to use; this Skill researches primary sources, merges the findings doc, closes the ticket with a linked gist, and graduates newly specifiable follow-up questions into new tickets. ## Quick Start Invoke the skill with the ticket number and type, for example by asking to run /afk-resolve with --issue 42 and --type research to resolve that Decision ticket autonomously.

Frequently Asked Questions about afk-resolve

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I resolve a wayfinder Decision ticket automatically?

Invoke /afk-resolve with --issue <N> and --type research or task. The skill claims the ticket, runs primary-source research, persists findings to docs/research/, merges a docs-only PR through the gate, posts the resolution comment, and closes the ticket.

What is the difference between research and task ticket types?

Research tickets produce a findings file under docs/research/ merged via a docs-only PR. Task tickets perform human-free work directly (provisioning, moving data) with no file or PR, recording results only in the resolution comment.

Can afk-resolve handle grilling or prototype tickets?

No. wayfinder:grilling and wayfinder:prototype are HITL (human-in-the-loop) types and are always refused. A task ticket that turns out to need product code is relabelled HITL rather than implemented.

What happens when the docs-only gate refuses the merge?

The ticket is labelled AFK:failed with the gate's verbatim reason, and the PR stays open. The PR body carries an afk-resolve marker so a later fire that merges it can invoke --finish-merged mode to close the ticket automatically.

How does fog graduation spawn new tickets safely?

At most 3 new sub-issues of the Map are created per resolve, each with a Spawned by provenance line. Tickets beyond depth 2 in the spawn chain, or any non-research type, are routed HITL so a human reviews runaway branches.

Why does afk-resolve never write product code?

Decision tickets resolve to decisions or facts, never product changes. The only file written is docs/research/<map-slug>/<ticket-slug>.md and the only branch is research/<slug>; anything requiring code is relabelled HITL for human routing.