Project context

Write an AGENTS.md (or keep a CLAUDE.md — either is read, AGENTS.md wins when both exist). Luxe walks from the repository root down to your working directory and loads one per level, general first and the nearest last, on top of a global ~/.config/luxe/agents.md. So a monorepo can put shared rules at the root and specific ones next to the code, and launching from a subdirectory still picks up both.

A PROJECT.md in the repo root is loaded too — useful for a plan or spec you want the agent to hold onto across sessions.

Each file is capped at 24,000 characters in the prompt, and truncation is stated in-band (”… truncated at 24000 characters. Read PROJECT.md directly for the rest.”) so the agent knows to go read the file rather than silently working from half of it. These files ride in every request, so keeping them tight is the single easiest way to keep a session fast and cheap.