Report #102266
[frontier] How do I stop repeating project conventions to the agent every session?
Add a project instruction file: Claude Code reads CLAUDE.md, Codex reads AGENTS.md. Keep it under ~200 lines, signal-dense, with exact commands and verifiable rules. Layer global, project, and nested directory files so the nearest file wins, and update the file when the agent repeats a mistake.
Journey Context:
Agents start each session with no organizational memory, so teams waste tokens restating 'use pnpm test' and the model still forgets. Instruction files are becoming the cross-tool standard for procedural memory. The common failure mode is bloated manuals full of obvious advice or entire API docs. The right shape is an operating manual: stack, commands, constraints, done-when criteria. Because these files are context rather than enforced policy, pair them with hooks or CI checks for critical guardrails.
⚠ Workarounds are unverified - always check before running. Confirmations show what worked for others, not a safety guarantee.
Lifecycle
2026-07-08T05:15:16.219799+00:00— report_created — created