machine

Default eager-generalist agent for this repo. Whole-toolbelt, bias-to-verify generalist that routes domain work to specialists. Reads /.machine for this project's identity, laws, glossary, and persona panel. Inherits every tool.

DDD (Domain-Driven Development) implementation specialist for the ANALYZE-PRESERVE-IMPROVE cycle on existing code with minimal test coverage. Consider invoking when a change genuinely needs this depth — a multi-file, behavior-preserving refactor of legacy code — not on keyword match alone. Signals: refactoring, legacy code, behavior preservation, characterization tests, domain-driven refactoring. For a localized or single-file edit the generalist should just do it inline. Not for: greenfield (use manager-tdd), deployment, docs, git operations, security audits. --deepthink: engage extended reasoning for refactoring strategy and behavior preservation.

TDD (Test-Driven Development) implementation specialist for the RED-GREEN-REFACTOR cycle; default methodology for substantial new feature work. Consider invoking when a new feature is large enough that test-first earns its keep — a multi-file or methodology-worthy build — not on keyword match alone. Signals: TDD, test-first, red-green-refactor, new feature, specification test, greenfield. For a one-liner or localized change the generalist should just do it inline. Not for: legacy refactoring (use manager-ddd), deployment, docs, git operations, security audits. --deepthink: engage extended reasoning for test strategy and coverage.

The drill — drill-first driver. The main loop that refines a request with the user one question at a time until the shape is valid. From that agreement the job runs autonomously: a plan subagent writes a markdown brief, a miner implements it on a git-fs branch inside the orchestrator's worktree, and the gate iterates until green, followed by one consolidated advisory review (personas + codex). The drill surfaces only to land the work into main, plus on any blocker it cannot resolve. The live roster lives in the hub (claims + board), not on disk. Use as the session driver: "drill mode", "orchestrator mode", "background this", "spawn an agent for this", "drive this".

Agent creation specialist — subagent definitions, blueprints, frontmatter, capability boundaries. Consider invoking when authoring or substantially reworking an agent; for a trivial frontmatter edit the generalist can do it inline. Signals: create agent, new agent, agent blueprint, subagent, agent definition, custom agent. Not for: skill creation (use builder-skill), plugin creation (use builder-plugin), code, testing, docs. --deepthink: engage extended reasoning for agent design and integration patterns.

Ultra-compressed comm mode. ~75% token cut. Levels: lite, full (default), ultra. Trigger: "caveman mode", "talk like caveman", "use caveman", "less tokens", "be brief", `/caveman`. Auto-active when token efficiency requested.

Cheatsheet lookup via cht.sh — the tmux + cht.sh + fzf tool. Ships a `cht` script with an interactive fzf picker (topic, then query) and a direct mode (`cht python reverse a list`, `cht tar extract`). Use when the user wants a quick syntax reminder, a command flag, an idiom, or a one-liner for a language or CLI tool. Trigger: "/cheat", "cheatsheet for X", "how do I X in <lang>", "cht.sh <topic>", "remind me the flags for <command>".

Source cleanup pass — drive code toward zero duplication, minimum file count, single responsibility per file. One atomic cleanup per commit, project gate green between steps. Use for "clean this up", dead-code sweeps, and dedupe/consolidate passes.

Architect-mode for non-trivial features, refactors, bug fixes. Bundles KISS/DRY/YAGNI, phased planning (orient → align → glossary → PRD → TDD → design+delegate), adversarial self-review, incremental push. Use when starting any non-trivial change, codebase drifts, or "AI did wrong thing"/"code keeps getting worse" symptoms. Skip one-line fixes, throwaway spikes, exploratory reads.

Second-AI review via the Codex CLI at the drill's single review point — the consolidated review of the finished diff, alongside the persona panel, before a landing is proposed. Advisory only: it returns notes and concerns for the driver and user to weigh, it never gates, blocks, merges, or edits. Skips cleanly when codex is not installed. Trigger via "/codex-review", "codex review", "second opinion from codex", or invoked by the drill skill.

4 hooks across 3 events

Personal technical learning tutor grounded in official documentation via Context7 MCP. Explains concepts using analogies, generates markdown study notes with Mermaid diagrams in .machine/learning/, and optionally syncs lectures to Notion for mobile learning. Audits your understanding instead of just feeding answers.

Agentic coding orchestrator that merges strategic delegation with pair programming collaboration. Clarifies intent via Socratic inquiry, delegates to specialists, gates every change through checkpoint verification, and prevents dark-flow over-engineering. Built for long-horizon multi-hour coding sessions.