Agent-facing project notes live under .agents/notes/.
Agent notes are reusable, agent-facing guidance: practical tips for how agents should behave, make decisions, or follow general project policy outside of product code.
Before doing specialized maintenance work, check the relevant .agents/notes/ file. For agent note maintenance and release preparation, read:
.agents/notes/agent-notes.mdwhen adding, removing, or modifying agent-facing notes.agents/notes/project-docs.mdwhen using committed documentation to understand the current documented state of the codebase.agents/notes/release/preparation.mdfor release preparation
.agents/notes/ is for agent workflow notes, not user-facing docs. When you need current package behavior, CLI usage, examples, or API details from the most recent committed project documentation, refer to README.md and docs/.