AGENTS.md

Codex Instructions (Prompt_Squirrel_RAG)

Environment (Windows / PowerShell)

• Always run from the repo root.
• Never run python or pip directly.
• Always use the venv interpreter:
  • .venv\Scripts\python.exe
• Install deps with:
  • .venv\Scripts\python.exe -m pip install -r requirements.txt

Change discipline

• Keep diffs small: fix one issue or implement one focused step per patch.
• Do not rewrite large files.
• Do not move logic across modules unless the contract requires it.
• Preserve stage boundaries: rewriting (LLM) vs retrieval (candidate generation) vs selection (index-only).

Project contracts

• Follow the retrieval grounding / candidate generation contract:
  • docs/retrieval_contract.md
• If behavior conflicts with existing code, update code to match the contract (not the other way around).