# Mandatory Rules Index

All rules are mandatory and non-negotiable. Domain-specific rules live in
[skills index](../skills/index.md) and [package specs](../../packages/*/docs/SPEC.md).

## Top-Level Rules

| Group           | Document                                 | Scope                                            |
| --------------- | ---------------------------------------- | ------------------------------------------------ |
| Code Quality    | [code-quality.md](code-quality.md)       | Type system, imports, development patterns       |
| Process         | [process.md](process.md)                 | Routing file — see sub-rules below               |
| API Boundary    | [api-boundary.md](api-boundary.md)       | API specification and app lifecycle rules        |
| Naming & Style  | [naming-style.md](naming-style.md)       | Language policy, agent identity, styling         |
| Git & Branch    | [git-branch.md](git-branch.md)           | Git operations and branch policy                 |
| Frontend        | [frontend.md](frontend.md)               | React only, Next.js for SSR, VitePress exception |
| Common Mistakes | [common-mistakes.md](common-mistakes.md) | Observed failure patterns                        |

## Process Sub-Rules (linked from process.md)

| Document                                       | Scope                                                                            |
| ---------------------------------------------- | -------------------------------------------------------------------------------- |
| [spec-workflow.md](spec-workflow.md)           | Spec-first development, document authority, structural docs                      |
| [tdd-and-planning.md](tdd-and-planning.md)     | TDD red-green-refactor, planning requirements                                    |
| [verification.md](verification.md)             | Build, browser, harness, and pre-push verification gates                         |
| [publish.md](publish.md)                       | Package publish safety gate and scope approval                                   |
| [release-operations.md](release-operations.md) | Release state machine, CI triage, long-running gates, publish flow               |
| [documentation-sync.md](documentation-sync.md) | Document role, package README, and robota.io documentation gates                 |
| [research.md](research.md)                     | Research-first implementation and recommendation authority                       |
| [backlog-execution.md](backlog-execution.md)   | Backlog recommendation gates, user execution test scenario gates, initiative PRs |
| [operational.md](operational.md)               | No fallback policy, idea capture, feature documentation                          |
| [learning-loop.md](learning-loop.md)           | Lesson capture and mechanical enforcement preference                             |
