Skip to content

Destynova2/cli-code-skills / cli-audit-review

cli-audit-review

Verified

Scored MR/PR/diff review skill calibrated for strict infrastructure and automation changes. Use for merge-request reviews, pull-request reviews, scored reviewer gates, convention compliance, Ansible roles/collections, Molecule, GitLab CI, semantic-release, packaging, Go/Cobra CLIs, PowerShell, shell/Python helpers, Kubernetes/containers, Terraform/OpenTofu, and operator documentation reviewed through a contract -> validation -> execution -> proof -> docs/release methodology. Produces RMI scoring, gate decisions, and reviewer-style actionable comments. For generic code quality, code smells, clean-code compliance, or tech debt audits, use cli-audit-code instead.

references/output-template.md

View on GitHub
# Output Template — Scored Review

> **When to read:** Use this structure for final review reports unless the user asks for another format.

---

## Contents

- Full Scored Review
- Compact MR Review Variant
- Line Comment Only Variant
- JSON-ish Machine-Readable Summary

---

## Full Scored Review

```markdown
# Scored Review — {target}

**Decision**: {REQUEST_CHANGES | COMMENT | APPROVE_WITH_NOTES | APPROVE}  
**RMI Score**: {X.X}/10 — {verdict}  
**Scope**: {files/directories/diff reviewed}  
**Review context**: {PR/MR intent, diff size, main areas, scope limits}  
**Primary risk**: {one sentence}  
**Date**: {YYYY-MM-DD}

## Gate Status

| Gate | Status | Evidence |
|---|---|---|
| Public contract complete | PASS/WARN/FAIL/N/A | `file:line` or summary |
| Validation before execution | PASS/WARN/FAIL/N/A | `file:line` or summary |
| Idempotence controlled | PASS/WARN/FAIL/N/A | `file:line` or summary |
| Secrets contained | PASS/WARN/FAIL/N/A | `file:line` or summary |
| Deployable behavior proven | PASS/WARN/FAIL/N/A | `file:line` or summary |
| OS/topology/runtime variants covered | PASS/WARN/FAIL/N/A | `file:line` or summary |
| CI/release/package safe | PASS/WARN/FAIL/N/A | `file:line` or summary |
| Docs synchronized | PASS/WARN/FAIL/N/A | `file:line` or summary |

## Scorecard

| # | Category | Weight | Score | Weighted | Notes |
|---|---|---:|---:|---:|---|
| R1 | Public Contract & Naming | 11% | {0.00-1.00} | {x.xx} | ... |
| R2 | Validation & Fail-Fast | 11% | {0.00-1.00} | {x.xx} | ... |
| R3 | Idempotence & State Convergence | 12% | {0.00-1.00} | {x.xx} | ... |
| R4 | Change Propagation & Coherence | 9% | {0.00-1.00} | {x.xx} | ... |
| R5 | Secrets & Security Boundaries | 11% | {0.00-1.00} | {x.xx} | ... |
| R6 | Test, Molecule & CI Proof | 12% | {0.00-1.00} | {x.xx} | ... |
| R7 | Platform, OS & Topology Variants | 8% | {0.00-1.00} | {x.xx} | ... |
| R8 | CI, Release & Packaging Safety | 7% | {0.00-1.00} | {x.xx} | ... |
| R9 | Documentation & Operator Clarity | 6% | {0.00-1.00} | {x.xx} | ... |
| R10 | Language & Ecosystem Idioms | 6% | {0.00-1.00} | {x.xx} | ... |
| R11 | Reviewability & Commit Hygiene | 4% | {0.00-1.00} | {x.xx} | ... |
| R12 | Local Style & Formatting | 3% | {0.00-1.00} | {x.xx} | ... |
| | **RMI** | **100%** | | **{X.X}/10** | {cap applied?} |

## Findings

### Request Changes

#### [Severity] R# — {finding title}
- **File**: `path/to/file:line`
- **Risk**: ...
- **Why it matters**: ...
- **Fix**: ...
- **Proof expected**: ...
- **Confidence**: High/Medium/Low.
- **Disproof**: ...

### Comments / Should Fix

{same structure, only if applicable}

### Nice To Have

{same structure, only if applicable}

## Good Practices Found

- `path:line` — ...

## Smallest Next Actions

1. ...
2. ...
3. ...

## Approval Conditions

- ...
```

## Compact MR Review Variant

Use this when the user wants a concise MR comment rather than a full audit.

```markdown
**Decision**: {REQUEST_CHANGES | COMMENT | APPROVE_WITH_NOTES | APPROVE} — **RMI {X.X}/10**

{One-sentence summary of primary risk.}

### À corriger avant merge

1. `{file:line}` — {risk}. {smallest fix}. Preuve attendue : {proof}.
2. ...

### Commentaires

- `{file:line}` — {minor/major non-blocking comment}.

### Points positifs

- `{file:line}` — {good practice}.
```

## Line Comment Only Variant

When the user asks for GitLab/GitHub review comments only:

```markdown
`path/to/file:42` — [Major/R2] Il manque l'assertion associée à ce nouveau default. Ajoute type + valeurs autorisées avant les tasks de setup, puis couvre le cas dans Molecule.

`path/to/file:88` — [Minor/R12] Saut de ligne manquant en fin de fichier.
```

## JSON-ish Machine-Readable Summary

Use only if the user requests structured output:

```json
{
  "decision": "REQUEST_CHANGES",
  "rmi": 5.4,
  "caps": ["Deployable behavior changed without proof"],
  "findings": [
    {
      "severity": "Critical",
      "category": "R6",
      "file": "tasks/setup.yml",
      "line": 42,
      "risk": "Behavior changed without Molecule proof",
      "fix": "Add/update scenario covering the new path"
    }
  ]
}
```
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 471kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall