v0.8.67 Docs: center /constitution and user-global constitution in the docs map

[Hmbown]

Problem

The v0.8.67 product direction is that /constitution is the main user-facing constitution surface, and the normal personal constitution path is a structured user-global constitution rendered into model-facing prose. Current docs still lean heavily toward repo-local .codewhale/constitution.json and the expert full prompt override.

That can make users think the only constitution choices are repo law or raw prompts/constitution.md, which is not the intended setup experience.

Surfaces to audit and update

• README.md and localized READMEs: the law/constitution section should explain the bundled global floor, user-global /constitution, repo-local .codewhale/constitution.json, AGENTS.md, and memory order.
• docs/CONFIGURATION.md: keep $CODEWHALE_HOME/prompts/constitution.md documented as an expert full-base-prompt override, but not as the normal guided creator output.
• docs/CONFIGURATION.md: document the user-global structured constitution file path chosen by implementation and how it is rendered into prose.
• web/app/[locale]/docs/constitution/page.tsx: update from mostly repo-local constitution framing to the /constitution + user-global setup model.
• Any setup docs: explain that runtime security controls remain separate from constitution text. Constitution may express preference, but must not silently mutate approval mode, sandbox, network, or trust.
• WHALE.md references: remove from active docs or keep only a finite migration note pointing to AGENTS.md and .codewhale/constitution.json.

Authority model docs should say

• Bundled global Constitution: compiled Markdown floor, same for everyone.
• User-global constitution: guided setup output, structured data, rendered to prose, applies everywhere.
• Repo-local constitution: optional .codewhale/constitution.json, project authority policy, subordinate to higher law and current user request.
• AGENTS.md: ordinary project working instructions.
• Memory/handoff: recalled state, lower authority than constitutions and instructions.
• Full prompt override: expert escape hatch only, gated separately.

Acceptance criteria

• /constitution is documented as the primary constitution management command.
• User-global constitution is documented as the normal guided setup output.
• Repo-local constitution is documented as optional project policy, not the whole constitution story.
• Full base-prompt Markdown override is clearly marked expert-only.
• WHALE.md does not appear as an active setup recommendation.
• At least one web docs page and one CLI/TUI docs page reflect the same model.
• Localized copy has either coverage or an intentional fallback note.

Related

• Constitution creator: v0.8.67 Setup: build a guided localized constitution creator, not a blank prompt editor #3793
• Update checkpoint: v0.8.67 Setup: require a localized constitution checkpoint after update #3794
• /constitution surface: v0.8.67 Setup: make /constitution the primary constitution management surface #3806
• Remove WHALE.md: v0.8.67 Setup: remove deprecated WHALE.md discovery and docs surface #3798
• Docs parent: v0.8.67 Setup: docs, screenshots, localization, and constitution copy refresh #3412