@qazuor/claude-code-config 0.1.0

package/templates/agents/README.md

@@ -0,0 +1,164 @@
+# AI Agents
+
+This directory contains **specialized AI agents** that can be configured for any project. Each agent is an expert in specific areas and can be invoked during development workflow.
+
+## ⚙️ Configuration Required
+
+All agents include a `config_required` section in their YAML frontmatter. Before using an agent, ensure you've configured the required settings in your project's `CLAUDE.md` or configuration files.
+
+**Example agent frontmatter:**
+```yaml
+---
+name: agent-name
+description: Brief description
+tools: Read, Write, Edit, Glob, Grep, Bash
+model: sonnet
+config_required:
+  - setting_name: "Description of what to configure"
+---
+```
+
+## Agent Categories
+
+### Product & Planning (2 agents)
+
+| Agent | Description | Phase |
+|-------|-------------|-------|
+| [product-functional](product/product-functional.md) | Creates PDRs with user stories and acceptance criteria | Phase 1 |
+| [product-technical](product/product-technical.md) | Technical analysis, architecture design, task breakdown | Phase 1 |
+
+### Technical Leadership (1 agent)
+
+| Agent | Description | Phase |
+|-------|-------------|-------|
+| [tech-lead](engineering/tech-lead.md) | Architectural oversight, code quality, security/performance validation | All |
+
+### Backend Development (6 agents)
+
+| Agent | Description | Phase |
+|-------|-------------|-------|
+| [hono-engineer](engineering/hono-engineer.md) | API development with Hono framework | Phase 2 |
+| [express-engineer](engineering/express-engineer.md) | API development with Express framework | Phase 2 |
+| [fastify-engineer](engineering/fastify-engineer.md) | API development with Fastify framework | Phase 2 |
+| [nestjs-engineer](engineering/nestjs-engineer.md) | API development with NestJS framework | Phase 2 |
+| [db-drizzle-engineer](engineering/db-drizzle-engineer.md) | Database schemas with Drizzle ORM | Phase 2 |
+| [mongoose-engineer](engineering/mongoose-engineer.md) | Database schemas with Mongoose ODM | Phase 2 |
+| [prisma-engineer](engineering/prisma-engineer.md) | Database schemas with Prisma ORM | Phase 2 |
+| [node-typescript-engineer](engineering/node-typescript-engineer.md) | Shared packages, utilities, Node.js/TypeScript | Phase 2 |
+
+### Frontend Development (4 agents)
+
+| Agent | Description | Phase |
+|-------|-------------|-------|
+| [astro-engineer](engineering/astro-engineer.md) | Web apps with Astro, SSR, static generation | Phase 2 |
+| [nextjs-engineer](engineering/nextjs-engineer.md) | Web apps with Next.js | Phase 2 |
+| [react-senior-dev](engineering/react-senior-dev.md) | React components, hooks, state management | Phase 2 |
+| [tanstack-start-engineer](engineering/tanstack-start-engineer.md) | Admin dashboards with TanStack Start | Phase 2 |
+
+### Design & UX (2 agents)
+
+| Agent | Description | Phase |
+|-------|-------------|-------|
+| [ux-ui-designer](design/ux-ui-designer.md) | UI design, user flows, accessibility | Phase 1, 3 |
+| [content-writer](design/content-writer.md) | Web content, copywriting, tone of voice | All |
+
+### Quality Assurance (2 agents)
+
+| Agent | Description | Phase |
+|-------|-------------|-------|
+| [qa-engineer](quality/qa-engineer.md) | Testing strategy, quality validation | Phase 3 |
+| [debugger](quality/debugger.md) | Bug investigation, root cause analysis | Phase 3 |
+
+### Specialized (4 agents)
+
+| Agent | Description | Phase |
+|-------|-------------|-------|
+| [tech-writer](specialized/tech-writer.md) | Documentation, API docs, changelogs | Phase 4 |
+| [i18n-specialist](specialized/i18n-specialist.md) | Internationalization, translations | All |
+| [enrichment-agent](specialized/enrichment-agent.md) | Issue enrichment, planning context | Planning |
+| [seo-ai-specialist](specialized/seo-ai-specialist.md) | SEO, Core Web Vitals, structured data | All |
+
+## Usage
+
+Invoke agents using the Task tool:
+
+```text
+Use the Task tool with subagent_type="agent-name"
+```
+
+**Examples:**
+```text
+"Invoke product-functional to create the PDR"
+"Use tech-lead to review architecture"
+"Call db-drizzle-engineer to design database schema"
+```
+
+## Agent File Format
+
+Each agent file includes:
+
+1. **YAML Frontmatter**
+   - `name`: Unique identifier (kebab-case)
+   - `description`: When to invoke the agent
+   - `tools`: Allowed tools (comma-separated)
+   - `model`: sonnet/opus/haiku (optional)
+   - `config_required`: Configuration directives
+
+2. **Configuration Section**
+   - Table of required settings
+   - Examples for each setting
+
+3. **Agent Content**
+   - Role and responsibilities
+   - Core workflow
+   - Best practices
+   - Quality checklist
+
+## Directory Structure
+
+```text
+agents/
+├── README.md
+├── product/
+│   ├── product-functional.md
+│   └── product-technical.md
+├── engineering/
+│   ├── tech-lead.md
+│   ├── hono-engineer.md
+│   ├── express-engineer.md
+│   ├── fastify-engineer.md
+│   ├── nestjs-engineer.md
+│   ├── db-drizzle-engineer.md
+│   ├── mongoose-engineer.md
+│   ├── prisma-engineer.md
+│   ├── node-typescript-engineer.md
+│   ├── astro-engineer.md
+│   ├── nextjs-engineer.md
+│   ├── react-senior-dev.md
+│   └── tanstack-start-engineer.md
+├── quality/
+│   ├── qa-engineer.md
+│   └── debugger.md
+├── design/
+│   ├── ux-ui-designer.md
+│   └── content-writer.md
+└── specialized/
+    ├── tech-writer.md
+    ├── i18n-specialist.md
+    ├── enrichment-agent.md
+    └── seo-ai-specialist.md
+```
+
+## Adding New Agents
+
+1. Create `.md` file in appropriate category folder
+2. Use naming convention: `kebab-case-name.md`
+3. Include YAML frontmatter with `config_required`
+4. Add `⚙️ Configuration` section with settings table
+5. Keep content concise (200-400 lines target)
+6. Update this README
+
+## Related
+
+- [Commands](../commands/README.md)
+- [Skills](../skills/README.md)

