Session Context¶
Optional module
The installer offers this module pre-checked. Config key: rules.module.session.
The project-knowledge offer protocol: AGENTS.md reading, fleshing out, and per-directory extensions.
Why keep it: Keeps AGENTS.md offers working across every session.
If you decline: The agent will not offer to create project knowledge files.
Rule Content¶
## Project Knowledge (AGENTS.md)
AGENTS.md is the canonical location for project-specific AI assistant knowledge. Prioritize build/test/run commands, architecture overview, key conventions, and gotchas.
This is the project-knowledge offer protocol referenced by the session-start checks.
Apply it after greeting, once the session-start read of `AGENTS.md` has happened:
**File exists but is thin or empty:** Offer to flesh it out.
**Offer to create** (if not exists): "This project doesn't have an AGENTS.md. Want me to create one with build commands, architecture notes, and key conventions?"
**User declines:** Proceed without. Do not ask again this session.
**Subdirectory AGENTS.md:** For modules with distinct conventions, create `<subdir>/AGENTS.md`.