woos-deviation-control-gate

Estrellas4

Forks0

Actualizado12 de junio de 2026 a las 09:36

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

Instalación

Instalar con Codex o Claude Copia este prompt, pégalo en Codex, Claude u otro asistente, y deja que revise la página de la skill y la instale por ti.

Fuente

zero-click

zero-click/zero-prd-to-pr

Abrir repositorio de GitHub Ver repositorios del creador

Descarga

Ocupaciones relacionadasSOC

Basado en la clasificación ocupacional SOC

Analistas de garantía de calidad de software y probadoresOcupaciones informáticas y matemáticas·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.

Más de este repositorio

mismo repositorio

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.