Rebuild Mental Model

Keep the global system mental model current. Always update docs; this is not a read-only explainer.

One responsibility: make a developer understand how the whole system works today, using code as source of truth.

Outputs

Follow repo conventions first. If none exist, create/update:

ARCHITECTURE.md - engineer-facing map of runtime surfaces, data ownership, providers, jobs, permissions, deployment/runtime boundaries, and debug entry points.
[platform-name]-in-plain-english.md - plain-language product/system map for new developers, founders, operators, and non-specialists.
CONTEXT.md if it exists; otherwise docs/ubiquitous-language.md - canonical domain language, provider names, roles, object names, states, and overloaded terms.

Never include secrets or env values. Provider/env var names are fine.

Run when the user asks to rebuild, refresh, update, tour, onboard, or understand the whole system. Also run after architecture-affecting changes: