Agent skill · kevmoo
sidequest
Synthesizes conversation history and active tasks into a visual hierarchy map (`sidequest.md`) backed by a deterministic JSON state file (`sidequest.json`). Supports multiple sequential and concurrent main quests, sub-quests, and side-quests with automatic hierarchical numbering and completion sequencing. Use when the user invokes `/sidequest`, asks where we are, what we were doing, or what's on our stack, or when the conversation branches across multiple topics, blockers, or digressions. Don't use for simple one-off questions.
What it needs
About 3k tokens when loaded.
What this skill does
🧭 Sidequest (/sidequest) Synthesizes task hierarchies and context drift into a visual session map. ⚠️ Mandatory Execution Contract (5 Core Rules) 1. Tool-Driven State Updates: Always update state via the CLI tool (sidequest.dart). Never edit sidequest.json manually. 2. Tool-Driven Map Compilation: Always generate/compile sidequest.md via sidequest.dart. Never format the markdown map by hand. 3. Strict Internal Privacy: NEVER mention or reference sidequest.json in user-facing conversation. Treat JSON state as a private implementation detail. 4. Markdown User Interface: Always reference sidequest.md or provide concise inline markdown summaries when communicating progress to the human. 5. Subagent History Ingestion: Never read transcript.jsonl directly in the main conversation; always delegate history parsing to an auditor subagent. --- 🏗️ Storage & Architecture Session-Private Artifacts: All state files (sidequest.json, sidequest.md) reside strictly in the session artifact directory. Never write to user repositories or dotfiles. Compaction Resilient: sidequest.json maintains the deterministic state model (quests, completion orders, VCS state, step watermark) across context truncations. --- 🧭 Hierarchy & Syntax Specification Level Syntax / Prefix Description Status Indicators :--- :--- :--- :--- Main Quest Main Quest N: High-level initiatives / chapters ⚔️ [ACTIVE], 🏆 [COMPLETED], ⏸️ [PAUSED] Sub-Quest Sub-Quest N.M: Planned milestones 🛡️ Blocker Blocker N.M.K: Critical-path unplanned blocker 👾 Active, 💀 ~~Resolved~~ Step Step N.M.K: Planned action item 👣 Active, 👣 ~~Done~~ Side Quest [Active] / 🎒 [Parked] Tangents / rabbit holes (G1, S1) 🌿 Completion Order ([#N ⭐]): Completed items receive sequential tags ([#1], [#2]). The most recently completed item receives the star ([#N ⭐]). VCS Lifecycle: Track working copy state per quest: 📝 Dirty -> 📦 Local Commit -> 🚀 Uploaded -> 🎉 Merged -> 🧹 Clean. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills kevmoo/sidequest