mtk-agent-toolkit AGENTS.md

MTK Agent Routing

Compatible with: Claude Code, Codex CLI, Cursor, Copilot, Windsurf, and other AI coding tools that read AGENTS.md.

This repository uses skills as both user-facing entry points and reusable workflow blocks, and agents as specialist reviewers. There are two user-invocable slash commands — /mtk-setup (first-time setup + re-audit) and /mtk <description> (router for everything else). Workflow skills are composed by these entry points.

Routing Decision Tree

flowchart TD
    START["New task"] --> Q1{"What kind<br/>of task?"}

    Q1 -- "New feature /<br/>breaking change /<br/>> 3 files" --> FEAT["Load skills:"]
    Q1 -- "Bug / regression /<br/>failing test" --> BUG["Load skills:"]
    Q1 -- "Code review /<br/>PR review /<br/>quality audit" --> REV["Load skills:"]
    Q1 -- "Creating or<br/>modifying a skill" --> SKILL["Load skills:"]
    Q1 -- "Engineer corrects<br/>your approach" --> CORR["correction-capture"]
    Q1 -- "You struggled 2+ times,<br/>then found what works" --> GOLD["golden-path-capture"]

    FEAT --> F1["context-engineering"]
    F1 --> F1b["brainstorming<br/><i>if approach unclear</i>"]
    F1b --> F2["spec-driven-development"]
    F2 --> F3["planning-and-task-breakdown"]
    F3 --> F4["incremental-implementation"]
    F4 --> F5["test-driven-development"]
    F5 --> F6["source-driven-development<br/><i>if framework uncertain</i>"]
    F6 --> F7["verification-before-completion"]
    F7 --> F8["using-git-worktrees<br/><i>if isolation needed</i>"]

    BUG --> B1["context-engineering"]
    B1 --> B2["debugging-and-error-recovery"]
    B2 --> B3["test-driven-development<br/><i>if behavior changes</i>"]
    B3 --> B4["verification-before-completion"]

    REV --> R1["context-engineering"]
    R1 --> R2["code-review-and-quality"]
    R2 --> R3["security-and-hardening<br/><i>if auth/secrets/audited state</i>"]

    SKILL --> S1["writing-skills"]
    S1 --> S2["Create pressure tests<br/>in tests/pressure-tests/"]