<!-- Generated by scripts/generate_ai_collab_docs.py. Edit metadata in that script. -->

# Copilot Repository Instructions

- Read the nearest `AGENTS.md` and `CLAUDE.md` files before making changes;
  they are the primary repository instructions.

- Keep the repository hard rules visible in those primary docs: English-only
  code-facing text, no hardcoded user-facing strings or secrets, and
  shared-contract doc updates in the same change.

- Use `ARCHITECTURE.md`, `PLANS.md`, and `docs/engineering-baseline.md` as the
  primary repository knowledge entry points instead of duplicating them
  everywhere.

- Inspect the existing implementation, call sites, and tests before modifying
  code.

- Maximize reuse of existing abstractions and avoid creating a second helper,
  request path, or state model when the current one can be extended cleanly.

- For complex design work, create an ExecPlan in `docs/exec-plans/active/` and
  maintain it according to `PLANS.md`.

- Regenerate repository knowledge indexes with
  `python scripts/build_repo_knowledge_index.py` after moving docs or changing
  required metadata.

- Before each commit, review the affected `AGENTS.md` and `CLAUDE.md` files
  and update stale docs in the same change.
