# Component Index

> Complete reference of all cursor-handbook components.

## Rules (47)

| #   | File                                           | Category     | Description                       |
| --- | ---------------------------------------------- | ------------ | --------------------------------- |
| 1   | `rules/main-rules.mdc`                         | Core         | Master rules for all interactions |
| 2   | `rules/architecture/token-efficiency.mdc`      | Architecture | Token optimization (30%+ savings) |
| 3   | `rules/architecture/core-principles.mdc`       | Architecture | Design philosophy and patterns    |
| 4   | `rules/architecture/dependency-management.mdc` | Architecture | Package and dependency rules      |
| 5   | `rules/backend/handler-patterns.mdc`           | Backend      | API handler flow pattern          |
| 6   | `rules/backend/code-organization.mdc`          | Backend      | Code structure and naming         |
| 7   | `rules/backend/error-handling.mdc`             | Backend      | Error handling patterns           |
| 8   | `rules/backend/api-design.mdc`                 | Backend      | REST API conventions              |
| 9   | `rules/backend/typescript.mdc`                 | Backend      | TypeScript-specific standards     |
| 10  | `rules/backend/nodejs.mdc`                     | Backend      | Node.js runtime patterns          |
| 11  | `rules/backend/es6.mdc`                        | Backend      | ES6+ JavaScript standards         |
| 12  | `rules/backend/go.mdc`                         | Backend      | Go language patterns              |
| 13  | `rules/backend/graphql.mdc`                    | Backend      | GraphQL API conventions           |
| 14  | `rules/backend/java.mdc`                       | Backend      | Java language patterns            |
| 15  | `rules/backend/logging.mdc`                    | Backend      | Structured logging standards      |
| 16  | `rules/backend/python.mdc`                     | Backend      | Python language patterns          |
| 17  | `rules/frontend/component-patterns.mdc`        | Frontend     | Component architecture            |
| 18  | `rules/frontend/accessibility.mdc`             | Frontend     | WCAG 2.1 AA compliance            |
| 19  | `rules/frontend/state-management.mdc`          | Frontend     | State management patterns         |
| 20  | `rules/frontend/performance.mdc`               | Frontend     | Performance optimization          |
| 21  | `rules/frontend/angular.mdc`                   | Frontend     | Angular framework patterns        |
| 22  | `rules/frontend/react.mdc`                     | Frontend     | React framework patterns          |
| 23  | `rules/frontend/svelte.mdc`                    | Frontend     | Svelte framework patterns         |
| 24  | `rules/frontend/vue.mdc`                       | Frontend     | Vue framework patterns            |
| 25  | `rules/security/guardrails.mdc`                | Security     | Security guardrails               |
| 26  | `rules/security/secrets-rules.mdc`             | Security     | Secrets handling                  |
| 27  | `rules/security/security-compliance.mdc`       | Security     | Compliance standards              |
| 28  | `rules/database/query-patterns.mdc`            | Database     | Query patterns and safety         |
| 29  | `rules/database/schema-design.mdc`             | Database     | Schema conventions                |
| 30  | `rules/database/migration-rules.mdc`           | Database     | Migration safety                  |
| 31  | `rules/database/patterns.mdc`                  | Database     | General database patterns         |
| 32  | `rules/cloud/infrastructure.mdc`               | Cloud        | Cloud infrastructure              |
| 33  | `rules/cloud/serverless.mdc`                   | Cloud        | Serverless patterns               |
| 34  | `rules/cloud/containerization.mdc`             | Cloud        | Docker best practices             |
| 35  | `rules/cloud/aws.mdc`                          | Cloud        | AWS-specific patterns             |
| 36  | `rules/cloud/terraform.mdc`                    | Cloud        | Terraform IaC patterns            |
| 37  | `rules/testing/testing-standards.mdc`          | Testing      | Testing standards                 |
| 38  | `rules/testing/mock-patterns.mdc`              | Testing      | Mock infrastructure               |
| 39  | `rules/testing/integration-testing.mdc`        | Testing      | Integration test patterns         |
| 40  | `rules/testing/test-naming.mdc`                | Testing      | Test naming conventions           |
| 41  | `rules/testing/jest.mdc`                       | Testing      | Jest framework patterns           |
| 42  | `rules/devops/ci-cd.mdc`                       | DevOps       | CI/CD pipelines                   |
| 43  | `rules/devops/monitoring.mdc`                  | DevOps       | Monitoring and alerting           |
| 44  | `rules/devops/documentation-standards.mdc`     | DevOps       | Documentation standards           |
| 45  | `rules/devops/response-summary.mdc`            | DevOps       | Assistive response summary footer |
| 46  | `rules/devops/cursor-handbook-sync.mdc`        | DevOps       | Handbook sync rule                |
| 47  | `rules/devops/docker.mdc`                      | DevOps       | Docker patterns                   |

