Skip to content

ericrisco/rsc-harness / skills/harness

harness

Flagged

Use when governing a workspace's control plane, code or not — the `01-TOOLS/` tooling layer, the `02-DOCS/` chaos→knowledge wiki, the root Knowledge map. Audits it, migrates legacy `XX-*` folders, scaffolds provider tooling, sweeps the inbox, eats a file the person hands over ("cómete este fichero", "guárdalo en la documentación": moved into 02-DOCS/raw/ and documented), writes root CLAUDE.md/AGENTS.md. NOT the bootstrap front door (that is `init`, which hands off here).

examples/audit-example.md

View on GitHub
# Example — AUDIT output for a synthetic brownfield project

This is a real example of the AUDIT report the skill produces. Use it as
a reference for formatting, level of detail, and how to handle edge
cases (ambiguous files, legacy folder migration, the embedded wiki
bootstrap).

## Input project

```
/tmp/risco-harness-test/
├── backend/
│   ├── pyproject.toml          ← deps: fastapi, stripe, mailjet-rest
│   ├── .env.example            ← STRIPE_SECRET_KEY, MAILJET_*
│   └── app/services/
│       ├── billing.py          ← import stripe
│       └── email.py            ← from mailjet_rest import Client
├── frontend/
│   └── package.json            ← deps: next@15, @stripe/stripe-js
├── 00-TOOLS/
│   ├── STRIPE/
│   │   ├── test_connection.sh  ← legacy bash, has shebang
│   │   └── README.md           ← legacy tool doc
│   └── random_helper.py        ← Python without shebang, unclear purpose
└── 03-NOTES/
    └── architecture.md         ← prose docs
```

## AUDIT output

```
# Audit — harness — 2026-05-31

Workspace: /tmp/risco-harness-test

## 1. Stack detected
- Backend: FastAPI (Python) — backend/ — pyproject.toml (fastapi, stripe, mailjet-rest)
- Frontend: Next.js 15 — frontend/ — package.json (next@15, @stripe/stripe-js)

## 2. Tools to create in 01-TOOLS/

| Tool   | Category    | Evidence | Action |
|--------|-------------|----------|--------|
| STRIPE | pagos       | backend/app/services/billing.py:1 (import stripe); pyproject.toml dep; frontend dep | MERGE — legacy 00-TOOLS/STRIPE/ exists |
| MAILJET| email       | backend/app/services/email.py:1 (from mailjet_rest); pyproject.toml dep            | CREATE |

Rest of the catalog: SKIP — no evidence.

## 3. Legacy XX-* folders

### 00-TOOLS/
| File | Classification | Proposed destination |
|------|----------------|----------------------|
| STRIPE/test_connection.sh | TOOLING | 01-TOOLS/STRIPE/migrated/test_connection.sh (collision with catalog) |
| STRIPE/README.md          | TOOLING | 01-TOOLS/STRIPE/migrated/README.md (collision with catalog) |
| random_helper.py          | AMBIGUOUS | (stays in 00-TOOLS/) |

Total: 3 · TOOLING: 2 · DOCS: 0 · AMBIGUOUS: 1
Deletion of 00-TOOLS/: BLOCKED — AMBIGUOUS present.

### 03-NOTES/
| File | Classification | Proposed destination |
|------|----------------|----------------------|
| architecture.md | DOCS | 02-DOCS/raw/migrated/03-NOTES/architecture.md |

Total: 1 · TOOLING: 0 · DOCS: 1 · AMBIGUOUS: 0
Deletion of 03-NOTES/: candidate for second consent.

## 4. Documentation → 02-DOCS/ (embedded protocol)
Sources to ingest (following references/wiki-protocol.md):
- 01-TOOLS/README.md (after creation)
- 01-TOOLS/STRIPE/README.md + CREDENTIALS.md
- 01-TOOLS/MAILJET/README.md + CREDENTIALS.md
- 02-DOCS/raw/migrated/03-NOTES/architecture.md (after migration)
- Root CLAUDE.md and AGENTS.md

## 5. Root files
| File       | State       | Action |
|------------|-------------|--------|
| CLAUDE.md  | does not exist | CREATE from template |
| AGENTS.md  | does not exist | CREATE from template |

## 6. Files I will NEVER touch
- 01-TOOLS/**/.env (real)
- backend/.env.example, backend/app/**, frontend/package.json — subproject internals
- node_modules/, .venv/, .next/, __pycache__/, .dart_tool/, .git/

## 7. Subprojects git state
No Git repos in the subprojects. Nothing to stash.

## 8. Destructive operations
| Operation         | When |
|-------------------|------|
| Delete 00-TOOLS/  | NEVER in this run (AMBIGUOUS present) |
| Delete 03-NOTES/  | After migration + literal second consent "yes, delete 03-NOTES" |

## Proceed?
Respond with the literal string:
- "yes, proceed" — run the plan
- "adjust" — modify
```

## Lessons from this example

1. **Ambiguity blocks deletion.** `random_helper.py` (no shebang, no
   catalog provider integration) → AMBIGUOUS → `00-TOOLS/` is preserved
   after migration. Don't force the classification.

2. **Collision = `migrated/`.** When a legacy file
   (`00-TOOLS/STRIPE/test_connection.sh`) collides with the catalog
   file, it goes to `01-TOOLS/STRIPE/migrated/` for the user to resolve
   manually. The catalog is NEVER overwritten.

3. **Subproject internals are invisible.** `backend/.env.example`,
   `backend/app/services/*.py`, `frontend/package.json` are READ for
   detection but NEVER moved or modified.

4. **Two distinct consents.** "yes, proceed" authorizes the general
   APPLY. "yes, delete 03-NOTES" is ANOTHER, deletion-specific consent
   quoting the exact 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