package/templates/agents/_registry.json

@@ -0,0 +1,443 @@
+{
+  "category": "agents",
+  "modules": [
+    {
+      "id": "tech-lead",
+      "name": "Tech Lead",
+      "description": "Principal Software Architect - coordinates all agents, architectural decisions, code review",
+      "file": "engineering/tech-lead.md",
+      "tags": ["core", "leadership", "architecture"],
+      "longDescription": "The Tech Lead agent serves as the principal coordinator for all development activities. It makes high-level architectural decisions, conducts code reviews, and ensures all other agents work cohesively toward project goals.",
+      "whatItDoes": [
+        "Coordinates work between different engineering agents",
+        "Makes architectural decisions and ensures consistency",
+        "Reviews code for quality, patterns, and best practices",
+        "Resolves technical conflicts and ambiguities",
+        "Maintains project-wide standards and conventions"
+      ],
+      "whenToUse": "Essential for any project. This is the orchestrating agent that manages all others.",
+      "skillLevel": "advanced",
+      "relatedModules": ["product-functional", "product-technical", "qa-engineer"]
+    },
+    {
+      "id": "product-functional",
+      "name": "Product Functional",
+      "description": "Creates PDR (Product Definition Reports) with user requirements and functional specs",
+      "file": "product/product-functional.md",
+      "tags": ["product", "requirements", "pdr"],
+      "longDescription": "Translates business needs into detailed Product Definition Reports (PDR). Focuses on user stories, acceptance criteria, and functional specifications without diving into technical implementation.",
+      "whatItDoes": [
+        "Gathers and documents user requirements",
+        "Creates Product Definition Reports (PDR)",
+        "Defines acceptance criteria and success metrics",
+        "Identifies edge cases and user flows",
+        "Prioritizes features based on business value"
+      ],
+      "whenToUse": "When starting new features or projects that need clear requirements definition.",
+      "skillLevel": "intermediate",
+      "relatedModules": ["product-technical", "ux-ui-designer"]
+    },
+    {
+      "id": "product-technical",
+      "name": "Product Technical",
+      "description": "Technical analysis, architecture design, task breakdown from PDR",
+      "file": "product/product-technical.md",
+      "tags": ["product", "architecture", "planning"],
+      "longDescription": "Takes functional requirements from PDR and transforms them into technical specifications. Designs system architecture, creates task breakdowns, and defines technical acceptance criteria.",
+      "whatItDoes": [
+        "Analyzes PDR and creates technical specifications",
+        "Designs system architecture and data models",
+        "Breaks down features into actionable development tasks",
+        "Identifies technical risks and dependencies",
+        "Defines API contracts and integration points"
+      ],
+      "whenToUse": "After Product Functional creates the PDR, use this to plan the technical implementation.",
+      "skillLevel": "advanced",
+      "relatedModules": ["product-functional", "tech-lead", "db-drizzle-engineer"]
+    },
+    {
+      "id": "hono-engineer",
+      "name": "Hono Engineer",
+      "description": "Backend API development with Hono framework",
+      "file": "engineering/hono-engineer.md",
+      "tags": ["backend", "api", "hono"],
+      "longDescription": "Specialized in building high-performance APIs using the Hono framework. Creates RESTful endpoints, handles middleware, and implements business logic with TypeScript.",
+      "whatItDoes": [
+        "Creates RESTful API endpoints with Hono",
+        "Implements middleware for auth, validation, logging",
+        "Handles request/response processing",
+        "Integrates with database and external services",
+        "Implements error handling and response formatting"
+      ],
+      "whenToUse": "When building backend APIs with Hono framework.",
+      "techStack": ["Hono", "TypeScript", "Node.js", "Zod"],
+      "alternativeTo": ["express-engineer", "fastify-engineer", "nestjs-engineer"],
+      "skillLevel": "intermediate",
+      "relatedModules": ["db-drizzle-engineer", "node-typescript-engineer"]
+    },
+    {
+      "id": "express-engineer",
+      "name": "Express Engineer",
+      "description": "Backend API development with Express.js",
+      "file": "engineering/express-engineer.md",
+      "tags": ["backend", "api", "express"],
+      "longDescription": "Specialized in building REST APIs with Express.js. Creates modular routes, middleware chains, and implements robust error handling with TypeScript.",
+      "whatItDoes": [
+        "Creates RESTful API endpoints with Express",
+        "Implements middleware for auth, validation, logging",
+        "Builds controller-service architecture",
+        "Handles async errors and HTTP status codes",
+        "Documents APIs with Swagger/OpenAPI"
+      ],
+      "whenToUse": "When building backend APIs with Express.js.",
+      "techStack": ["Express.js", "TypeScript", "Zod"],
+      "alternativeTo": ["hono-engineer", "fastify-engineer", "nestjs-engineer"],
+      "skillLevel": "intermediate",
+      "relatedModules": ["prisma-engineer", "db-drizzle-engineer", "node-typescript-engineer"]
+    },
+    {
+      "id": "fastify-engineer",
+      "name": "Fastify Engineer",
+      "description": "High-performance API development with Fastify",
+      "file": "engineering/fastify-engineer.md",
+      "tags": ["backend", "api", "fastify"],
+      "longDescription": "Builds high-performance APIs with Fastify's plugin architecture. Uses schema-based validation for automatic type inference and OpenAPI docs.",
+      "whatItDoes": [
+        "Creates typed routes with schema validation",
+        "Builds reusable plugins with encapsulation",
+        "Implements decorators for shared utilities",
+        "Generates OpenAPI docs from schemas",
+        "Optimizes for high-throughput performance"
+      ],
+      "whenToUse": "When building high-performance APIs with Fastify. Excellent for microservices and high-throughput applications.",
+      "techStack": ["Fastify", "TypeBox", "TypeScript"],
+      "alternativeTo": ["hono-engineer", "express-engineer", "nestjs-engineer"],
+      "skillLevel": "intermediate",
+      "relatedModules": ["prisma-engineer", "db-drizzle-engineer", "node-typescript-engineer"]
+    },
+    {
+      "id": "nestjs-engineer",
+      "name": "NestJS Engineer",
+      "description": "Enterprise backend development with NestJS",
+      "file": "engineering/nestjs-engineer.md",
+      "tags": ["backend", "api", "nestjs", "enterprise"],
+      "longDescription": "Builds scalable enterprise applications with NestJS. Uses dependency injection, modular architecture, and enterprise patterns like CQRS.",
+      "whatItDoes": [
+        "Creates modular application architecture",
+        "Implements dependency injection patterns",
+        "Builds guards, interceptors, and pipes",
+        "Creates REST and GraphQL APIs",
+        "Implements enterprise patterns (CQRS, events)"
+      ],
+      "whenToUse": "When building enterprise-scale applications that need strong architecture and dependency injection.",
+      "techStack": ["NestJS", "TypeScript", "class-validator"],
+      "alternativeTo": ["express-engineer", "fastify-engineer", "hono-engineer"],
+      "skillLevel": "advanced",
+      "relatedModules": ["prisma-engineer", "node-typescript-engineer"]
+    },
+    {
+      "id": "db-drizzle-engineer",
+      "name": "DB Drizzle Engineer",
+      "description": "Database design and development with Drizzle ORM",
+      "file": "engineering/db-drizzle-engineer.md",
+      "tags": ["backend", "database", "drizzle"],
+      "longDescription": "Expert in database design and implementation using Drizzle ORM. Handles schema design, migrations, queries, and database optimization with a focus on type safety.",
+      "whatItDoes": [
+        "Designs database schemas with Drizzle",
+        "Creates and manages migrations",
+        "Writes type-safe queries and transactions",
+        "Implements database models and relationships",
+        "Optimizes query performance"
+      ],
+      "whenToUse": "When using Drizzle ORM for database access.",
+      "techStack": ["Drizzle ORM", "PostgreSQL", "SQLite", "MySQL", "TypeScript"],
+      "alternativeTo": ["prisma-engineer", "mongoose-engineer"],
+      "skillLevel": "intermediate",
+      "relatedModules": ["hono-engineer", "node-typescript-engineer"]
+    },
+    {
+      "id": "prisma-engineer",
+      "name": "Prisma Engineer",
+      "description": "Database design and development with Prisma ORM",
+      "file": "engineering/prisma-engineer.md",
+      "tags": ["backend", "database", "prisma"],
+      "longDescription": "Expert in database design using Prisma ORM. Handles schema design, migrations, type-safe queries, and database optimization across multiple database engines.",
+      "whatItDoes": [
+        "Designs database schemas with Prisma",
+        "Creates and manages migrations",
+        "Writes type-safe queries with Prisma Client",
+        "Implements relations and nested operations",
+        "Handles transactions and database optimization"
+      ],
+      "whenToUse": "When using Prisma ORM for database access.",
+      "techStack": ["Prisma", "PostgreSQL", "MySQL", "SQLite", "MongoDB", "TypeScript"],
+      "alternativeTo": ["db-drizzle-engineer", "mongoose-engineer"],
+      "skillLevel": "intermediate",
+      "relatedModules": ["hono-engineer", "express-engineer", "node-typescript-engineer"]
+    },
+    {
+      "id": "mongoose-engineer",
+      "name": "Mongoose Engineer",
+      "description": "MongoDB development with Mongoose ODM",
+      "file": "engineering/mongoose-engineer.md",
+      "tags": ["backend", "database", "mongodb", "mongoose"],
+      "longDescription": "Expert in MongoDB with Mongoose ODM. Designs document schemas, writes aggregation pipelines, and implements NoSQL best practices.",
+      "whatItDoes": [
+        "Designs MongoDB document schemas",
+        "Implements typed models with TypeScript",
+        "Writes aggregation pipelines",
+        "Creates middleware and virtuals",
+        "Optimizes with indexes and query patterns"
+      ],
+      "whenToUse": "When using MongoDB as your database.",
+      "techStack": ["Mongoose", "MongoDB", "TypeScript"],
+      "alternativeTo": ["prisma-engineer", "db-drizzle-engineer"],
+      "skillLevel": "intermediate",
+      "relatedModules": ["express-engineer", "fastify-engineer", "node-typescript-engineer"]
+    },
+    {
+      "id": "node-typescript-engineer",
+      "name": "Node TypeScript Engineer",
+      "description": "Shared packages and Node.js TypeScript development",
+      "file": "engineering/node-typescript-engineer.md",
+      "tags": ["backend", "shared", "typescript"],
+      "longDescription": "Develops shared TypeScript packages, utilities, and core business logic. Focuses on code reusability, type safety, and clean architecture patterns.",
+      "whatItDoes": [
+        "Creates shared utility packages",
+        "Implements core business logic",
+        "Designs reusable type definitions",
+        "Builds validation schemas with Zod",
+        "Creates configuration and constants"
+      ],
+      "whenToUse": "For any shared code, utilities, or packages that are used across different parts of the application.",
+      "techStack": ["TypeScript", "Node.js", "Zod", "ESM"],
+      "skillLevel": "intermediate",
+      "relatedModules": ["hono-engineer", "db-drizzle-engineer", "react-senior-dev"]
+    },
+    {
+      "id": "astro-engineer",
+      "name": "Astro Engineer",
+      "description": "Astro framework development for static/SSR sites",
+      "file": "engineering/astro-engineer.md",
+      "tags": ["frontend", "astro", "ssr"],
+      "longDescription": "Builds fast, content-focused websites using Astro. Specializes in static site generation, partial hydration, and integrating with various UI frameworks.",
+      "whatItDoes": [
+        "Creates Astro pages and layouts",
+        "Implements content collections",
+        "Configures SSG and SSR modes",
+        "Integrates React/Vue/Svelte components",
+        "Optimizes for performance and SEO"
+      ],
+      "whenToUse": "When building content-focused websites, blogs, or marketing sites with Astro.",
+      "techStack": ["Astro", "TypeScript", "Tailwind CSS", "MDX"],
+      "alternativeTo": ["nextjs-engineer"],
+      "skillLevel": "intermediate",
+      "relatedModules": ["react-senior-dev", "seo-ai-specialist"]
+    },
+    {
+      "id": "nextjs-engineer",
+      "name": "Next.js Engineer",
+      "description": "Full-stack development with Next.js App Router",
+      "file": "engineering/nextjs-engineer.md",
+      "tags": ["frontend", "fullstack", "nextjs"],
+      "longDescription": "Expert in Next.js App Router for building full-stack React applications. Handles Server Components, Server Actions, and data fetching patterns.",
+      "whatItDoes": [
+        "Creates pages with App Router architecture",
+        "Implements Server and Client Components",
+        "Builds Server Actions for form handling",
+        "Handles SSR, SSG, and ISR patterns",
+        "Creates API Routes and middleware"
+      ],
+      "whenToUse": "When building full-stack React applications with Next.js.",
+      "techStack": ["Next.js", "React", "TypeScript", "Tailwind CSS", "Server Actions"],
+      "alternativeTo": ["tanstack-start-engineer", "astro-engineer"],
+      "skillLevel": "advanced",
+      "relatedModules": ["react-senior-dev", "prisma-engineer"]
+    },
+    {
+      "id": "tanstack-start-engineer",
+      "name": "TanStack Start Engineer",
+      "description": "TanStack Start/Router development for admin dashboards",
+      "file": "engineering/tanstack-start-engineer.md",
+      "tags": ["frontend", "tanstack", "admin"],
+      "longDescription": "Expert in TanStack Start and Router for building type-safe, full-stack React applications. Specializes in admin dashboards and complex data-driven interfaces.",
+      "whatItDoes": [
+        "Creates routes with TanStack Router",
+        "Implements server functions with TanStack Start",
+        "Builds type-safe data fetching patterns",
+        "Creates admin dashboard layouts",
+        "Implements authentication flows"
+      ],
+      "whenToUse": "When building admin panels or complex React applications with TanStack Start/Router.",
+      "techStack": ["TanStack Start", "TanStack Router", "TanStack Query", "React", "TypeScript"],
+      "alternativeTo": ["nextjs-engineer"],
+      "skillLevel": "advanced",
+      "relatedModules": ["react-senior-dev", "hono-engineer"]
+    },
+    {
+      "id": "react-senior-dev",
+      "name": "React Senior Dev",
+      "description": "React component development and UI architecture",
+      "file": "engineering/react-senior-dev.md",
+      "tags": ["frontend", "react", "components"],
+      "longDescription": "Senior-level React developer focused on component architecture, state management, and UI best practices. Builds reusable, accessible, and performant components.",
+      "whatItDoes": [
+        "Creates reusable React components",
+        "Implements state management patterns",
+        "Builds accessible UI with proper ARIA",
+        "Optimizes component performance",
+        "Creates component libraries and design systems"
+      ],
+      "whenToUse": "For any React-based frontend development, component libraries, or UI architecture.",
+      "techStack": ["React", "TypeScript", "Tailwind CSS", "TanStack Query"],
+      "skillLevel": "advanced",
+      "relatedModules": ["tanstack-start-engineer", "ux-ui-designer", "astro-engineer"]
+    },
+    {
+      "id": "ux-ui-designer",
+      "name": "UX/UI Designer",
+      "description": "User experience and interface design",
+      "file": "design/ux-ui-designer.md",
+      "tags": ["design", "ux", "ui"],
+      "longDescription": "Designs user experiences and interfaces following modern design principles. Creates wireframes, mockups, and design specifications for development teams.",
+      "whatItDoes": [
+        "Creates user flows and wireframes",
+        "Designs responsive UI layouts",
+        "Defines color schemes and typography",
+        "Ensures accessibility compliance",
+        "Creates design specifications for developers"
+      ],
+      "whenToUse": "When designing new features or improving existing user interfaces.",
+      "skillLevel": "intermediate",
+      "relatedModules": ["react-senior-dev", "product-functional", "content-writer"]
+    },
+    {
+      "id": "content-writer",
+      "name": "Content Writer",
+      "description": "Web content, copywriting, and tone of voice",
+      "file": "design/content-writer.md",
+      "tags": ["design", "content", "copywriting"],
+      "longDescription": "Creates compelling web content and copy. Maintains consistent tone of voice, writes marketing copy, and ensures content aligns with brand guidelines.",
+      "whatItDoes": [
+        "Writes web copy and marketing content",
+        "Maintains consistent tone of voice",
+        "Creates microcopy for UI elements",
+        "Writes error messages and notifications",
+        "Develops content strategy"
+      ],
+      "whenToUse": "When creating or improving web content, marketing copy, or UI text.",
+      "skillLevel": "intermediate",
+      "relatedModules": ["ux-ui-designer", "seo-ai-specialist"]
+    },
+    {
+      "id": "qa-engineer",
+      "name": "QA Engineer",
+      "description": "Quality assurance, testing strategy, test automation",
+      "file": "quality/qa-engineer.md",
+      "tags": ["quality", "testing", "qa"],
+      "longDescription": "Ensures software quality through comprehensive testing strategies. Designs test plans, writes automated tests, and validates feature implementations.",
+      "whatItDoes": [
+        "Creates comprehensive test plans",
+        "Writes unit, integration, and E2E tests",
+        "Implements TDD practices (Red-Green-Refactor)",
+        "Validates features against acceptance criteria",
+        "Identifies and documents bugs"
+      ],
+      "whenToUse": "Essential for maintaining code quality. Use throughout development for TDD and after features for validation.",
+      "techStack": ["Vitest", "Playwright", "Testing Library", "MSW"],
+      "skillLevel": "intermediate",
+      "relatedModules": ["tech-lead", "debugger"]
+    },
+    {
+      "id": "debugger",
+      "name": "Debugger",
+      "description": "Bug investigation, root cause analysis, debugging",
+      "file": "quality/debugger.md",
+      "tags": ["quality", "debugging", "bugs"],
+      "longDescription": "Specialized in investigating and resolving bugs. Performs root cause analysis, traces execution flows, and implements fixes with minimal side effects.",
+      "whatItDoes": [
+        "Investigates bug reports and reproduces issues",
+        "Performs root cause analysis",
+        "Traces code execution and data flow",
+        "Implements targeted bug fixes",
+        "Adds regression tests for fixed bugs"
+      ],
+      "whenToUse": "When investigating bugs, unexpected behavior, or production issues.",
+      "skillLevel": "advanced",
+      "relatedModules": ["qa-engineer", "tech-lead"]
+    },
+    {
+      "id": "tech-writer",
+      "name": "Tech Writer",
+      "description": "Technical documentation, API docs, user guides",
+      "file": "specialized/tech-writer.md",
+      "tags": ["specialized", "documentation", "writing"],
+      "longDescription": "Creates clear, comprehensive technical documentation. Writes API documentation, user guides, tutorials, and maintains project documentation.",
+      "whatItDoes": [
+        "Writes API documentation",
+        "Creates user guides and tutorials",
+        "Maintains README and project docs",
+        "Documents architecture decisions (ADRs)",
+        "Creates developer onboarding guides"
+      ],
+      "whenToUse": "When creating or updating documentation, API docs, or user guides.",
+      "skillLevel": "intermediate",
+      "relatedModules": ["tech-lead"]
+    },
+    {
+      "id": "i18n-specialist",
+      "name": "i18n Specialist",
+      "description": "Internationalization, translations, locale management",
+      "file": "specialized/i18n-specialist.md",
+      "tags": ["specialized", "i18n", "translations"],
+      "longDescription": "Expert in internationalization and localization. Manages translations, locale configuration, and ensures proper handling of dates, numbers, and currencies across locales.",
+      "whatItDoes": [
+        "Sets up i18n infrastructure",
+        "Manages translation files",
+        "Handles pluralization and formatting",
+        "Configures locale-specific behavior",
+        "Ensures RTL support where needed"
+      ],
+      "whenToUse": "When building applications that need to support multiple languages or locales.",
+      "skillLevel": "intermediate",
+      "relatedModules": ["react-senior-dev", "nextjs-engineer"]
+    },
+    {
+      "id": "enrichment-agent",
+      "name": "Enrichment Agent",
+      "description": "Issue enrichment, planning context, data gathering",
+      "file": "specialized/enrichment-agent.md",
+      "tags": ["specialized", "planning", "context"],
+      "longDescription": "Enriches issues and planning documents with additional context. Gathers related information, links dependencies, and ensures planning documents are comprehensive.",
+      "whatItDoes": [
+        "Enriches issues with context",
+        "Links related issues and dependencies",
+        "Gathers codebase context for planning",
+        "Identifies affected areas of code",
+        "Adds acceptance criteria suggestions"
+      ],
+      "whenToUse": "During planning phase to enrich issues with relevant context and dependencies.",
+      "skillLevel": "intermediate",
+      "relatedModules": ["product-functional", "product-technical"]
+    },
+    {
+      "id": "seo-ai-specialist",
+      "name": "SEO AI Specialist",
+      "description": "SEO optimization, Core Web Vitals, structured data",
+      "file": "specialized/seo-ai-specialist.md",
+      "tags": ["specialized", "seo", "content"],
+      "longDescription": "Optimizes content and code for search engines. Creates SEO strategies, implements meta tags, structured data, and ensures optimal Core Web Vitals.",
+      "whatItDoes": [
+        "Implements SEO best practices",
+        "Creates meta tags and structured data",
+        "Optimizes Core Web Vitals",
+        "Generates SEO-friendly content",
+        "Analyzes and improves page rankings"
+      ],
+      "whenToUse": "When building public-facing websites that need search engine visibility.",
+      "techStack": ["Schema.org", "JSON-LD", "Open Graph", "Sitemap"],
+      "skillLevel": "intermediate",
+      "relatedModules": ["astro-engineer", "tech-writer", "content-writer"]
+    }
+  ]
+}