codewhale-hq

Strategic delegation for multi-step coding, research, or verification work. Use when a task can be split into parent reasoning plus focused sub-agent execution through the agent tool.

Use before claiming any Codewhale change is done, green, or ready to land: the focused-to-broad verification ladder, the budget checks CI enforces, and the rules for what counts as a passing test.

Operate desktop apps and isolated browsers on registered computers. Use for tasks that require an app interface, accessibility, screenshots or recording. Use Chromewhale for the user's signed-in Chrome.

Use when turning verified Codewhale work into commits, branches, or a merge: choosing direct-main vs. worktree vs. integration branch, preserving contributor credit, and honoring the gate artifact before merging.

Use at the start of any Codewhale work session, or when unsure which checkout, branch, or worktree is authoritative: establish live repo truth before reading a plan or editing a file.

Use before writing code for any Codewhale feature, upgrade, or refactor: find the existing owner of the behavior, bound the change to one reviewable slice, and fix the evidence bar before you start.

Capture screenshots on registered computers, record on macOS or HarmonyOS, and manage saved captures. Probe capabilities before recording.

Report a Codewhale bug or idea as a GitHub issue. Use when: codewhale bug, feature request, feedback on codewhale, report an issue, or this should work differently.

Operate desktop apps and isolated browsers on registered computers. Use for tasks that require an app interface, accessibility, screenshots or recording. Use Chromewhale for the user's signed-in Chrome.

Read and act on selected Chrome tabs and frames — their real browser, their logged-in sessions. Use for questions about the current page, filling a form the user is on, following a link they mentioned, or checking what a site actually renders. Not for…

Explain an unfamiliar repository, find where to make a change, and maintain source-cited documentation. Use for repo onboarding, wiki questions, documentation impact, or updating and sharing a WhaleWiki.

Scaffold a local Codewhale plugin bundle with a versioned manifest, namespaced Skills, and an explicit trust review.

Analyze one recorded agent session the way the Whalesong instrument does — signal shape first, computed findings second, exact evidence rows last. Use when the user asks what a session did, why it stalled, looped, errored, or burned tokens.

Render a recorded agent session to audio with Whalesong's deterministic synthesizer and interpret it — hear a loop, a stall, an error storm, or the difference between two runs. Use when the user wants to feel a session's shape, compare runs by ear, or present…

Quantify periodicity in a recorded agent session — dominant onset period in seconds, spectral entropy, autocorrelation lag. Use to prove a poll loop, measure how metronomic retries are, compare cadence between runs, or window into one suspicious stretch.

Sweep recent sessions across every agent CLI recorded in Whalesong and surface the ones worth a look — errors, runaway loops, token blowouts, stalled gaps. Use for "what have my agents been doing", morning reviews, or finding the session that went wrong.