root/brutal-critic.md
Deliver a ruthless editorial or code critique before anything ships.
Run any agent
| Tool | How to launch | Example |
|---|---|---|
| Claude Code | Type @filename.md or run /tool run path/to/file.md | @tech-lead-orchestrator.md |
| Gemini CLI | gemini agent --file agents/category/file.md | gemini agent --file agents/orchestration/tech-lead-orchestrator.md |
| Codex CLI | codex agent agents/category/file.md | codex agent agents/quality/code-reviewer.md --input git.diff |
| OpenCode | Use the agent picker and select the markdown file from the toolkit | Search for "tech-lead-orchestrator" |
| Cursor | Drag the file into chat or reference it via @tech-lead-orchestrator.md | Follow the returned plan |
Every agent lives inside a categorized folder under AI-toolkit/agents/. The sections below map each persona to its folder and ideal use case.
Root essentials (`agents/root/`)
root/general-research-agent.md
Perform structured research with citations, comparisons, and exportable data.
root/home-lab-guru.md
Design or troubleshoot homelab and edge infrastructure projects.
root/reliability-commander.md
Enforce release readiness, incident response, and operational guardrails.
root/session-closer.md
Wrap work blocks with outcomes, deliverables, and next steps.
root/session-restorer.md
Rebuild context quickly after pauses, handoffs, or incidents.
Planning & orchestration (`agents/orchestration/`)
| Agent | Use when | Key outputs |
|---|---|---|
orchestration/tech-lead-orchestrator.md | Breaking down complex work | Execution graph, staffing plan, next actions |
orchestration/project-analyst.md | Exploring unfamiliar repos | Stack detection, dependency map, risk report |
orchestration/project-task-planner.md | Turning briefs/PRDs into sprints | Phase plan with estimates and owners |
orchestration/team-configurator.md | Reconfiguring your AI team | Recommended agents, collaboration protocol |
orchestration/code-archaeologist.md | Assessing legacy or high-risk systems | Architecture map, technical debt backlog |
Quality, security & performance (`agents/quality/`)
| Agent | Focus | Typical timing |
|---|---|---|
quality/code-reviewer.md | Severity-tagged implementation review | Before merging substantial work |
quality/code-refactorer.md | Safe restructuring without behaviour changes | After features land or tech debt reviews |
quality/testing-expert.md | Test strategy and automation coverage | Planning QA or raising quality bars |
quality/performance-optimizer.md | Profiling, bottleneck fixes, cost control | Facing regressions or scaling events |
quality/performance-expert.md | Python performance architecture | Need systemic tuning or concurrency strategy |
quality/security-auditor.md | Full-stack security assessment | Pre-release, compliance, or after major change |
quality/security-expert.md | Secure coding, cryptography, compliance | Designing auth flows or handling sensitive data |
Product, docs & comms (`agents/product-docs/`)
| Agent | Output | Use when |
|---|---|---|
product-docs/content-writer.md | Articles, release notes, stakeholder updates | Translating technical wins into narratives |
product-docs/documentation-specialist.md | Structured project documentation | Formalising READMEs, API docs, or architecture guides |
product-docs/prd-writer.md | Product Requirements Documents | Capturing goals, personas, and acceptance criteria |
Build specialists (`agents/build-specialists/`)
| Agent | Focus | Use when |
|---|---|---|
build-specialists/backend-developer.md | Framework-agnostic backend delivery | Need production-grade server-side features |
build-specialists/frontend-developer.md | Framework-agnostic UI engineering | Deliver responsive, accessible UI work |
build-specialists/api-architect.md | API contract and integration design | Defining or refactoring REST/GraphQL surfaces |
build-specialists/python-expert.md | Python architecture and tooling | Large-scale Python features or refactors |
build-specialists/fastapi-expert.md | Async FastAPI services | Designing/tuning high-performance APIs |
build-specialists/devops-cicd-expert.md | CI/CD, automation, IaC | Pipeline design, containerisation, infra hygiene |
build-specialists/ml-data-expert.md | ML and data science workflows | Building data pipelines, running experiments |
build-specialists/web-scraping-expert.md | Resilient scraping and automation | Collecting data at scale with anti-blocking strategies |
Design & experience (`agents/design-experience/`)
| Agent | Focus | Use when |
|---|---|---|
design-experience/frontend-designer.md | Translate mockups into implementation plans | Need component architecture from design assets |
design-experience/tailwind-css-expert.md | Tailwind CSS strategy | Utility-first styling or responsive refactors |
design-experience/vibe-coding-coach.md | Vision-to-build guide | Working from “vibes”, inspirations, or conversational specs |
Framework specialists (`agents/frameworks/`)
Django
frameworks/django/django-expert.mdframeworks/django/django-backend-expert.mdframeworks/django/django-api-developer.mdframeworks/django/django-orm-expert.md
Rails
frameworks/rails/rails-backend-expert.mdframeworks/rails/rails-api-developer.mdframeworks/rails/rails-activerecord-expert.md
Laravel
frameworks/laravel/laravel-backend-expert.mdframeworks/laravel/laravel-eloquent-expert.md
React & Next.js
frameworks/react/react-component-architect.mdframeworks/react/react-nextjs-expert.md
Vue & Nuxt
frameworks/vue/vue-component-architect.mdframeworks/vue/vue-state-manager.mdframeworks/vue/vue-nuxt-expert.md
Full agent catalog (A–Z)
| Path | Description |
|---|---|
build-specialists/api-architect.md | Designs service contracts, integration boundaries, and versioning approaches. |
build-specialists/backend-developer.md | General backend partner for implementing business logic, APIs, and services. |
root/brutal-critic.md | Blunt reviewer delivering qualitative critique plus JSON-scored feedback. |
orchestration/code-archaeologist.md | Maps legacy or unfamiliar codebases to document structure, ownership, and risks. |
quality/code-refactorer.md | Plans safe refactors that improve clarity without breaking behaviour. |
quality/code-reviewer.md | Runs structured reviews with severity tags, remediation steps, and testing gaps. |
product-docs/content-writer.md | Transforms technical notes into customer-facing articles or support docs. |
build-specialists/devops-cicd-expert.md | Optimises CI/CD pipelines, deployment strategies, and automation workflows. |
frameworks/django/django-api-developer.md | Builds Django REST endpoints, serializers, and permissions. |
frameworks/django/django-backend-expert.md | Handles complex Django backend features, integrations, and scaling concerns. |
frameworks/django/django-expert.md | Full-stack Django guidance covering apps, settings, and deployments. |
frameworks/django/django-orm-expert.md | Solves ORM modelling issues, query optimisation, and migration planning. |
product-docs/documentation-specialist.md | Keeps READMEs, API references, and architecture docs consistent. |
design-experience/frontend-designer.md | Translates visual direction into component specs and implementation notes. |
build-specialists/frontend-developer.md | Generalist frontend support for modern component-based stacks. |
root/general-research-agent.md | Performs deep technical or competitive research and synthesises findings. |
root/home-lab-guru.md | Advises on homelab setups, networking, automation, and observability. |
frameworks/laravel/laravel-backend-expert.md | Architects advanced Laravel features, services, and testing strategy. |
frameworks/laravel/laravel-eloquent-expert.md | Optimises Eloquent models, relationships, scopes, and database usage. |
build-specialists/ml-data-expert.md | Guides machine learning pipelines, experimentation, and data workflows. |
quality/performance-expert.md | Creates cross-layer performance roadmaps and tuning priorities. |
quality/performance-optimizer.md | Pinpoints specific bottlenecks using profiling data and suggests fixes. |
product-docs/prd-writer.md | Produces comprehensive product requirement documents with success metrics. |
orchestration/project-analyst.md | Audits repositories to surface tech stack, dependencies, and risks. |
orchestration/project-task-planner.md | Breaks PRDs or briefs into phased engineering task lists. |
build-specialists/python-expert.md | Advises on Python architecture, packaging, tooling, and best practices. |
frameworks/rails/rails-activerecord-expert.md | Improves ActiveRecord models, queries, and database performance. |
frameworks/rails/rails-api-developer.md | Implements Rails API endpoints, serializers, and authentication flows. |
frameworks/rails/rails-backend-expert.md | Guides complex Rails backend work, integrations, and scaling. |
root/reliability-commander.md | Enforces process guardrails, readiness checklists, and quality bars. |
frameworks/react/react-component-architect.md | Designs composable React component systems and abstractions. |
frameworks/react/react-nextjs-expert.md | Handles Next.js routing, rendering modes, and performance optimisation. |
quality/security-auditor.md | Executes security reviews, ranks severity, and outlines remediation. |
quality/security-expert.md | Supports secure design, policy creation, and threat mitigation. |
root/session-closer.md | Documents outcomes, deliverables, and next steps at session end. |
root/session-restorer.md | Rebuilds context to restart paused workstreams quickly. |
design-experience/tailwind-css-expert.md | Creates Tailwind utility strategies and component styling guidelines. |
orchestration/team-configurator.md | Configures multi-agent collaboration, handoffs, and escalation paths. |
orchestration/tech-lead-orchestrator.md | Produces the execution graph, sequencing, and agent assignments. |
quality/testing-expert.md | Improves test plans, coverage, automation, and tooling. |
design-experience/vibe-coding-coach.md | Aligns creative direction or “vibes” with concrete engineering tasks. |
frameworks/vue/vue-component-architect.md | Designs scalable Vue component hierarchies and patterns. |
frameworks/vue/vue-nuxt-expert.md | Guides Nuxt universal apps, routing, data fetching, and deployments. |
frameworks/vue/vue-state-manager.md | Advises on Vuex/Pinia store structure, mutations, and modularity. |
build-specialists/web-scraping-expert.md | Builds resilient scraping pipelines with anti-blocking strategies. |
Export this table if you need a CSV/JSON catalogue for quick lookup in your own dashboards.