docs: add AGENTS.md with custom-image dependency install rule

2026-07-19 20:43:54 +02:00
parent 8a222bffa6
commit a7bb6454a4
3 changed files with 36 additions and 0 deletions
@@ -9,6 +9,8 @@ You are a system architect for the FastSync project — a high-performance file

 Make high-level design decisions. Evaluate trade-offs, plan module interactions, design data flow, and ensure architectural coherence across the codebase.

+> **Environment rule:** dependency installation must always use the project's custom Docker image (repo-root `Dockerfile`, same as CI) — never ad-hoc host package installs. See `AGENTS.md`.
+
 ## Project Architecture

 ### Module Map
@@ -69,6 +69,7 @@ tests/         — test sources (globbed as TEST_SRCS)
 - Include directories: `src/shared`, `src/server`, `src/client`, `tests` (for test target).
 - Sanitizer support is commented out but present (`-fsanitize=address`).
 - Build with `cmake -B build -S . && cmake --build build -j$(nproc)`.
+- Install dependencies only via the project's custom Docker image (repo-root `Dockerfile`, same image CI uses) — never via host package installs; see `AGENTS.md`.

 ## When Making Changes