ai-toolkit

Smart entry point for the Spartan AI Toolkit. Detects project context, routes to the right workflow or command. Use this when you're not sure where to start.

Structured brainstorming — generate ideas, filter fast, rank the top 3

Analyze an existing codebase and generate a structured context map + onboarding spec before making any changes. Use when joining a legacy project or unfamiliar service.

Build a new feature end-to-end — backend, frontend, or full-stack with auto-detection

Activate destructive operation warnings. Claude will detect and require explicit confirmation before running dangerous commands like rm -rf, DROP TABLE, force-push, git reset --hard, overwriting migrations, or deleting production resources.

UI/UX designer that uses external AI (Gemini) for design ideation and asset generation, then produces design docs and prototypes. Reads project design-config.md for brand context.

Design reviewer that catches AI-generic patterns, checks brand compliance, accessibility, and responsive behavior. Works with the designer in a discussion loop for the Design Gate. <example> Context: Designer just created a design doc for a new dashboard screen. user: "Review this design for the Design Gate" assistant: "I'll use the design-critic agent to evaluate the design for AI-generic patterns and brand compliance." </example> <example> Context: /spartan:ux prototype command needs a second opinion on the UI. user: "Run the design critic on this feature" assistant: "I'll spawn the design-critic to review the design doc and give a verdict." </example>

The harshest idea critic. Tries to kill your idea before the market does. Use when you need someone to find every flaw.

Use this agent when you need expert guidance on AWS infrastructure with Terraform, including VPC design, EKS/ECS clusters, RDS databases, ElastiCache, S3, IAM, and OIDC patterns. This agent excels at reviewing Terraform code, designing infrastructure modules, optimizing cloud architecture, and troubleshooting deployment issues. Examples: <example> Context: User needs help designing a service's infrastructure user: "I need to set up RDS and Redis for a new microservice" assistant: "I'll use the infrastructure-expert agent to design the database and cache infrastructure following Spartan conventions." <commentary> Since this involves AWS infrastructure design with Terraform, the infrastructure-expert agent should be used. </commentary> </example> <example> Context: User is debugging a Terraform state issue user: "Terraform plan shows resources being recreated unexpectedly" assistant: "Let me engage the infrastructure-expert agent to diagnose the state drift and recommend a fix." <commentary> State management issues require deep Terraform expertise from the infrastructure-expert agent. </commentary> </example> <example> Context: User needs help with EKS IRSA configuration user: "How should I set up IAM roles for my service pods?" assistant: "I'll use the infrastructure-expert agent to design the IRSA configuration following security best practices." <commentary> IRSA and IAM patterns require the infrastructure-expert agent's security expertise. </commentary> </example>

Use this agent when you need expert guidance on backend development with the Micronaut framework, database design decisions, API architecture, or when bridging backend and frontend concerns. This agent excels at reviewing Micronaut-specific code, optimizing database schemas, designing RESTful APIs, implementing microservices patterns, and providing full-stack architectural recommendations. Examples: <example> Context: User needs help with a Micronaut controller implementation user: "I need to create a new endpoint for user authentication" assistant: "I'll use the micronaut-backend-expert agent to help design and implement this authentication endpoint properly." <commentary> Since this involves Micronaut-specific backend work, the micronaut-backend-expert agent should be used. </commentary> </example> <example> Context: User is working on database optimization user: "Can you review my database schema for the user_profiles table?" assistant: "Let me engage the micronaut-backend-expert agent to analyze your database schema and suggest optimizations." <commentary> Database design review requires the specialized knowledge of the micronaut-backend-expert agent. </commentary> </example> <example> Context: User needs help with Micronaut dependency injection user: "How should I structure my service layer with Micronaut's DI?" assistant: "I'll use the micronaut-backend-expert agent to provide guidance on Micronaut's compile-time dependency injection patterns." <commentary> Micronaut-specific DI patterns require the framework expertise of the micronaut-backend-expert agent. </commentary> </example>

Creates RPC-style endpoint following layered architecture (Controller → Manager → Repository). Use when creating new API endpoints or CRUD operations.

Write blog posts, guides, tutorials, and long-form content. Sounds like a real person, not AI. Use when the user wants polished written content.

Design RPC-style APIs with layered architecture (Controller → Manager → Repository). Use when creating new API endpoints, designing API contracts, or reviewing API patterns.

Run a structured brainstorm session for startup ideas. Takes a theme or problem and generates ideas with quick gut-checks. Use when the user wants to explore a space or generate new ideas.

Run real browser QA with Playwright. Use when testing a frontend feature, verifying UI before PR, smoke testing after deploy, or investigating reported visual bugs.