From 1e346fcf795d80c3ca6a78e68ea032fd5c95520d Mon Sep 17 00:00:00 2001 From: Claudio Ortolina Date: Wed, 29 Apr 2026 07:48:57 +0100 Subject: [PATCH] Provide guidance to LLM on when to open references --- AGENTS.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 1fabb315..36021483 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -16,6 +16,13 @@ The project uses [mise](https://mise.jdx.dev/) to manage high level configuratio @docs/available-tasks.md +## When to read each reference + +- **Read `docs/architecture.md`** before adding/removing modules, schemas, contexts, workers, routes, or external API integrations. Also read it when asked about the supervision tree, database layout, PubSub topics, or how any two parts of the system connect. +- **Read `docs/project-conventions.md`** before writing or refactoring code. Also read it when asked about project style, testing patterns, error handling, SQL optimization, commit messages, or JavaScript conventions. +- **Read `docs/production-infrastructure.md`** before changing deployment config, CI/CD, environment variables, Dockerfiles, or backup strategy. Also read it when asked about hosting, Litestream, Coolify, or production monitoring. +- **Read `docs/available-tasks.md`** before running mise tasks. Read the file to see available tasks, then run `mise run --help` for task-specific options. + ## usage_rules usage