## Agents (62)

Agents are at **root level** (`.cursor/agents/*.md`) — Cursor does not discover agents in subdirectories.

| #   | File                                           | Domain        | Invocation              |
| --- | ---------------------------------------------- | ------------- | ----------------------- |
| 1   | `agents/accessibility-agent.md`                | Frontend      | `/accessibility-agent`  |
| 2   | `agents/agent-creator-agent.md`                | Platform      | `/agent-creator-agent`  |
| 3   | `agents/ai-ml-prompt-engineering-agent.md`     | AI/ML         | `/prompt-agent`         |
| 4   | `agents/ai-platform-engineer-agent.md`         | AI/ML         | `/ai-platform-engineer-agent` |
| 5   | `agents/api-gateway-agent.md`                  | Backend       | `/api-gateway-agent`    |
| 6   | `agents/architect-agent.md`                    | Architecture  | `/architect-agent`      |
| 7   | `agents/architecture-refactoring-agent.md`     | Architecture  | `/refactoring-agent`    |
| 8   | `agents/backend-api-agent.md`                  | Backend       | `/api-agent`            |
| 9   | `agents/backend-code-reviewer.md`              | Backend       | `/code-reviewer`        |
| 10  | `agents/backend-database-agent.md`             | Backend       | `/database-agent`       |
| 11  | `agents/backend-debugging-agent.md`            | Backend       | `/debugging-agent`      |
| 12  | `agents/backend-event-handler-agent.md`        | Backend       | `/event-handler-agent`  |
| 13  | `agents/boundaries-agent.md`                   | Architecture  | `/boundaries-agent`     |
| 14  | `agents/business-agent.md`                     | Business      | `/business-agent`       |
| 15  | `agents/business-estimation-agent.md`          | Business      | `/estimation-agent`     |
| 16  | `agents/business-requirements-agent.md`        | Business      | `/requirements-agent`   |
| 17  | `agents/cloud-cost-optimization-agent.md`      | Cloud         | `/cost-agent`           |
| 18  | `agents/cloud-deployment-agent.md`             | Cloud         | `/deployment-agent`     |
| 19  | `agents/cloud-infrastructure-agent.md`         | Cloud         | `/infra-agent`          |
| 20  | `agents/compliance-agent.md`                   | Security      | `/compliance-agent`     |
| 21  | `agents/cost-optimizer-agent.md`               | Cloud         | `/cost-optimizer-agent` |
| 22  | `agents/cursor-setup-agent.md`                 | DevOps        | `/cursor-setup-agent`   |
| 23  | `agents/data-labeller-agent.md`                | AI/ML         | `/data-labeller-agent`  |
| 24  | `agents/data-validator-agent.md`               | Backend       | `/data-validator-agent` |
| 25  | `agents/database-query-optimization-agent.md`  | Database      | `/query-opt-agent`      |
| 26  | `agents/database-schema-agent.md`              | Database      | `/schema-agent`         |
| 27  | `agents/db-agent.md`                           | Database      | `/db-agent`             |
| 28  | `agents/design-agent.md`                       | Architecture  | `/design-agent`         |
| 29  | `agents/design-pattern-agent.md`               | Architecture  | `/design-pattern-agent` |
| 30  | `agents/devops-ci-cd-agent.md`                 | DevOps        | `/ci-cd-agent`          |
| 31  | `agents/devops-incident-agent.md`              | DevOps        | `/incident-agent`       |
| 32  | `agents/diagram-agent.md`                      | Documentation | `/diagram-agent`        |
| 33  | `agents/doc-setup-agent.md`                    | Documentation | `/doc-setup-agent`      |
| 34  | `agents/doc-sync-agent.md`                     | Documentation | `/doc-sync-agent`       |
| 35  | `agents/docs-agent.md`                         | Documentation | `/docs-agent`           |
| 36  | `agents/e2e-testing-agent.md`                  | Testing       | `/e2e-agent`            |
| 37  | `agents/expense-agent.md`                      | Business      | `/expense-agent`        |
| 38  | `agents/frontend-performance-agent.md`         | Frontend      | `/frontend-perf-agent`  |
| 39  | `agents/frontend-state-agent.md`               | Frontend      | `/state-agent`          |
| 40  | `agents/frontend-styling-agent.md`             | Frontend      | `/styling-agent`        |
| 41  | `agents/git-agent.md`                          | DevOps        | `/git-agent`            |
| 42  | `agents/guardrail-agent.md`                    | Security      | `/guardrail-agent`      |
| 43  | `agents/implementation-agent.md`               | Backend       | `/implementation-agent` |
| 44  | `agents/infra-agent.md`                        | Cloud         | `/infra-agent`          |
| 45  | `agents/migration-agent.md`                    | Architecture  | `/migration-agent`      |
| 46  | `agents/monitoring-agent.md`                   | DevOps        | `/monitoring-agent`     |
| 47  | `agents/multi-role-agent.md`                   | Platform      | `/multi-role-agent`     |
| 48  | `agents/openapi-spec-agent.md`                 | Documentation | `/openapi-spec-agent`   |
| 49  | `agents/performance-agent.md`                  | Backend       | `/performance-agent`    |
| 50  | `agents/platform-dx-agent.md`                  | Platform      | `/dx-agent`             |
| 51  | `agents/rag-creator-agent.md`                  | AI/ML         | `/rag-creator-agent`    |
| 52  | `agents/rate-agent.md`                         | Backend       | `/rate-agent`           |
| 53  | `agents/refactor-agent.md`                     | Architecture  | `/refactor-agent`       |
| 54  | `agents/regression-agent.md`                   | Testing       | `/regression-agent`     |
| 55  | `agents/reverse-engineering-doc-agent.md`      | Documentation | `/reverse-engineering-doc-agent` |
| 56  | `agents/security-audit-agent.md`               | Security      | `/security-audit-agent` |
| 57  | `agents/security-auth-agent.md`                | Security      | `/auth-agent`           |
| 58  | `agents/test-runner.md`                        | Testing       | `/test-runner`          |
| 59  | `agents/testing-agent.md`                      | Testing       | `/testing-agent`        |
| 60  | `agents/testing-load-testing-agent.md`         | Testing       | `/load-test-agent`      |
| 61  | `agents/testing-security-testing-agent.md`     | Testing       | `/security-test-agent`  |
| 62  | `agents/ui-component-agent.md`                 | Frontend      | `/ui-component-agent`   |

