diff --git a/fieldtest/SKILL.md b/fieldtest/SKILL.md index d16aba7..09b1d5d 100644 --- a/fieldtest/SKILL.md +++ b/fieldtest/SKILL.md @@ -33,6 +33,33 @@ template, the source-isolation discipline (no reading under classification rules. This skill file only governs trigger, dispatch, and handoff. +## Two scopes: per-cycle and milestone + +`fieldtest` runs at two scopes, both using the same fieldtester +agent — the carrier picks the scope: + +- **Per-cycle fieldtest** (the default this file otherwise + describes): dispatched after a surface-touching cycle's audit, + carrier scoped to that cycle (`cycle_id` / `cycle_scope`). + Catches cycle-local friction early. Optional / orchestrator + judgement, as below. +- **Milestone fieldtest**: the closing gate for a tracker + milestone. Carrier scoped to the milestone's promise + (`milestone_id` / `milestone_promise`); the fieldtester + derives curated end-to-end scenarios top-down from that + promise and proves the shipped implementation delivers it. Its + green status roll-up is required before a surface-touching + milestone may be closed. + +Both carriers are defined authoritatively under **Carrier +contract** in `agents/fieldtester.md` (the milestone variant +under its **Milestone-scope variant** sub-heading). The gate the +milestone fieldtest feeds is defined once in +`../docs/pipeline.md` § Milestone-close gate — not restated +here. The milestone fieldtest is skippable on the same terms as +the per-cycle one, lifted to milestone level: a milestone whose +entire scope is internal (no user-visible surface) is exempt. + ## When to Use / Skipping Triggers: @@ -138,6 +165,9 @@ The orchestrator drives downstream: Common Rationalisations table, and the Red Flags list. - **Upstream gate:** `../audit/SKILL.md` runs first; fieldtest comes after a clean (or ratified) audit. +- **Closing gate it feeds:** `../docs/pipeline.md` + § Milestone-close gate — the milestone fieldtest's green + roll-up is the functional leg of that gate. - **Cadence ordering:** fieldtest runs *before* `../docwriter/SKILL.md`; docwriter happens at a later, longer stability window.