# LLM Standards Governance

This file defines how LLM code generation standards are maintained in this repository.

## Canonical location

All standards for AI code generation live in:

- `documentation/llm-codegen-standards/`

## Mandatory policy

- Any adaptation to existing standards MUST be documented in this folder.
- Any new code generation standard MUST be created in this folder before or alongside implementation.
- Standards changes SHOULD include:
  - purpose of the rule,
  - required behavior (`MUST`/`MUST NOT`),
  - concise examples when useful.

## Minimum maintenance workflow

1. Identify gap/conflict in current standards.
2. Update or add a standards file in this folder.
3. Apply code changes following updated standards.
4. Keep digest docs in sync when behavior changes materially.

## Current baseline standards

- `ui-state-architecture.md`
- `web-components-guidelines.md`