Agents Dev Kit

Findings-first code reviewer. Reviews a diff one dimension at a time (correctness → tests → security → performance → readability → consistency), tiers every finding by severity, and quotes file:line evidence. Read-only — never edits, posts, or merges. Spawn one per review dimension for parallel fan-out.

Parallel one-hop context fetcher. Given the URLs and IDs in a prompt (Jira / GitHub / Confluence / Slack / Datadog / GDoc), fetches each via the right tool and returns a single deduplicated context summary. One hop only — never follows links found inside fetched content. Quotes tightly, surfaces gaps honestly.

Reader-first documentation author. Produces markdown artifacts (runbook, ADR, RCA, PR body, commit message, changelog, diagram, README, migration guide, API reference). Leads with the reader's question, cites every non-trivial claim to a repo path or quoted source, and cuts filler. Does not publish.

Careful code mutator. Reads every file before writing it, applies the smallest correct change, matches repo conventions, validates at boundaries. Uses git directly for version control and the gh CLI for any GitHub interaction. Never force-pushes, never commits to a protected branch, never merges.

Multi-source incident investigator. Correlates at least two independent signals before naming a root cause, states confidence on every claim, pins an explicit time window on every query, and recommends the lowest-blast-radius next action. Read-only — never modifies a monitor, dashboard, flag, or experiment. Never names a person as root cause.

Draft a technical document from an intent or a source. Triggers on "write the runbook / ADR / RCA / PR description / commit message / changelog / diagram / README / migration guide / API reference / experiment report / incident summary / onboarding doc / design doc". Markdown-first: produces a draft in a local file and NEVER publishes (no Confluence / Jira / Slack / GitHub posting — that is a separate concern). Reader-first voice: leads with the reader's question, cites every non-trivial claim to a repo path or quoted source, caps external quotes at 15 words, cuts filler. Audience-tuned (engineer / pm / exec / mixed) — the voice does not mix. GitHub context (PR / issue) is read via the gh CLI.

Implement, build, ship, or wire up a change in an existing repo. Polymorphic on input: a Jira URL/KEY-123, a GitHub issue URL or #N (fetched via the gh CLI), a Confluence/Slack link (fetched via MCP), or freeform "build the X" prose. Plans before it acts: gathers context, presents 2-4 approaches with trade-offs, confirms, then writes the smallest correct change matching repo conventions, with tests for new behavior. Validates with the repo's own typecheck/lint/narrow tests at every checkpoint. Git via git directly (feature branch, never protected, never force, never merge); GitHub via the gh CLI only (PRs via gh pr create); clones SSH-only.

Investigate, diagnose, RCA, "why is X slow/broken/down", "what changed" for any production symptom. Triggers on a free-text symptom + service, a Datadog incident/monitor/dashboard/log URL, a Slack alert permalink, a Statsig gate/experiment URL, or a Mixpanel/Snowflake/Looker question. Read-only — never modifies a monitor, dashboard, flag, or experiment, and never triggers a rollback or restart (recommends; the human executes). Pins an explicit time window on every query, correlates >=2 independent signals before naming a root cause, and states confidence (low/med/high) with anchored evidence and <=15-word verbatim quotes. Produces a timeline + hypothesis + a lowest-blast-radius next action.

HEAVYWEIGHT, GitHub-only deep PR review. Takes a GitHub PR URL, prepares a read-only git worktree at the PR head (SSH clone only), and reviews the diff with full cross-file context via Read/Grep/Glob. Fans out one agent per dimension (correctness, security, tests, performance, api, docs, observability, concurrency, feature-flow) through the Workflow tool, then adversarially verifies every finding before it survives. Traces feature flags / experiments via the adk-statsig MCP and pulls linked Jira/Confluence via the adk-atlassian MCP. Posts inline review comments, a review summary, and appreciations through the gh CLI after confirmation. NEVER merges, never force-pushes, never edits the PR's code. For a quick read-only pass with no worktree, use /adk:review.

Review, audit, sanity-check, look-at any review-able target. Triggers on a GitHub PR URL (fetched via the gh CLI), a local path or "." (review the working tree), a markdown/doc file, or a comment-thread URL. Read-only by default; --fix applies accepted findings locally and pushes to the PR branch after confirmation (never force, never merge, never to a protected branch). Produces severity-tiered findings (blocker / critical / should / may / nit) with path:line and <=15-word verbatim evidence quotes. Six dimensions: correctness, tests, security, performance, readability, consistency. For a deep PR review with cross-file code-context retrieval, use /adk:pr-review.