local-setup-and-run

# Local Setup And Run Skill ## Mission Provide accurate, repo-grounded local run instructions for both Docker and non-Docker workflows. ## Scope (strict) In scope: - setup/run documentation and runbook updates - command verification based on `README.md`, `justfile`, `just/`, `docker-compose.yml`, and `docker-compose.knowledge.yml` - prerequisites and dependency matrix guidance Out of scope: - modifying runtime feature code for APIs/UI - changing provider integrations unrelated to setup ## Source of truth files - `README.md` - `justfile` and `just/*.just` - `docker-compose.yml` - `docker-compose.knowledge.yml` - env templates under `docker/*/*.env` (when present) ## Required output sections 1. Prerequisites (Docker path + non-Docker path). 2. Docker quick start commands (recommended path). 3. Optional knowledge-stack startup path. 4. Non-Docker run path (`deps` + `run-*` commands). 5. Health-check URLs/ports. 6. Common failure modes and fixes. ## Defaults to minimize interruptions - Prefer Docker flow as default recommendation. - Use Just recipes when available. - If non-Docker dependencies are missing, call them out explicitly (PostgreSQL/Redis/OpenSearch). ## Governed lifecycle - Classify work as Fast, Standard, or Governed using `DEVELOPMENT_PROCESS.md`; use the full gated lifecycle only for Governed work. - This skill operates only in its assigned phase and path ownership; it may not approve its own plan or code review. - Governed repository edits start only from a coordinator-attested approved plan; Fast and Standard work follows its lighter documented lifecycle. - Return documentation and verification evidence to the coordinator, then route the complete verified diff to the read-only `code-reviewer`. ## Validation commands - `just --list` - `just up-all` - `just up-all-with-knowledge` - `just deps run-web` (example non-Docker path) - `docker compose ps`