{
  "mappings": [
    {"intent": "write PRD", "skill": "create-prd", "path": "skills/planning/create-prd/SKILL.md", "examples": ["Create a product requirements document for a new feature to import CSVs"]},
    {"intent": "generate tasks", "skill": "generate-tasks", "path": "skills/planning/generate-tasks/SKILL.md", "examples": ["Break down PRD into implementation tasks for backend and frontend"]},
    {"intent": "create tickets", "skill": "plan-tickets", "path": "skills/planning/plan-tickets/SKILL.md", "examples": ["Create tickets from task list", "Create Jira tickets from this plan"]},
    {"intent": "triage bug", "skill": "triage-bug", "path": "skills/testing/triage-bug/SKILL.md", "examples": ["Triage a production 500 error for orders#create", "Debug why checkout fails at midnight"]},
    {"intent": "start TDD slice", "skill": "plan-tests", "path": "skills/testing/plan-tests/SKILL.md", "examples": ["Choose first failing spec for authentication flow", "Where do I start testing this feature?"]},
    {"intent": "write tests", "skill": "write-tests", "path": "skills/testing/write-tests/SKILL.md", "examples": ["Write specs for the billing service", "How should I structure this test?"]},
    {"intent": "test service object", "skill": "test-service", "path": "skills/testing/test-service/SKILL.md", "examples": ["Write specs for my payment processing service"]},
    {"intent": "review code", "skill": "code-review", "path": "skills/code-quality/code-review/SKILL.md", "examples": ["Review this PR", "Check this controller for issues"]},
    {"intent": "review architecture", "skill": "review-architecture", "path": "skills/code-quality/review-architecture/SKILL.md", "examples": ["This codebase feels messy", "Are my service boundaries right?"]},
    {"intent": "security audit", "skill": "security-check", "path": "skills/code-quality/security-check/SKILL.md", "examples": ["Check this endpoint for vulnerabilities", "Does this have proper authorization?"]},
    {"intent": "authorization policies", "skill": "implement-authorization", "path": "skills/code-quality/implement-authorization/SKILL.md", "examples": ["Add role-based access to admin endpoints", "Set up Pundit policies"]},
    {"intent": "refactor", "skill": "refactor-code", "path": "skills/code-quality/refactor-code/SKILL.md", "examples": ["Refactor this fat controller", "Extract this logic cleanly"]},
    {"intent": "code conventions", "skill": "apply-code-conventions", "path": "skills/code-quality/apply-code-conventions/SKILL.md", "examples": ["Check this code follows Rails conventions"]},
    {"intent": "stack conventions", "skill": "apply-stack-conventions", "path": "skills/code-quality/apply-stack-conventions/SKILL.md", "examples": ["Writing for PostgreSQL + Hotwire + Tailwind stack"]},
    {"intent": "respond to review", "skill": "respond-to-review", "path": "skills/code-quality/respond-to-review/SKILL.md", "examples": ["Address these review comments", "Respond to PR feedback"]},
    {"intent": "service object", "skill": "create-service-object", "path": "skills/patterns/create-service-object/SKILL.md", "examples": ["Implement a service to sync users with external API", "Extract this into a service"]},
    {"intent": "strategy pattern", "skill": "implement-calculator-pattern", "path": "skills/patterns/implement-calculator-pattern/SKILL.md", "examples": ["Build a calculator with variant dispatch", "Factory pattern for pricing"]},
    {"intent": "documentation", "skill": "write-yard-docs", "path": "skills/patterns/write-yard-docs/SKILL.md", "examples": ["Add YARD docs to this module", "Document the public API"]},
    {"intent": "domain language", "skill": "define-domain-language", "path": "skills/ddd/define-domain-language/SKILL.md", "examples": ["Define domain terms for invoicing", "What should we call this concept?"]},
    {"intent": "bounded contexts", "skill": "review-domain-boundaries", "path": "skills/ddd/review-domain-boundaries/SKILL.md", "examples": ["Review context boundaries", "Check for language leakage across modules"]},
    {"intent": "DDD modeling", "skill": "model-domain", "path": "skills/ddd/model-domain/SKILL.md", "examples": ["Map aggregates to Rails models", "Model this domain in Rails"]},
    {"intent": "review rails engine", "skill": "review-engine", "path": "skills/engines/review-engine/SKILL.md", "examples": ["Review mountable engine for namespace leakage and migrations"]},
    {"intent": "create engine", "skill": "create-engine", "path": "skills/engines/create-engine/SKILL.md", "examples": ["Scaffold a new mountable engine for notifications"]},
    {"intent": "extract to engine", "skill": "extract-engine", "path": "skills/engines/extract-engine/SKILL.md", "examples": ["Extract the notification system into an engine"]},
    {"intent": "safe migration", "skill": "review-migration", "path": "skills/infrastructure/review-migration/SKILL.md", "examples": ["Add a column without downtime", "Safe index on large table"]},
    {"intent": "background job", "skill": "implement-background-job", "path": "skills/infrastructure/implement-background-job/SKILL.md", "examples": ["Process invoice PDFs asynchronously", "Set up Sidekiq job"]},
    {"intent": "database seeding", "skill": "seed-database", "path": "skills/infrastructure/seed-database/SKILL.md", "examples": ["Set up seed data for development"]},
    {"intent": "performance", "skill": "optimize-performance", "path": "skills/infrastructure/optimize-performance/SKILL.md", "examples": ["Fix N+1 queries on the dashboard", "Optimize slow page load"]},
    {"intent": "api versioning", "skill": "version-api", "path": "skills/infrastructure/version-api/SKILL.md", "examples": ["Add v2 of the users API", "Deprecate v1 endpoints"]},
    {"intent": "hotwire frontend", "skill": "implement-hotwire", "path": "skills/infrastructure/implement-hotwire/SKILL.md", "examples": ["Add Turbo Frames to this form", "Make this page interactive with Stimulus"]},
    {"intent": "api collection", "skill": "generate-api-collection", "path": "skills/api/generate-api-collection/SKILL.md", "examples": ["Generate Postman collection for /api/v1/users endpoints"]},
    {"intent": "graphql", "skill": "implement-graphql", "path": "skills/api/implement-graphql/SKILL.md", "examples": ["Build GraphQL API for product catalog"]},
    {"intent": "api client", "skill": "integrate-api-client", "path": "skills/api/integrate-api-client/SKILL.md", "examples": ["Integrate with Stripe API", "Build HTTP client for external service"]},
    {"intent": "load context", "skill": "load-context", "path": "skills/context/load-context/SKILL.md", "examples": ["Load schema and routes before coding", "What does this codebase use?"]},
    {"intent": "onboarding", "skill": "setup-environment", "path": "skills/context/setup-environment/SKILL.md", "examples": ["I just joined this team", "Set up my dev environment"]}
  ],
  "defaults": {
    "test_gate": "skills/testing/write-tests",
    "tdd_flow": ["skills/testing/plan-tests", "skills/testing/write-tests"],
    "review_flow": ["skills/code-quality/code-review", "skills/code-quality/respond-to-review"],
    "context_first": "skills/context/load-context"
  },
  "disambiguation": {
    "architecture_vs_code_review": "Use architecture-review when the question is about system shape, boundaries, or design; use code-review when the subject is a specific PR, file, or changeset.",
    "tdd_slices_vs_rspec": "Use tdd-slices when the challenge is WHICH test to write first; use write-tests when the challenge is HOW to write or improve a test.",
    "performance_vs_bug": "If slow behavior is intermittent, default to triage-bug; if consistently slow with no errors, use optimize-performance.",
    "engine_author_vs_extraction": "Use create-engine for greenfield engines; use extract-engine when pulling existing code into an engine."
  },
  "categories": {
    "api": "skills/api/",
    "code-quality": "skills/code-quality/",
    "context": "skills/context/",
    "ddd": "skills/ddd/",
    "engines": "skills/engines/",
    "infrastructure": "skills/infrastructure/",
    "orchestration": "skills/orchestration/",
    "patterns": "skills/patterns/",
    "planning": "skills/planning/",
    "testing": "skills/testing/",
    "workflows": "skills/workflows/"
  },
  "workflows": {
    "tdd-loop": "skills/workflows/tdd-workflow",
    "review-flow": "skills/workflows/review-workflow",
    "setup-flow": "skills/workflows/setup-workflow",
    "quality-flow": "skills/workflows/quality-workflow",
    "engines-flow": "skills/workflows/engine-workflow"
  }
}