DeepSeek-TUI/web/AGENTS.md

Web agent guidance

Read the repository guidance first. This directory is the Codewhale Next.js site.

• Repository facts are generated by npm run prebuild into lib/facts.generated.ts. Change their source and regenerate; never hand-edit the generated file.
• Shared public copy lives in lib/content/. Keep product vocabulary aligned with docs/public-surface-facts.json and docs/MODES.md; extend locale data, not individual pages.
• Localization migrations are one-way. New or touched pages use the shared dictionary/content spine; do not add page-local language booleans, isZh copy forks, or hard-coded translated page clones. A compatibility exception must name the external contract that still requires it. Website/docs machine translation uses npm run i18n:gt (local JSON catalogs into the same dictionaries). Do not add gt-next beside that path, and do not point GT at TUI locale packs.
• Real-session media is owned by lib/media-manifest.ts. pending is the truthful state until the complete asset set passes manifest tests.
• AGENT.md (singular) documents maintainer-owned community automation. Do not expand its authority without Hunter.

Choose evidence according to the claim. For a localized page, render and inspect that page at representative widths and run the narrow dictionary/content check if it adds useful confidence. For a build-system or release-wide change, a full gate may be justified. Do not run this whole sequence by default, and do not add a test merely to freeze copy or component structure:

npm ci
npm run prebuild
npm run check:facts
npm run check:docs
npm test
npm run lint
npm run build