Claude Skill

clean-and-true

Use when the user just edited a durable artifact, or says "clean and true", "run the hygiene pass", or "taste the output". Routes the artifact through the hygiene passes it earned.

LLM Mart · 0 points · 0 0 0

Virus-scanned Reviewed automatically before listing.

Full trust report

Download outlinedriven-outline-driven-development-.devin_skills_clean-and-true-b0e8ce8.zip · 2 KB

outlinedriven/outline-driven-development 54 10 forks Apache-2.0 Updated 3d ago

Part of outlinedriven/outline-driven-development — 145 skills

Install

skills CLI npx skills add https://github.com/OutlineDriven/outline-driven-development/tree/main/.devin/skills/clean-and-true

Claude Code

claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install outlinedriven-outline-driven-development@llmmart

Git git clone https://github.com/OutlineDriven/outline-driven-development.git

The skills CLI installs just this skill, for any of its supported agents. Claude Code installs the whole outlinedriven/outline-driven-development collection as a plugin from our marketplace. Git is the plain clone.

Skill manifest

Clean and true

Contract

Field	Bound contract
Trigger	Fires automatically after editing a durable artifact, or when the user says "clean and true", "run the hygiene pass", or "taste your own output".
Authority	Reversible local: writes only the just-changed durable artifact; rollback is restoring that artifact's prior on-disk content. No VCS, credential, paid, published, deployed, or remote mutation.
Side effect	May revise the just-changed local artifact through applicable hygiene passes only.
Done	Every applicable hygiene route ran or has a stated skip reason; findings are applied or explicitly deferred; no-op when nothing improves.

Inputs

The just-changed durable artifact (path or content). Must be supplied.
The set of hygiene passes available in the session. Optional; a pass absent from the session is skipped with a stated reason.

Procedure

Identify the just-changed durable artifact and bound scope to it; do not read or edit any other file. Done when: the artifact is identified and scope is bounded to it.

Classify what changed in the artifact and route to the hygiene pass the change earned:

What changed	Hygiene route	Skip when
Drifted prose that reads as sediment	Rewrite as a clean v0 from current truth	No sediment accumulated
Padded prose whose every rule still binds	Debloat: cut what no rule depends on	Nothing padded to cut
Anything a stranger must understand alone	Cold-read for standalone clarity	Short-lived or author-only
A reality-grounded claim	Verify the claim both ways	No such claim present
A truth duplicated across places	SSOTize: fold into one home, point the rest at it	A single home already holds it
Voice, tells, or stack residue in prose	Strip tells and restore voice	Not prose, or not stale

Done when: each change is classified and routed to its hygiene pass or marked with a skip reason.

Run each routed pass over the artifact. Skip any pass not available in the session with a stated reason. Done when: every routed pass is run or skipped with a reason.
Apply the findings to the artifact in this session. Done when: findings are applied to the artifact or explicitly deferred with a reason.
If a pass finds no genuine improvement, leave the artifact unchanged for that route. Done when: each route is confirmed as applied, deferred, or no-op.

Failure and recovery

No applicable route: state that no hygiene route earned a run and leave the artifact unchanged; this is not an error.
Routed pass unavailable in session: skip it with a stated reason and continue the remaining routes; the partial result is the set of routes that ran.
Routed pass reports a finding that cannot be safely applied: defer it with a stated reason rather than widen scope or invent a fix.
Non-mutation rule: never edit files outside the just-changed artifact; recovery is the prior on-disk content of that artifact.

Output

The revised artifact with findings applied, plus a per-route record stating whether each route ran, was skipped (with reason), or was deferred (with reason); if a pass finds no genuine improvement, it changes nothing.

Files (outline-driven-development)

agents

openai.yaml 196 B

interface:
  display_name: "Clean And True"
  short_description: "Use when the user just edited a durable artifact, or says \"clean and true\", \"run the hygiene pass\", or \"taste the output\"."

references

idioms.md 1.2 KB

# Shared idioms

Owned by `clean-and-true`. Linked by consumers at `../clean-and-true/references/idioms.md`.

