woos-deviation-control-gate

Stars4

Forks0

UpdatedJune 12, 2026 at 09:36

Block unresolved implementation drift against PRD, product context, and engineering design artifacts.

Installation

Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.

Source

zero-click

zero-click/zero-prd-to-pr

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Software Quality Assurance Analysts and TestersComputer and Mathematical Occupations·SOC 15-1253

SKILL.md

readonly

name	woos-deviation-control-gate
description	Block unresolved implementation drift against PRD, product context, and engineering design artifacts.
version	1.1.0
author	Hermes Profile
license	MIT

Woos Deviation Control Gate

Purpose

Stop silent drift between planned intent and final implementation.

Required Inputs

Approved PRD
Approved engineering design artifact (Standard mode only; absent in Lite — see Lite Mode Adjustments below)
Product context artifacts: roadmap + architecture (+ interface summary/UI brief/upstream interfaces when available)
Current implementation diff and test results

Required Invocation (hard gate)

MUST dispatch woos-code-reviewer (or an equivalent whitelisted reviewer) in fresh context with a deviation-control focus. In-context self-review where the implementer's session re-labels itself as reviewer is NOT a valid invocation.
The dispatched agent receives only the inputs listed above plus prior review context. It MUST NOT inherit the implementer's session history.
MUST invoke woos-review-context before and after reviewer execution.
If the reviewer is not invoked, return NOT_RUN and stop.
If the reviewer is unavailable, return BLOCKED and stop.
invocation_evidence MUST include dispatch_mode: "fresh_context". Any other value MUST return BLOCKED.

Drift Classification

none
intentional_documented
intentional_undocumented
unintentional

Hard Gate Rules

intentional_undocumented or unintentional => REQUEST_CHANGES.
intentional_documented only passes when all affected artifacts are updated.
Unknown artifact baseline => BLOCKED.

Lite Mode Adjustments

In Lite mode there is no engineering-design artifact (Gate 1 is skipped). Drift classification is performed against PRD + roadmap + architecture + supporting interface/UI artifacts only.
Absence of engineering-design in Lite is expected and MUST NOT be classified as drift or BLOCKED.

Output Contract

status: PASS | REQUEST_CHANGES | NOT_RUN | BLOCKED
execution_mode: Lite | Standard
engineering_design_present: true|false
deviation_findings
deviation_type
artifact_update_required
artifact_update_status

Machine-Readable Enforcement Output (required)

{
  "enforcement": {
    "required_invocations": ["woos-code-reviewer", "woos-review-context"],
    "actually_invoked": ["woos-code-reviewer", "woos-review-context"],
    "missing_invocations": [],
    "invocation_evidence": [
      {
        "skill": "woos-code-reviewer",
        "dispatch_mode": "fresh_context",
        "invoked_at": "2026-06-12T00:00:00Z",
        "artifact_ref": "git diff HEAD + docs/engineering/<version>/<feature-id>-design.md",
        "output_digest": "sha256:..."
      }
    ],
    "execution_mode": "Standard",
    "engineering_design_present": true,
    "deviation_type": "none",
    "artifact_update_required": false,
    "artifact_update_status": "n/a"
  }
}

Missing invocation_evidence MUST return BLOCKED. A status: PASS without a populated enforcement block is INVALID and MUST be rejected by the orchestrator.

More from this repository

same repository

woos-ui-design-brief

zero-click/zero-prd-to-pr

Transform product requirements into a focused UI/UX design brief with screens, flows, visual direction, and optional image-generation concepts. Bridge between product thinking and implementation.

2026-06-124

woos-development-workflow

zero-click/zero-prd-to-pr

Stage 3 of idea-to-delivery: gated engineering workflow that receives PRD, roadmap, and architecture inputs, decomposes into stories, and executes with TDD, traceability, and review gates.

2026-06-124

woos-product-planner

zero-click/zero-prd-to-pr

Planning and decomposition review skill adapted from ECC planner agent. Covers story-set review (Gate 2) and planning consults for upstream skills. PRD-quality review is NOT in scope — that is owned by `woos-product-prd-review-gate`.

2026-06-124

woos-story-decomposition

zero-click/zero-prd-to-pr

Produce a lean story plan (table) for the Gate 3 execution loop — execution order plus diff scope per story. PRD AC is the spec; tests are the verification. No per-story prose documents.

2026-06-124

woos-agent-decision

zero-click/zero-prd-to-pr

Resolve multi-agent review conflicts with explicit authority matrix, evidence weighting, and escalation criteria.

2026-06-124

woos-architect

zero-click/zero-prd-to-pr

Architecture review and design skill adapted from ECC architect agent. Use for design validation, trade-off analysis, and system-level decisions.

2026-06-124

Woos Deviation Control Gate

Purpose

Stop silent drift between planned intent and final implementation.

Required Inputs

Approved PRD

Approved engineering design artifact (Standard mode only; absent in Lite — see Lite Mode Adjustments below)

Product context artifacts: roadmap + architecture (+ interface summary/UI brief/upstream interfaces when available)

Current implementation diff and test results

Required Invocation (hard gate)

MUST dispatch woos-code-reviewer (or an equivalent whitelisted reviewer) in fresh context with a deviation-control focus. In-context self-review where the implementer's session re-labels itself as reviewer is NOT a valid invocation.

The dispatched agent receives only the inputs listed above plus prior review context. It MUST NOT inherit the implementer's session history.

MUST invoke woos-review-context before and after reviewer execution.

If the reviewer is not invoked, return NOT_RUN and stop.

If the reviewer is unavailable, return BLOCKED and stop.

invocation_evidence MUST include dispatch_mode: "fresh_context". Any other value MUST return BLOCKED.

Drift Classification

none

intentional_documented

intentional_undocumented

unintentional

Hard Gate Rules

intentional_undocumented or unintentional => REQUEST_CHANGES.

intentional_documented only passes when all affected artifacts are updated.

Unknown artifact baseline => BLOCKED.

Lite Mode Adjustments

In Lite mode there is no engineering-design artifact (Gate 1 is skipped). Drift classification is performed against PRD + roadmap + architecture + supporting interface/UI artifacts only.

Absence of engineering-design in Lite is expected and MUST NOT be classified as drift or BLOCKED.

Output Contract

status: PASS | REQUEST_CHANGES | NOT_RUN | BLOCKED

execution_mode: Lite | Standard

engineering_design_present: true|false

deviation_findings

deviation_type

artifact_update_required

artifact_update_status

Machine-Readable Enforcement Output (required)

{ "enforcement": { "required_invocations": ["woos-code-reviewer", "woos-review-context"], "actually_invoked": ["woos-code-reviewer", "woos-review-context"], "missing_invocations": [], "invocation_evidence": [ { "skill": "woos-code-reviewer", "dispatch_mode": "fresh_context", "invoked_at": "2026-06-12T00:00:00Z", "artifact_ref": "git diff HEAD + docs/engineering/<version>/<feature-id>-design.md", "output_digest": "sha256:..." } ], "execution_mode": "Standard", "engineering_design_present": true, "deviation_type": "none", "artifact_update_required": false, "artifact_update_status": "n/a" } }

Missing invocation_evidence MUST return BLOCKED. A status: PASS without a populated enforcement block is INVALID and MUST be rejected by the orchestrator.