---
description: Documentation workflow for the repository knowledge store and ExecPlans
globs:
alwaysApply: false
---

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

# Cursor Rule: Docs Knowledge Workflow

- Keep design decisions in `docs/design-docs/`, product behavior specs in
  `docs/product-specs/`, and evergreen references in `docs/references/`.

- Use `PLANS.md` plus `docs/exec-plans/active/` for complex work instead of
  repository-root `tasks.md`.

- Regenerate indexes and the document inventory with
  `python scripts/build_repo_knowledge_index.py` after changing
  knowledge-structure docs or metadata.

- Run `python scripts/check_architecture_boundaries.py` after changing the
  boundary rules reference or committed baseline.

- If a design changes implementation expectations, update the nearest
  `AGENTS.md`, `CLAUDE.md`, and compatibility instruction files when they
  become stale.
