ask-demon

---
name: ask-demon
description: Ask which skill or flow fits your situation. A router over the docs/Agent-Note maintenance flow, the documentation governance run, the prose-and-docs tool layer, and the standalone git and game skills in this pack.
disable-model-invocation: true
---

# Ask Demon

You don't remember every skill, so ask. This pack complements Matt's engineering skills: Matt owns the engineering loop (grill → spec → tickets → implement → code-review — the single review entry point) and the writing skills; this pack owns the documentation and Agent-Note maintenance loop and game-domain work. The full absorption map and seams are in the pack's skills map (`docs/skills-map.md` in the source repository).

A **flow** is a path through the skills. One **main flow** carries the documentation work; a **governance run** brings a whole repository's docs in line with its standard; everything else is standalone, or a prose-and-docs tool layer that runs underneath.

## Session discipline

Five standing-order lines in the host repository's root `AGENTS.md` govern every action; `setup-demon-skills` writes them into a repository. Operationally:

- **Before acting** — answer questions and analyze proposals without writing; treat only an explicit execution signal with a confirmed scope as authorization; unclear intent gets one clarifying question first.
- **Before committing** — a failed check blocks the commit; the fix or its explanation ships in the same turn, and the final report names each failed check.
- **Before claiming** — inspect files before editing or describing them; report only verified reading and completed work.
- **Before destructive moves** — deletions, history rewrites, and force-push require the user to name the action before it runs.
- **When delegating** — keep bounded work local and reuse valid context; delegate independent expensive work only when the parallel saving beats dispatch and context reconstruction; cap active subagents at three, descendants included; prioritize fixes and acceptance at the real entry point.

Every flow in this pack obeys the gate: findings and plans come first, fixes run after confirmation.

## The main flow: maintain a change

The route documentation work travels: review a change, simplify what it surfaces, archive what it supersedes, sync the bilingual pairs.

1. **`workspace-standards-review`** — review a change against this workspace's documented standards (skill frontmatter and body, docs, bilingual pairs, Agent Notes, scripts), and supply the Standards axis when a two-axis review runs. Produces blockers plus suggestions. Run when a change needs a standards-compliance pass, or as a pre-push gate. Matt's `code-review` owns the review flow itself.
2. **`doc-standards`** — when the change touches documentation, run the structural pass and audit probes so the docs land in the right home, at the right detail, under budget. The review hands off here for doc changes.
3. **`find-simplifications`** — take the dead, duplicated, speculative, or over-built surface the review surfaced, and turn the worthwhile ones into proposed Agent Notes or TODO markers. The review and docs steps hand off here.
4. **`archive-agent-notes`** — when a change makes an owning note obsolete, classify and archive the superseded records. A simplification hands off here.
5. **Bilingual pairs** — update routine counterparts directly in the same pass, using the host's terminology and pairing recorder. Invoke `translate-docs` for an explicit whole-document translation, batch of counterparts, or pairing audit.

The flow cascades — `workspace-standards-review → doc-standards (when docs touched) → find-simplifications → archive-agent-notes` — and closes with pairing verification. `translate-docs` is a conditional extension for explicit translation tasks; each skill remains independently invocable.

## The governance run

A whole-repository pass when asked to govern, standardize, or audit the repository's documentation:

1. **Foundation** — the root `AGENTS.md` pointer, the documentation standard, the Agent Note tree, the bilingual pairing contract, the session-discipline lines, and the documentation budget gate must exist; missing ones come from `setup-demon-skills`.
2. **Audit** — `doc-standards` runs the structural pass and the six corpus probes; report a non-compliance list naming each document, the violated clause, and the owning fix skill.
3. **Fix by domain, after the user confirms scope** — structure, placement, budgets → `doc-standards`; prose → `prose-standard`; leakage → `trim-cot-leakage`; dead surface → `find-simplifications`; routine pairs → direct counterpart updates; explicit translation tasks → `translate-docs`; superseded notes → `archive-agent-notes`.
4. **Close out** — the documentation gates and `git diff --check`, re-record touched pairs, one Agent Note per non-trivial change, word deltas in the PR body — then the main flow takes the change home.

Every step confirms with the user before writing; a fix that changes promised behavior goes through a proposed Agent Note first.

## Prose and docs tool layer

Four skills run beneath the flow and are reachable on their own when the prose or document structure, not the process, is the problem:

- **`prose-standard`** — the base: preserve the complete proposition, then remove reasoning transcripts, repetition, and decoration. Owns editorial judgment and coverage.
- **`trim-cot-leakage`** — one smell: prose whose vantage is the authoring session (dead citations, change narration, review choreography). Restate the facts, delete the transcript.
- **`prune-prompt-pollution`** — another smell: negation priming, absence declarations, stale meta-narrative, strawman warnings. Restate the positive target or the consequence.
- **`doc-standards`** — the structure side: placement, tutorial/reference classification, corpus audits, and budget-gate probes. Owns where documents live and how they are shaped; prose-standard owns how they read.

## Standalone

Off the main flow; reach for each on its own trigger.

- **`pre-push-checks`** — before pushing, select the narrowest checks that cover the outgoing diff; protect history-rewriting pushes with `--force-with-lease`.
- **`merging-stacked-prs`** — land a stack of dependent GitHub PRs through `gh stack`; layers with Matt's `resolving-merge-conflicts`.
- **`workflow-capture`** — turn a proven or requested workflow into a reusable skill.
- **`record-browser-gif`** — record browser/Web UI demos as evidence GIFs for GUI-changing PRs.
- **`agent-doorbell`** — install hook-based desktop/audio reminders for agent stop and attention events.
- **`dota2-custom-game-dev`** — DOTA2 custom game addons.
- **`roblox-luau-developer`** — Roblox Luau development, debugging, and Rojo sync.
- **`roblox-typescript-developer`** — Roblox TypeScript (roblox-ts) development.
- **`roblox-ui-developer`** — Roblox on-screen interfaces: layout, focus, motion, verification.
- **`unreal-blueprint-analyzer`** — read-only Unreal Blueprint asset analysis.

## Setup

The maintenance flow needs a repository's conventions in place first — the Agent Note tree, the bilingual pairing contract, the documentation standard, the session-discipline lines, and the documentation budget gate. Run **`setup-demon-skills`** once to scaffold them and record where they live.