woos-review-context

Stars7

Forks1

UpdatedJune 13, 2026 at 12:39

Maintain cumulative cross-gate review context so reviewers build on prior findings instead of restarting from zero.

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-ratchet

View GitHub Repository View Creator Repositories

Download

Related occupationsSOC

Based on SOC occupation classification

Software DevelopersComputer and Mathematical Occupations·SOC 15-1252

SKILL.md

readonly

name	woos-review-context
description	Maintain cumulative cross-gate review context so reviewers build on prior findings instead of restarting from zero.
version	1.5.0
author	Hermes Profile
license	MIT

Woos Review Context

Purpose

Provide a shared, cumulative review memory across PRD/design/code/security gates.

Required Behavior

Load prior review context before invoking any reviewer.
Pass unresolved prior findings into the current review prompt.
Require explicit resolution status for each prior blocking finding.
Persist new findings with ownership, severity, and target artifact.
Preserve finding identity across gates and rounds; do not emit duplicate findings with new IDs.

Persistence Contract (mandatory)

Review context MUST be stored on disk (not only in transient prompt state).
Canonical runtime root: <workspace_root>/.ratchet.
Default path: <workspace_root>/.ratchet/review-context/<run_id>.yaml.
review-context/ directory is created lazily by orchestrator/runtime when missing.
For gated runs, run_id is mandatory. If unavailable, return BLOCKED.
Every review gate update MUST overwrite the same run file and append a new gate_entry.
Reviewer prompts MUST include a concise summary loaded from this file.

Review Context Schema

run_id
artifact_id
gate
reviewers
new_findings
resolved_findings
carry_forward_findings
finding_id
first_seen_gate
status (open | resolved | reopened)
resolved_in_gate
supersedes
coverage_summary
completeness_check
context_file_path
gate_entries

Output Contract

status: PASS | REQUEST_CHANGES | BLOCKED
review_context_loaded: boolean
review_context_updated: boolean
context_file_path
unresolved_findings
resolved_findings
carry_forward_findings

Machine-Readable Enforcement Output (required)

{
  "enforcement": {
    "required_invocations": ["woos-review-context"],
    "actually_invoked": ["woos-review-context"],
    "missing_invocations": [],
    "context_file_written": true,
    "invocation_evidence": [
      {
        "skill": "woos-review-context",
        "invoked_at": "2026-05-12T22:00:00Z",
        "artifact_ref": "<workspace_root>/.ratchet/review-context/<run_id>.yaml",
        "output_digest": "sha256:..."
      }
    ],
    "finding_identity_checks_passed": true,
    "completeness_passed": true
  }
}

Missing invocation_evidence MUST return BLOCKED.

More from this repository

same repository

woos-architecture-overview

zero-click/zero-ratchet

Produce the high-level architecture overview used by downstream product design and engineering.

2026-06-167

woos-architecture-review-gate

zero-click/zero-ratchet

Independent high-level architecture review gate for discovery.

2026-06-167

woos-idea-capture

zero-click/zero-ratchet

Capture and structure raw ideas through guided interview or quick note. Produces a structured idea document ready for research or PRD pass. Focuses purely on product intent — no technical decisions.

2026-06-167

woos-idea-to-design

zero-click/zero-ratchet

Entry-point product workflow from raw idea to validated product design artifacts. Stops at reviewed PRD readiness and does not include engineering implementation.

2026-06-167

woos-prd-authoring

zero-click/zero-ratchet

Write the per-feature PRD from the ranked requirements contract using the mandatory PRD template.

2026-06-167

woos-prd-consistency-audit

zero-click/zero-ratchet

Dedicated analyze gate for PRD and UI brief consistency. Runs script extraction first, then semantic review with evidence-backed findings.

2026-06-167

Woos Review Context

Purpose

Provide a shared, cumulative review memory across PRD/design/code/security gates.

Required Behavior

Load prior review context before invoking any reviewer.

Pass unresolved prior findings into the current review prompt.

Require explicit resolution status for each prior blocking finding.

Persist new findings with ownership, severity, and target artifact.

Preserve finding identity across gates and rounds; do not emit duplicate findings with new IDs.

Persistence Contract (mandatory)

Review context MUST be stored on disk (not only in transient prompt state).

Canonical runtime root: <workspace_root>/.ratchet.

Default path: <workspace_root>/.ratchet/review-context/<run_id>.yaml.

review-context/ directory is created lazily by orchestrator/runtime when missing.

For gated runs, run_id is mandatory. If unavailable, return BLOCKED.

Every review gate update MUST overwrite the same run file and append a new gate_entry.

Reviewer prompts MUST include a concise summary loaded from this file.

Review Context Schema

run_id

artifact_id

gate

reviewers

new_findings

resolved_findings

carry_forward_findings

finding_id

first_seen_gate

status (open | resolved | reopened)

resolved_in_gate

supersedes

coverage_summary

completeness_check

context_file_path

gate_entries

Output Contract

status: PASS | REQUEST_CHANGES | BLOCKED

review_context_loaded: boolean

review_context_updated: boolean

context_file_path

unresolved_findings

resolved_findings

carry_forward_findings

Machine-Readable Enforcement Output (required)

{ "enforcement": { "required_invocations": ["woos-review-context"], "actually_invoked": ["woos-review-context"], "missing_invocations": [], "context_file_written": true, "invocation_evidence": [ { "skill": "woos-review-context", "invoked_at": "2026-05-12T22:00:00Z", "artifact_ref": "<workspace_root>/.ratchet/review-context/<run_id>.yaml", "output_digest": "sha256:..." } ], "finding_identity_checks_passed": true, "completeness_passed": true } }

Missing invocation_evidence MUST return BLOCKED.