## Skills (50)

| #   | Directory                                          | Domain        | Description                        |
| --- | -------------------------------------------------- | ------------- | ---------------------------------- |
| 1   | `skills/backend/api-mock-server/`                  | Backend       | Generate mock API server           |
| 2   | `skills/backend/code-review/`                      | Backend       | Code review workflow               |
| 3   | `skills/backend/create-handler/`                   | Backend       | Create API handler                 |
| 4   | `skills/backend/debug-issue/`                      | Backend       | Debug and diagnose issues          |
| 5   | `skills/backend/dependency-graph/`                 | Backend       | Map module dependencies            |
| 6   | `skills/backend/error-handler-generator/`          | Backend       | Generate error handling classes    |
| 7   | `skills/backend/feature-flag-manager/`             | Backend       | Create and manage feature flags    |
| 8   | `skills/backend/optimize-performance/`             | Backend       | Performance optimization           |
| 9   | `skills/cloud/aws-cost-estimator/`                 | Cloud         | AWS cost estimation                |
| 10  | `skills/cloud/docker-compose-generator/`           | Cloud         | Generate docker-compose configs    |
| 11  | `skills/cloud/infrastructure/`                     | Cloud         | Set up infrastructure              |
| 12  | `skills/cloud/opensearch/`                         | Cloud         | OpenSearch setup                   |
| 13  | `skills/cloud/opensearch-dashboard/`               | Cloud         | OpenSearch dashboard generation    |
| 14  | `skills/database/create-migration/`                | Database      | Scaffold new migration             |
| 15  | `skills/database/migration/`                       | Database      | Create migration                   |
| 16  | `skills/database/query-optimization/`              | Database      | Optimize queries                   |
| 17  | `skills/devops/automation-helper/`                 | DevOps        | Design automation workflows        |
| 18  | `skills/devops/changelog-generator/`               | DevOps        | Generate changelog                 |
| 19  | `skills/devops/ci-cd/`                             | DevOps        | CI/CD pipeline setup               |
| 20  | `skills/devops/commit-message-generator/`          | DevOps        | Generate commit messages           |
| 21  | `skills/devops/component-search/`                  | DevOps        | Search handbook components         |
| 22  | `skills/devops/cursor-setup/`                      | DevOps        | Set up cursor-handbook             |
| 23  | `skills/devops/dependency-remediation/`            | DevOps        | Fix vulnerabilities                |
| 24  | `skills/devops/doc-redactor/`                      | DevOps        | Redact sensitive information       |
| 25  | `skills/devops/env-file-generator/`                | DevOps        | Generate .env.example files        |
| 26  | `skills/devops/git-conflict-resolver/`             | DevOps        | Resolve git merge conflicts        |
| 27  | `skills/devops/handbook-validator/`                | DevOps        | Validate handbook integrity        |
| 28  | `skills/devops/incident-runbook-creator/`          | DevOps        | Generate incident runbooks         |
| 29  | `skills/devops/jira-ticket-creator/`               | DevOps        | Generate JIRA tickets              |
| 30  | `skills/devops/monitoring/`                        | DevOps        | Monitoring setup                   |
| 31  | `skills/devops/pr-description-generator/`          | DevOps        | Generate PR descriptions           |
| 32  | `skills/devops/release-manager/`                   | DevOps        | Manage release lifecycle           |
| 33  | `skills/devops/setup-monitoring/`                  | DevOps        | Monitoring infrastructure          |
| 34  | `skills/devops/task-master/`                       | DevOps        | Task management workflow           |
| 35  | `skills/devops/token-counter/`                     | DevOps        | Estimate token counts              |
| 36  | `skills/documentation/adr-generator/`              | Documentation | Generate ADRs                      |
| 37  | `skills/documentation/api-docs/`                   | Documentation | API documentation                  |
| 38  | `skills/documentation/architecture-docs/`          | Documentation | Architecture docs                  |
| 39  | `skills/documentation/openapi-generator/`          | Documentation | Generate OpenAPI specs             |
| 40  | `skills/documentation/postman-collection-generator/`| Documentation | Generate Postman collections      |
| 41  | `skills/documentation/prompt-engineering/`         | Documentation | Craft AI prompts                   |
| 42  | `skills/documentation/regex-builder/`              | Documentation | Build and explain regex patterns   |
| 43  | `skills/documentation/websearch/`                  | Documentation | Web research workflow              |
| 44  | `skills/frontend/component-creation/`              | Frontend      | Create UI component                |
| 45  | `skills/frontend/state-management/`                | Frontend      | State management setup             |
| 46  | `skills/testing/coverage-improvement/`             | Testing       | Improve coverage                   |
| 47  | `skills/testing/fix-tests/`                        | Testing       | Fix failing tests                  |
| 48  | `skills/testing/flaky-test/`                       | Testing       | Diagnose and fix flaky tests       |
| 49  | `skills/testing/load-test-generator/`              | Testing       | Generate load test scripts         |
| 50  | `skills/testing/test-data-factory/`                | Testing       | Generate test data factories       |

