From 15042af6e2a1e3cf6ab2536b657aef25f4be03a2 Mon Sep 17 00:00:00 2001 From: Michael Chihlas Date: Thu, 30 Apr 2026 23:02:53 -0400 Subject: [PATCH] docs(ai): document docker-exec pattern for hosts without native toolchains The code-server LXC has bun and docker but no python/node/npm on PATH, which left Codex unable to reproduce build/test commands. Adds a 6-line block to PROJECT_CONTEXT.md showing the docker exec resolutionflow_{backend,frontend} form, and updates the AGENTS.md "Tooling you do NOT have" line to point Codex at it instead of suggesting toolchain installs. Co-Authored-By: Claude Opus 4.7 --- .ai/PROJECT_CONTEXT.md | 9 +++++++++ AGENTS.md | 2 +- 2 files changed, 10 insertions(+), 1 deletion(-) diff --git a/.ai/PROJECT_CONTEXT.md b/.ai/PROJECT_CONTEXT.md index f6ea2946..0694c480 100644 --- a/.ai/PROJECT_CONTEXT.md +++ b/.ai/PROJECT_CONTEXT.md @@ -89,6 +89,15 @@ python -m scripts.seed_trees # seed (from **Never pass `--rev-id`** to alembic — let it generate the hex hash. +**On hosts without native `python`/`node`/`npm`** (e.g. the code-server LXC), run commands inside the already-running containers instead: + +```bash +docker exec resolutionflow_backend pytest --override-ini="addopts=" +docker exec resolutionflow_backend alembic upgrade head +docker exec -w /app resolutionflow_frontend npm run build +docker exec -w /app resolutionflow_frontend npx tsc -b +``` + --- ## URLs & test users diff --git a/AGENTS.md b/AGENTS.md index 29db82d4..19aa95fa 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -40,7 +40,7 @@ Prefer correct architecture over minimal diff. Flag "simpler approach" tradeoffs ### Tooling you do NOT have - **No GitNexus tools.** Use `grep -r`, `rg`, `git grep`, or `find` for code search. For blast-radius reasoning, grep call sites manually and read the files. -- **No gstack slash commands** (`/review`, `/ship`, `/qa`, `/browse`, `/investigate`, `/design-review`, `/plan-*`). Run the equivalent work directly: `pytest` for tests, `npm run build` for frontend validation, manual PR description for review flow. +- **No gstack slash commands** (`/review`, `/ship`, `/qa`, `/browse`, `/investigate`, `/design-review`, `/plan-*`). Run the equivalent work directly: `pytest` for tests, `npm run build` for frontend validation, manual PR description for review flow. If `python`/`npm` aren't on PATH, the host runs services in Docker — use the `docker exec resolutionflow_{backend,frontend} …` form documented in `.ai/PROJECT_CONTEXT.md` rather than installing toolchains. - **No `/codex` second-opinion command.** You are Codex. ### Git trailer