- Edit safety: `rewrite-clean-v0`, `reorder`, `deslop` (bloat mode), `ssotize-audit-fold`
- Clean room: `fresh-reader-review`, `decision-rationale-gaps`, `prism`, `evaluation-leakage-audit`, `guardrail-carve-run`
- Negatives as corpus: `restart-keeping-lessons`, `guardrail-carve-run`

## Edit safety

Assert the target exists and report a `MISS` rather than a silent no-op.
Replace positional targets per occurrence after judging each one, never as a
blanket sweep. Script a large structural move rather than hand-editing it.

Upstream's `PYTHONUTF8=1` guidance is replaced by ODIN's own mechanism:
anchored `edit` calls against a snapshot tag, re-reading after any edit that
renumbers.

## Clean room

A fresh zero-context sub-session receives the artifact and nothing else: no
conversation history, author's framing, or prior verdict. Without that context,
it cannot infer what the author meant. The sub-session reads and reports but
does not edit.

## Negatives as corpus

A cut is a move to an archive, never a delete. A pruned branch and a failed
attempt are evidence about the problem, and the reason a later attempt does not
repeat them.

SKILL.md 3.4 KB

---
name: clean-and-true
description: 'Use when the user just edited a durable artifact, or says "clean and true", "run the hygiene pass", or "taste the output". Routes the artifact through the hygiene passes it earned.'
---

# Clean and true

## Contract

| Field | Bound contract |
|---|---|
| Trigger | Fires automatically after editing a durable artifact, or when the user says "clean and true", "run the hygiene pass", or "taste your own output". |
| Authority | Reversible local: writes only the just-changed durable artifact; rollback is restoring that artifact's prior on-disk content. No VCS, credential, paid, published, deployed, or remote mutation. |
| Side effect | May revise the just-changed local artifact through applicable hygiene passes only. |
| Done | Every applicable hygiene route ran or has a stated skip reason; findings are applied or explicitly deferred; no-op when nothing improves. |

## Inputs

- The just-changed durable artifact (path or content). Must be supplied.
- The set of hygiene passes available in the session. Optional; a pass absent from the session is skipped with a stated reason.

## Procedure

1. Identify the just-changed durable artifact and bound scope to it; do not read or edit any other file. **Done when:** the artifact is identified and scope is bounded to it.
2. Classify what changed in the artifact and route to the hygiene pass the change earned:

   | What changed | Hygiene route | Skip when |
   |---|---|---|
   | Drifted prose that reads as sediment | Rewrite as a clean v0 from current truth | No sediment accumulated |
   | Padded prose whose every rule still binds | Debloat: cut what no rule depends on | Nothing padded to cut |
   | Anything a stranger must understand alone | Cold-read for standalone clarity | Short-lived or author-only |
   | A reality-grounded claim | Verify the claim both ways | No such claim present |
   | A truth duplicated across places | SSOTize: fold into one home, point the rest at it | A single home already holds it |
   | Voice, tells, or stack residue in prose | Strip tells and restore voice | Not prose, or not stale |

   **Done when:** each change is classified and routed to its hygiene pass or marked with a skip reason.
3. Run each routed pass over the artifact. Skip any pass not available in the session with a stated reason. **Done when:** every routed pass is run or skipped with a reason.
4. Apply the findings to the artifact in this session. **Done when:** findings are applied to the artifact or explicitly deferred with a reason.
5. If a pass finds no genuine improvement, leave the artifact unchanged for that route. **Done when:** each route is confirmed as applied, deferred, or no-op.

## Failure and recovery
- No applicable route: state that no hygiene route earned a run and leave the artifact unchanged; this is not an error.
- Routed pass unavailable in session: skip it with a stated reason and continue the remaining routes; the partial result is the set of routes that ran.
- Routed pass reports a finding that cannot be safely applied: defer it with a stated reason rather than widen scope or invent a fix.
- Non-mutation rule: never edit files outside the just-changed artifact; recovery is the prior on-disk content of that artifact.

## Output
The revised artifact with findings applied, plus a per-route record stating whether each route ran, was skipped (with reason), or was deferred (with reason); if a pass finds no genuine improvement, it changes nothing.