mags

Validates code-documentation consistency. Use this agent when a feature is completed, before creating a PR, or when /mags-docs validate is called. Checks that code changes are reflected in documentation and identifies stale or missing doc sections. Examples: <example>Context: User completed a feature. user: "I finished the payment module, check if docs are up to date" assistant: "I'll validate documentation consistency with the codebase."</example> <example>Context: Before PR creation. user: "Validate docs before I create the PR" assistant: "Let me run the doc-sync-validator to check for stale or missing documentation."</example> <example>Context: Routine check. user: "Are my docs in sync with the code?" assistant: "I'll check documentation-code consistency."</example>

Analyzes a project and recommends optimal Claude Code setup including plugins, skills, hooks, and CLAUDE.md configuration. Use when setting up a new project with Claude Code, when running /mags-setup, or when the user asks about optimizing their development workflow. Examples: <example>Context: User wants to set up Claude Code for their project. user: "How should I configure Claude Code for this project?" assistant: "Let me analyze your project and recommend the optimal setup."</example> <example>Context: User is starting a new project. user: "Set up MAGS for this repo" assistant: "I'll use the setup-recommender agent to analyze your project."</example> <example>Context: User wants to optimize workflow. user: "What plugins and hooks should I use?" assistant: "Let me recommend the best configuration for your stack."</example>

Provides API design and lifecycle management guidance including versioning, deprecation, rate limiting, and documentation standards. Triggers on api design, rest api, graphql, api versioning, deprecation, breaking changes, rate limiting, api lifecycle, api documentation, openapi.

Provides guidance on creating and maintaining CLAUDE.md project configuration files for Claude Code. Use when setting up a new project, configuring Claude Code behavior, or updating project rules and conventions. Triggers on creating CLAUDE.md, project setup, Claude Code configuration, project rules, project conventions, module map, tech stack definition.

Provides document management guidance for creating, updating, and maintaining project documentation. Use when writing or editing docs, structuring markdown files, managing document lifecycle, or applying formatting standards. Triggers on creating docs, updating docs, writing documentation, markdown formatting, frontmatter, document status, cross-references, naming conventions.

Provides infrastructure and DevOps guidance including deployment, CI/CD, monitoring, containerization, and cloud architecture. Triggers on infrastructure, devops, deployment, docker, kubernetes, ci/cd, monitoring, observability, cloud, scaling, load balancing.

Generate changelog from git history and project docs