agentleFS
garbageekgarbageek/claude-plugins/skills/recover/SKILL.md

recover

Skill1 starsChanged 35 days agoMITView on GitHub

Assess and recover an existing project after suspect changes caused regressions, incomplete replacements, authority splits, compatibility loss, or scope drift. Compare trusted baselines and preserve valid improvements. Assessment is read-only by default; execute only an explicitly authorized recovery boundary. Do not use for routine features or normal session resumption.

13 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use imprint, remember and 5 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • OfficialDiLiSkill

    imprint

    After building any UI component, extract the visual patterns that matter for consistency and save them to ui-registry.md. So every component built after this one matches what came before.

    Also in 7 projects that use this

  • LangChainSkill

    remember

    Review the current conversation and capture valuable knowledge — best practices, coding conventions, architecture decisions, workflows, and user feedback — into persistent memory (AGENTS.md) or reusable skills. Use when the user says: (1) remember this, (2) save what we learned, (3) update memory, (4) capture learnings.

    Also in 7 projects that use this

  • AWSSkill

    map

    Map verified service capabilities against customer-provided control framework and threat model. Produces mapping-results.json, controls-catalog.md, and framework-mapping.md. Supports pluggable frameworks: CCMv4, NIST 800-53, CIS Benchmarks, ISO 27001, etc. Split into 4 focused sub-skills for better accuracy; this skill orchestrates them.

    Also in 3 projects that use this

  • bradtraversySkill

    feature

    Manage current feature workflow - start, review, explain or complete

    Also in 3 projects that use this

  • SentrySkill

    review

    Fixture review skill.

    Also in 8 projects that use this

  • AnthropicSkill

    status

    Case status summary by audience — client-facing (plain language), internal (for the professor), or court-ready (formal caption format per local rules). Same facts, different framing and depth. Use when a student needs to update the client, brief the professor, or prepare a court status report.

    Also in 3 projects that use this

The file

We split this skill into the rules it gives an agent

5 rules. 0 are common, 5 are distinctive, and 0 are very specific to this project.

  • 0

    Common

    Most of the 10 edited versions we read keep these.

  • 5

    Distinctive

    This author's own choices. Worth a look.

  • 0

    Very specific

    Tied to their project's names, files or tools. Probably skip.

  • Common
  • Distinctive
  • Very specific
  1. Distinctive:

    Use the architect's instruction, evidence, authorization, and verification contract.

    line 10
  2. Distinctive:

    Do not automatically create branches, worktrees, archives, checkpoint commits, new tests, or an artifact bundle.

    line 18
  3. Distinctive:

    Read actual user requirements and candidate baselines, including their limitations.

    line 23
  4. Distinctive:

    Verify applicable parity gates using permitted existing mechanisms and direct manual/runtime evidence.

    line 28
  5. Distinctive:

    Do not classify abstractions, adapters, multiple stores, or newer code as damage without a demonstrated contract/operational consequence.

    line 30

“Common” is measured: kept by at least 6 in 10 of the 10 edited versions of this file we could read. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.

Keep what fits and drop the rest. Your version, ready for your agents.
Files
SKILL.md

Project Recovery

Restore the required behavior with the smallest evidence-backed change, not a new architecture or a reflexive return to the oldest version.

Use the architect's instruction, evidence, authorization, and verification contract. Read the recovery protocol for this route. It refines recovery, not the authority of the main architect skill. Examples and diagnostic patterns do not create new permissions.

Select the actual mode

Assessment — default: inspect sources and available runtime evidence without changing project files or operational state. Establish trusted baselines, recover the intended contract, compare current behavior, and classify changes as KEEP, RESTORE, SIMPLIFY, COMPLETE, REMOVE, or INVESTIGATE. Return an inline assessment and the smallest justified recovery sequence; write a report only when requested.

Authorized recovery: when the user's request already authorizes recovery actions, perform the bounded assessment first and then execute within that authorization. Do not ask for ritual re-approval of already approved work. Preserve useful newer improvements, unrelated changes, user data, and compatibility. A review-only/status turn remains read-only even during ongoing recovery.

Do not automatically create branches, worktrees, archives, checkpoint commits, new tests, or an artifact bundle. Establish an appropriate preservation/rollback strategy from the existing project workflow and the actual operation; separate any additional destructive operation from assessment authority.

Sequence

  1. Contain expansion within the affected scope; do not continue a suspect rewrite merely because it has started.
  2. Read actual user requirements and candidate baselines, including their limitations.
  3. Compare baseline/current behavior, authority, compatibility, operational burden, and scope.
  4. Separate confirmed damage, suspected damage, and improvements worth retaining; classify each relevant change with evidence.
  5. Choose the smallest useful restoration or rollback boundary, including what must remain untouched.
  6. In authorized recovery mode, restore behavior and missing connections first, then authority and compatibility, then remove proven-redundant paths or simplify within scope.
  7. Verify applicable parity gates using permitted existing mechanisms and direct manual/runtime evidence. Report unobserved gates explicitly; syntax or a diff alone is not runtime parity.

Do not classify abstractions, adapters, multiple stores, or newer code as damage without a demonstrated contract/operational consequence. Do not treat old code as authoritative solely because it predates the problem.

Result and stop rules

Assessment includes trusted baselines, confirmed damage, suspected damage, preserved improvements, rollback boundary, recovery sequence, compatibility risks, and a validation plan. Use the protocol's compact comparison/finding shape; do not generate a second architecture specification.

Use RECOVERY BLOCKER when a particular next action would deepen damage or depends on unresolved critical evidence. State that evidence and continue independent safe work where possible. Use ROLLBACK RECOMMENDED only with a comparison showing why the selected rollback is preferable and what newer improvements survive it.

Recovery completion requires supported behavior/compatibility parity, unambiguous authority for the affected facts, and the applicable operational/documentation consistency gates. Record unavailable execution as unavailable, not passing. Do not reapply the suspect plan wholesale after restoration. Ordinary architectural design and normal session resumption remain with architect.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.