## Commands (37)

Commands are quick, token-efficient actions. Skills provide longer guided workflows for the same domains.

| #   | File                                       | Domain   | Invocation            | Token Savings |
| --- | ------------------------------------------ | -------- | --------------------- | ------------- |
| 1   | `commands/backend/type-check.md`           | Backend  | `/type-check`         | ~90K          |
| 2   | `commands/backend/lint-check.md`           | Backend  | `/lint-check`         | ~48K          |
| 3   | `commands/backend/lint-fix.md`             | Backend  | `/lint-fix`           | —             |
| 4   | `commands/backend/format.md`               | Backend  | `/format`             | —             |
| 5   | `commands/backend/generate-handler.md`     | Backend  | `/generate-handler`   | —             |
| 6   | `commands/backend/complexity.md`           | Backend  | `/complexity`         | —             |
| 7   | `commands/backend/dead-code.md`            | Backend  | `/dead-code`          | —             |
| 8   | `commands/backend/feature-flag.md`         | Backend  | `/feature-flag`       | —             |
| 9   | `commands/backend/regex.md`                | Backend  | `/regex`              | —             |
| 10  | `commands/database/migration-check.md`     | Database | `/migration-check`    | —             |
| 11  | `commands/database/sql-explain.md`         | Database | `/sql-explain`        | —             |
| 12  | `commands/devops/build.md`                 | DevOps   | `/build`              | —             |
| 13  | `commands/devops/deploy.md`                | DevOps   | `/deploy`             | —             |
| 14  | `commands/devops/docker-build.md`          | DevOps   | `/docker-build`       | —             |
| 15  | `commands/devops/docker-compose.md`        | DevOps   | `/docker-compose`     | —             |
| 16  | `commands/devops/commit-message.md`        | DevOps   | `/commit-message`     | —             |
| 17  | `commands/devops/pr-description.md`        | DevOps   | `/pr-description`     | —             |
| 18  | `commands/devops/changelog.md`             | DevOps   | `/changelog`          | —             |
| 19  | `commands/devops/release.md`               | DevOps   | `/release`            | —             |
| 20  | `commands/devops/jira-ticket.md`           | DevOps   | `/jira-ticket`        | —             |
| 21  | `commands/devops/automate.md`              | DevOps   | `/automate`           | —             |
| 22  | `commands/devops/cron.md`                  | DevOps   | `/cron`               | —             |
| 23  | `commands/devops/git-cleanup.md`           | DevOps   | `/git-cleanup`        | —             |
| 24  | `commands/devops/json-diff.md`             | DevOps   | `/json-diff`          | —             |
| 25  | `commands/devops/openapi-spec.md`          | DevOps   | `/openapi-spec`       | —             |
| 26  | `commands/devops/rollback-plan.md`         | DevOps   | `/rollback-plan`      | —             |
| 27  | `commands/security/audit-deps.md`          | Security | `/audit-deps`         | —             |
| 28  | `commands/security/audit.md`               | Security | `/audit`              | —             |
| 29  | `commands/security/check-secrets.md`       | Security | `/check-secrets`      | —             |
| 30  | `commands/security/fix-vulnerable-deps.md` | Security | `/fix-vulnerable-deps`| —             |
| 31  | `commands/security/env-check.md`           | Security | `/env-check`          | —             |
| 32  | `commands/security/redact.md`              | Security | `/redact`             | —             |
| 33  | `commands/testing/test-single.md`          | Testing  | `/test-single`        | ~95K          |
| 34  | `commands/testing/coverage.md`             | Testing  | `/coverage`           | —             |
| 35  | `commands/testing/mock-data.md`            | Testing  | `/mock-data`          | —             |
| 36  | `commands/testing/api-test.md`             | Testing  | `/api-test`           | —             |
| 37  | `commands/testing/benchmark.md`            | Testing  | `/benchmark`          | —             |

