# Copilot Instructions for This Repository

These instructions are mandatory for all code generation.

## Required pre-read standards

Before proposing or generating code, read:

- `documentation/llm-codegen-standards/ui-state-architecture.md`
- `documentation/llm-codegen-standards/web-components-guidelines.md`
- `documentation/llm-codegen-standards/governance.md`

## Rules

- Follow the standards above as hard constraints.
- Prefer patterns already defined in the standards over inventing new ones.
- If a task requires a new pattern, first document the adaptation/new standard in `documentation/llm-codegen-standards/`, then generate code.
- Keep one source of truth for shared UI state and keep web components render-focused, as defined by standards.
- Keep side effects and IO outside pure rendering logic and outside presentational components.

## Standards maintenance requirement

Any adaptation, extension, or new code generation standard MUST be documented in:

- `documentation/llm-codegen-standards/`

Keep these docs short, explicit, and actionable for future LLM sessions.