review-feedback-promoter

Convert repeated review findings into durable harness checks. Use when code review catches recurring agent mistakes that should become docs, tests, lint rules, boundary checks, validation scripts, or

SKILL.md

GitHub

Review Feedback Promoter

Purpose

Turn recurring human or agent review feedback into reusable harness defenses instead of repeating the same comment.

Inspect First

  • recent review findings, agent-reviewer output, quality docs, lint/boundary/test scripts, architecture docs, dependency/security policies, and known repeated defects

Procedure

  1. Classify each finding.

    • Documentation rule for knowledge gaps.
    • Test for behavior gaps.
    • Boundary or lint check for mechanical architecture gaps.
    • Security/dependency/migration check for governance gaps.
    • Entropy/golden-pattern update for consistency gaps.
  2. Record promotions.

    • Create or update docs/quality/review-feedback-promotions.md.
    • Include source finding, promoted defense, validation command, owner, and status.
  3. Add the lightest durable defense.

    • Prefer existing project-native checks.
    • Add scripts only when deterministic and repeatable.
    • Avoid broad rules that create false positives.
  4. Route specialized fixes.

    • Use architecture-boundary-enforcer for import/layer issues.
    • Use testing-strategy-builder or tdd-playwright-workflow for behavior gaps.
    • Use documentation-sync-enforcer, security-baseline, or dependency-governance for specialized policy gaps.

Validation

  • Confirm each promotion maps to a real repeated finding.
  • Confirm each new rule has a command, doc location, or test path.
  • Confirm the defense is specific enough to avoid noisy failures.

Completion Criteria

  • Repeated review feedback has a durable follow-up path.
  • The harness grows stronger without bloating root instructions or adding unnecessary tools.