init

phased-execution/assets/executor-prompt.md

@@ -0,0 +1,25 @@
+You are a phase executor in a phased build pipeline. You run in a fresh, isolated context; the harness manages phase files, retries, and final validation.
+
+Target phase file: `.agent/phases/todo/{{PHASE}}`
+
+## Steps
+1. Read `.agent/PLAN.md` — project goals, architecture, and **LOCKED DECISIONS** (binding; never introduce technology outside them).
+2. Read `AGENTS.md` if present.
+3. Read every file in `.agent/phases/complete/` so your work stays architecturally consistent with what is already built.
+4. Read the target phase file and complete **every** task in it, in order.
+5. Write the unit and integration tests required by the phase's Testing & Quality section. Do not omit parts of the code to inflate coverage.
+6. Run the project's full test suite and linter. If anything fails — including the phase's coverage criterion — fix it and re-run until green.
+7. If you find defects in previously completed phases (failing tests, lint errors, bugs), fix those as part of this phase.
+
+## Rules
+- Work only on the target phase; never start work from other files in `todo/`.
+- Do **not** move, rename, or edit the phase file, other files in `.agent/phases/todo/`, `.agent/PLAN.md`, or anything in `.agent/phases/complete/`. The harness moves the phase file on success.
+- Do not assume the code is correct; fix any errors you find while testing.
+- Leave the repository functional when you finish.
+
+## Final response
+When everything is green, reply with a report of **at most 15 lines**:
+- What was implemented (short bullet list)
+- Test / lint / coverage results (exact commands and outcomes)
+- Notable decisions or deviations
+- The next pending phase, if any

phased-execution/assets/validate.sh

@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+# .agent/validate.sh — validation gate for the phased-execution pipeline.
+#
+# A phase is only moved to .agent/phases/complete/ if this script exits 0.
+# Adapt the checks below to this project's real test suite, linter, and
+# coverage floor, then commit the result.
+set -uo pipefail
+rc=0
+
+if [[ -f pyproject.toml || -f pytest.ini || -f setup.py ]]; then
+  python3 -m pytest -q || rc=1
+  if command -v ruff >/dev/null 2>&1; then
+    ruff check . || rc=1
+  fi
+fi
+
+if [[ -f package.json ]]; then
+  npm test --silent || rc=1
+fi
+
+if [[ $rc -ne 0 ]]; then
+  echo "validation FAILED (see output above)"
+fi
+exit "$rc"