Skip to content

gustavo-meilus/superpipelines / .superpipelines/skills/superpipelines/parity-test-h/reporter-protocol

reporter-protocol

Verified

Loaded by the run-parity-test-h entry skill to supply operating protocol and invariants for markdown validation report formatting in the parity-test-h pipeline. Not user-invocable.

Reporter — Operational Protocol

Protocol

1. DISCOVER

  1. Read inputs from the orchestrator execution context:
    • reviewed_findings_path: path to reviewed-findings.json written by the reviewer step.
    • output_path: path where the final validation report must be written (always {ROOT}/output/parity-test-h-validation-report.md).
    • state_path: path to pipeline-state.json for status updates.
    • run_id: current run identifier.
    • root: resolved scope root.
  2. Verify reviewed_findings_path exists and is a readable file. If not: update pipeline-state.json phases[2].status = "blocked"; emit BLOCKED with message: "Reviewed findings not found at {reviewed_findings_path}. The reviewer step may have failed."
  3. Parse the reviewed findings JSON. If JSON is malformed: update pipeline-state.json phases[2].status = "blocked"; emit BLOCKED with message: "Reviewed findings at {reviewed_findings_path} are not valid JSON. Re-run the reviewer step."

2. PROCESS

Step 2.1 — Partition findings by category and status:

From reviewed-findings.json, partition the findings into four groups:

  1. confirmed_required_fields: findings where category = "required_field" and review_status = "confirmed".
  2. confirmed_type_mismatches: findings where category = "type_mismatch" and review_status = "confirmed".
  3. confirmed_deprecated_keys: findings where category = "deprecated_key" and review_status = "confirmed".
  4. dismissed: all findings where review_status = "dismissed", regardless of category.

Step 2.2 — Render the markdown report:

Format the markdown report using the following template:

# YAML Validation Report — parity-test-h

**Source file**: {source_path}
**Reviewed at**: {reviewed_at}
**Run ID**: {run_id}
**Total findings**: {total_findings} ({confirmed} confirmed, {dismissed} dismissed)

---

## Summary

| Category | Confirmed | Dismissed |
|---|---|---|
| Required field violations | {n} | {n} |
| Type mismatches | {n} | {n} |
| Deprecated keys | {n} | {n} |
| **Total** | **{confirmed}** | **{dismissed}** |

---

## Required Field Violations

{If no confirmed required-field findings: "_No required field violations confirmed._"}

{For each confirmed required-field finding:}
### {id}: {key}

- **Severity**: Error
- **Message**: {message}

---

## Type Mismatches

{If no confirmed type-mismatch findings: "_No type mismatches confirmed._"}

{For each confirmed type-mismatch finding:}
### {id}: {key}

- **Severity**: Error
- **Expected type**: `{expected_type}`
- **Actual type**: `{actual_type}`
- **Actual value**: `{actual_value}`
- **Message**: {message}

---

## Deprecated Keys

{If no confirmed deprecated-key findings: "_No deprecated keys confirmed._"}

{For each confirmed deprecated-key finding:}
### {id}: {key}

- **Severity**: Warning
- **Message**: {message}

---

## Dismissed Findings (False Positives)

{If no dismissed findings: "_No findings were dismissed._"}

{For each dismissed finding:}
### {id}: {key} ({category})

- **Original severity**: {severity}
- **Original message**: {message}
- **Dismissal rationale**: {review_note}

---

_Report generated by parity-test-h pipeline on Tier 2 (Cursor/Windsurf/Cline). Reviewer isolation is convention-only; review was performed within the same agent session as validation._

Step 2.3 — Handle zero-confirmed-findings edge case:

If confirmed = 0 (all findings dismissed, or zero findings from validator): the report still renders with all sections showing the "no findings" placeholder text. Emit DONE_WITH_CONCERNS with message: "Report written with zero confirmed findings. Either the YAML is fully valid or all findings were dismissed as false positives."

3. DELIVER

  1. Create the {root}/output/ directory if it does not exist.
  2. Write the rendered markdown report to output_path using the Write tool.
  3. Update pipeline-state.json:
    • Set phases[2].status = "completed" (or "completed_with_concerns" if zero confirmed findings).
    • Set phases[2].outputs = [output_path].
    • Set phases[2].outputs_summary = { "confirmed_findings": N, "dismissed_findings": N }.
    • Set top-level status = "completed" (or "completed_with_concerns" as appropriate).
    • Set completed_at = current ISO-8601 timestamp.
  4. Emit terminal status:
    • DONE — report written successfully with at least one confirmed finding.
    • DONE_WITH_CONCERNS — report written but contained zero confirmed findings (note reason).
    • BLOCKED — reviewed-findings file missing or malformed; output not written.
finishing-a-development-branchobra/superpowersUse when implementation is complete, all tests pass, and you need to decide how to integrate the workStars: 322kUpdated Claude CodeCodexVerifiedInstall
systematic-debuggingobra/superpowersUse when encountering any bug, test failure, or unexpected behavior, before proposing fixesStars: 322kUpdated Claude CodeCodexVerifiedInstall
test-driven-developmentobra/superpowersUse when implementing any feature or bugfix, before writing implementation codeStars: 322kUpdated Claude CodeCodexVerifiedInstall
skill-creatoranthropics/skillsCreate new skills, modify and improve existing skills, and measure skill performance. Use when users want to create a skill from scratch, edit, or optimize an existing skill, run evals to test a skill, benchmark skill performance with variance analysis, or optimize a skill's description for better triggering accuracy.Stars: 198kUpdated Claude CodeCodexVerifiedInstall