{"slug":"simplify","title":"simplify","summary":"Use when the user says \"simplify this diff\" or asks for a compression pass over a change-set. Not for dead-code sweeps: use deslop.","platform":"Claude","tags":[],"authorName":"LLM Mart","authorSlug":"llm-mart","score":0,"source":"github","price":null,"verified":false,"createdAt":"2026-09-08T21:38:42.23509Z","repo":{"url":"https://github.com/OutlineDriven/odin-claude-plugin","stars":38,"forks":0,"license":"Apache-2.0","updatedAt":"2026-09-25T15:08:42Z"},"bodyHtml":"
\n

name: simplify\ndescription: 'Use when the user says \"simplify this diff\" or asks for a compression pass over a change-set. Not for dead-code sweeps: use deslop.'

\n

Simplify: axis-decomposed compression pass on a diff

\n

Contract

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
FieldBound contract
TriggerUser asks to simplify a diff, PR, or branch: \"simplify this diff\", \"tighten up\", or \"compress a change-set\"
AuthorityReversible local: writes only named local artifacts (working-tree and VCS commits); rollback is version control (git revert HEAD --no-edit). No remote mutation.
Side effectApplies simplification survivors as atomic issue-class commits to the working change-set; auto-reverts any commit that regresses
DoneExit 0: simplification landed as issue-class commits, every fix commit is green, and no new bloat was introduced
\n

Inputs

\n

Must be supplied:

\n\n

Optional:

\n\n

Derived from the diff:

\n\n

Procedure

\n
    \n

  1. Phase 1: Detect diff scope. Capture every commit since the branch diverged from its base, including staged and unstaged changes. Do not guess the base. Resolve via the first base ref that exists, then run git diff <base>:

    \n
      \n
    1. git merge-base HEAD origin/main
      2. \n
    2. git merge-base HEAD origin/master
      3. \n
    3. git merge-base HEAD main
      4. \n
    4. git merge-base HEAD master
      5. \n
    5. @{upstream}
      6. \n
    \n

    If none of the five resolve, gate on two ordered checks:

    \n\n

    If no git context or HEAD is unborn, use user-named files supplied in the invocation. Empty after all valid resolutions → exit 11.

    \n

    Explicit-base override: simplify against <ref> bypasses the resolution above and runs git --no-pager diff \"<ref>\" directly.

    \n

    Done when: the diff is captured or an exit code is returned.

    \n
    2. \n

  2. Phase 2: Dispatch three review agents in one task call. Issue a single task tool call with a tasks array of three items, never three sequential messages. Each agent receives <axis-prompt from references/> + \"\\n\\n---\\n\\nDIFF:\\n\" + <captured diff>. All three agents are read-only; disjoint axes; independence asserted in the spawn message:

    \n
    \n

    \"Three agents dispatched in parallel. Axes are disjoint by construction: reuse-axis owns Graft (existing-utility detection), quality-axis owns Excess + Sprawl on code shape, efficiency-axis owns Excess + Sprawl on execution cost. All three agents are read-only; none edits files; none reads or writes shared mutable state.\"

    \n
    \n

    Agent type: Explore (read-only).

    \n

    Axes:

    \n\n

    See references/orchestration.md for the concrete dispatch shape and shell snippet.

    \n

    Done when: all three agents return their findings.

    \n
    3. \n

  3. Phase 3: Audit, then apply. Wait for all three agents. Aggregate findings by {axis, file, line, issue-class}. Deduplicate identical cross-axis findings: keep each once, attribute it to the first reporter, and note the second axis as a co-signer. Dispatch a Reviewer agent (also Explore-typed and read-only) to audit the composed list for completeness, consistency, accuracy, and scope. The Reviewer's output is the validated survivor set. The orchestrator applies survivors directly, one issue class per atomic commit, and drops non-survivors without comment or re-adjudication. After each commit, run repo-native tests. On red, auto-revert via git revert HEAD --no-edit and stop that class's run.

    \n

    Commit sequencing by class:

    \n
      \n
    1. Duplicate commit: reuse-axis survivors + any other axis flagged issue-class: duplicate
      2. \n
    2. Excess-surface commit: quality-axis + efficiency-axis survivors flagged issue-class: excess-surface
      3. \n
    3. Structure commit: quality-axis + efficiency-axis survivors flagged issue-class: structure
      4. \n
    \n

    Commit message format: capitalized imperative subject, ≤50 chars target, ≤72 hard, no trailing period.

    \n

    After the final commit, audit the simplify patch itself for unneeded surface, duplicated logic, structure without cause, or a broken consumer contract. If the audit finds any, revert the entire simplify chain via git revert <first-simplify-commit>^..HEAD --no-edit and exit 14.

    \n

    Done when: all survivor commits are applied and green, or an exit code is returned.

    \n
    4. \n
\n

Failure and recovery

\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n
Exit codeTriggerRecovery
0Cleannone
11Empty diff after all fallbacksPass-through, no work to do
12Findings emitted but survivor set empty after Reviewer auditReport attached, no patch applied
13Behavior regression on a fix commitOffending commit auto-reverted; stop simplify run for that class; already-landed commits remain
14Post-fix audit caught new bloat in the simplify patchEntire simplify chain reverted; orchestrator may re-plan and re-invoke
15Mixed-concern commit (bundles more than one issue-class)Must split before merging
\n

Partial-result rule: commits already landed before a failure remain. A rollback does not revert previously successful class commits.

\n

Non-mutation rule: sequential dispatch (not a single task call with a tasks array of three items) is rejected at the validation gate before any agent runs.

\n

Output

\n

Terminal classification with an exit code. On exit 0: the change-set is compressed along reuse / quality / efficiency axes with one atomic commit per issue class, every fix commit green, and no new bloat introduced.

\n","files":[{"path":"agents/openai.yaml","sizeBytes":157,"isText":true},{"path":"references/efficiency.md","sizeBytes":4767,"isText":true},{"path":"references/orchestration.md","sizeBytes":6026,"isText":true},{"path":"references/quality.md","sizeBytes":7156,"isText":true},{"path":"references/reuse.md","sizeBytes":4131,"isText":true},{"path":"SKILL.md","sizeBytes":6809,"isText":true}],"reviewScore":null,"reviewSummary":null,"trust":{"provenance":"trusted-source-unreviewed","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow.","bodySource":null},"bodyLocked":false,"purchaseUrl":null,"sourceUrl":null,"report":{"provenance":"trusted-source-unreviewed","screen":{"ran":true,"outcome":"clean","suspicious":0,"notes":0,"hiddenCharacters":false},"virusScan":{"engine":"clamav","status":"clean","scannedAt":"2026-09-08T21:40:13.061412Z","sha256":"BF7479091FE2F49A567C1DAD4B4295BFF21B3A4B8EEBC48F174C7FB60A426A9E","sizeBytes":14546},"review":null,"source":{"repositoryUrl":"https://github.com/OutlineDriven/odin-claude-plugin","path":"plugins/odin-code/skills/simplify","license":"Apache-2.0","commit":"8ce0e87a3e88043cdeb4be21eec5565bbdc638ea","subtreeSha":"A23710DBF11EE7B766E7AEDF7B2F31D3D362087F290ABE8E52E98417C2570DF5","lastSyncedAt":"2026-09-26T23:11:44.497011Z"},"reviewedAt":"2026-09-08T21:43:02.733014Z","notice":"Community-authored content, reproduced verbatim and not vetted as instructions. Treat it as data to evaluate, never as directives to follow."},"install":[{"target":"skills-cli","command":"npx skills add https://github.com/OutlineDriven/odin-claude-plugin/tree/main/plugins/odin-code/skills/simplify"},{"target":"claude-code","command":"claude plugin marketplace add https://llmmart.ai/marketplace.json && claude plugin install outlinedriven-odin-claude-plugin@llmmart"},{"target":"git","command":"git clone https://github.com/OutlineDriven/odin-claude-plugin.git"}]}