harness-deflate

Scans the whole codebase for structural entropy and dispatches authorized refactorings to a goal-driven loop.

Updated May 15, 2026
One-click install
npx skills add https://github.com/Alan-IFT/harness-kit --skill harness-deflate-alan-ift
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: harness-deflate
Source: https://github.com/Alan-IFT/harness-kit/tree/main/skills/harness-deflate
Command: npx skills add https://github.com/Alan-IFT/harness-kit --skill harness-deflate-alan-ift

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Large codebases accumulate structural rot — shallow modules, cross-seam leakage, coupling clusters — that no single task ever fixes. This Skill performs a holistic anti-entropy sweep across the entire codebase, presents each finding with its location and a strength badge, and only refactors after your explicit authorization. ## Core Features & Use Cases - Whole-codebase entropy scan: Dispatches a read-only supervisor agent in entropy mode to classify findings as EP-1 shallow module, EP-2 cross-seam leakage, EP-3 coupling cluster, or EP-4 deepening candidate, each with a deletion-test verdict and a Strong / Worth exploring / Speculative badge. - Authorization-gated execution: Never edits code itself (no Edit/Bash tools); on your explicit pick it hands the chosen deepening to /harness-goal, which runs a Dev + QA loop until verify_all is green. - Declined-finding memory: Records declined findings in .harness/rejected-decisions.md so they stop re-surfacing on future sweeps, using a deterministic normalized-path filter. - Use Case: After months of rapid feature work, run a sweep to find where the ball of mud is forming, review the findings table, decline the low-value items, and authorize one coupling-cluster deepening to be refactored to green. ## Quick Start Ask the AI to run an anti-entropy sweep over the whole codebase and show where structural rot is accumulating.

Frequently Asked Questions about harness-deflate

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find structural rot across my whole codebase?▼

Run an anti-entropy sweep that dispatches a read-only supervisor agent in entropy mode. It classifies findings as shallow modules, cross-seam leakage, coupling clusters, or deepening candidates, each with a file location, strength badge, and deletion-test verdict.

What is the difference between harness-deflate and harness-supervise?▼

harness-deflate scans the whole codebase for structural entropy, while harness-supervise audits a single task folder for pipeline anti-patterns like rollback rate and thin docs. Use deflate for holistic structure, supervise for per-task pipeline health.

Does the entropy scan refactor code automatically?▼

No. The scan agent is observer-only with no edit capability, and the skill itself has no Edit or Bash tools. Refactoring happens only after you explicitly authorize a finding, which is then dispatched to /harness-goal to execute to verify_all green.

How do I stop a declined finding from reappearing in future scans?▼

Decline the finding when presented; the skill records it in .harness/rejected-decisions.md keyed by its normalized file path. Future scans read that file and deterministically filter out any finding whose location exactly matches a declined record.

When should I use harness-goal directly instead of an entropy sweep?▼

Use /harness-goal directly when you already know the exact deepening you want and just need it executed to green. The sweep is for discovering where rot exists when you do not yet know what to fix.