## Hooks (12)

| #   | Script                        | Event                | Description                     |
| --- | ----------------------------- | -------------------- | ------------------------------- |
| 1   | `hooks/context-enrichment.sh` | beforeSubmitPrompt   | Enrich prompts with context     |
| 2   | `hooks/inject-context.sh`     | beforeSubmitPrompt   | Inject project configuration    |
| 3   | `hooks/post-edit-check.sh`    | afterFileEdit        | Post-edit validation            |
| 4   | `hooks/auto-format.sh`        | afterFileEdit        | Auto-format files               |
| 5   | `hooks/format-on-edit.sh`     | afterFileEdit        | Format file on save             |
| 6   | `hooks/lint-check.sh`         | afterFileEdit        | Lint validation after edits     |
| 7   | `hooks/type-check.sh`         | afterFileEdit        | Type-check after edits          |
| 8   | `hooks/shell-guard.sh`        | beforeShellExecution | Block dangerous commands        |
| 9   | `hooks/pre-commit-check.sh`   | beforeShellExecution | Pre-commit checks               |
| 10  | `hooks/scan-secrets.sh`       | beforeShellExecution | Detect leaked secrets           |
| 11  | `hooks/validate-sql.sh`       | beforeShellExecution | Validate SQL safety             |
| 12  | `hooks/coverage-check.sh`     | afterTestRun         | Verify coverage thresholds      |
