agentleFS
AlexZio00AlexZio00/sovereign-skills/stepback/SKILL.md

stepback

Skill157 starsChanged 34 days agoMITView on GitHub

One-shot perspective reset. Scans current work context, generates 1 abstract reframing question + 3 quick checks (scope drift, side effects, better approach) in under 10 lines. No dialogue, no code, no agents.

1 other project uses a version of this, 1 of them edited.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

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

  • ≈0

    Common · estimate

    Many files like this have a rule of this kind.

  • ≈6

    Distinctive · estimate

    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 when you're deep in implementation and need to check if you're solving the right problem at the right level.

    line 42
  2. Distinctive:

    If drifted → state how

    line 119
  3. Distinctive:

    If on track → "Scope on track."

    line 120
  4. Distinctive:

    If none → "No visible side effects."

    line 124
  5. Distinctive:

    If current approach is right → "Current approach seems appropriate."

    line 128
  6. Distinctive:

    Immediate return: No follow-up after output.

    line 185

≈ “Common” is an estimate: at least 1 in 5 of the 350,495 skill files we read have a rule of the same kind, not the same words. “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

/stepback — One-Shot Perspective Reset

Source: team-attention/hoyeon pattern. Read-only, zero side effects.

Purpose

Scan the current work context, generate 1 abstract reframing question + 3 quick checks (scope drift, side effects, better approach) in under 10 lines. No dialogue, no code, no agents.

Use when you're deep in implementation and need to check if you're solving the right problem at the right level.

Dominant Variable

Whether the work direction is solving the right problem at the right level — if this is off, even flawless implementation produces the wrong outcome.

Key Assumptions

  1. Current work context exists in the conversation — if broken: ask once, "tell me in one line what you're doing."
  2. Output fits an abstraction level expressible in ≤10 lines — if broken: the question is too concrete → self-check "go more abstract."

Trigger

  • /stepback
  • "step back"
  • "zoom out"
  • "blind spot"
  • "am I on track"
  • "big picture"
  • "what am I even doing"

Discard If

  • Work is already completed (use retrospective tools instead)
  • Code review requested (use code review tools instead)
  • Formal impact analysis of a specific change needed (use scope definition tools instead). Stepback itself only gives the one-sentence blast-radius check in Side Effects.

Architecture

Recent conversation context (current work direction)
    ↓
[PARSE]      → Extract current direction + original intent + scope signals
    ↓
[STEP-BACK]  → Generate 1 abstract reframing question
    ↓
[CHECK]      → Run 3 checks
    ↓
[OUTPUT]     → Under 10 lines, return immediately

Stage 1: PARSE

Extract from recent conversation:

  • Current direction — what the user is actively working on
  • Original intent — why this work was started (implicit is OK)
  • Scope signals — size/complexity of the change

Stage 2: STEP-BACK

DeepMind step-back pattern: abstract from the specific subject of current work → the general principle/system it belongs to.

Current WorkStep-Back Question
"Fixing this null pointer bug""Is the error handling strategy of this module correct in the first place?"
"Adding a new API endpoint""Should this feature live in the API layer, or somewhere else?"
"Refactoring this function""Should this function exist at all, or is the caller the real problem?"
"Writing tests for module X""Is X's boundary designed in a testable way?"
"Optimizing this query""Should this query be called at this point at all?"

The question must make the user reconsider whether they're solving the right problem at the right level.


Stage 3: CHECK

Each check = 1 sentence max.

Scope Drift: Has the current work drifted from the original goal?

  • If drifted → state how
  • If on track → "Scope on track."

Side Effects: Could this change affect something else?

  • State potential blast radius (modules, schemas, tests, integrations)
  • If none → "No visible side effects."

Better Approach: Is there a more fundamental/simpler solution?

  • If yes → 1 sentence
  • If current approach is right → "Current approach seems appropriate."

Stage 4: OUTPUT

**Step-Back:** [1 abstract reframing question]

**Scope Drift:** [1 sentence]
**Side Effects:** [1 sentence]
**Better Approach:** [1 sentence]

[Verdict line, one of three:
 - all three checks clean: "Continue."
 - Scope Drift or Side Effects flagged anything: "Stop here and decide whether to return to the original goal."
 - only Better Approach flagged (scope on track, no side effects): "Continue, but weigh the alternative above before going further."]

4 core lines + closing. Under 10 lines total.

Output and stop immediately. No follow-up questions, no menus, no "would you like to...".


Hard Rules

  1. No user questions if context is clear; ask exactly once if unclear — output and return immediately when the work context is clear; only if it is genuinely unclear, ask one clarifying question (see Key Assumptions / Error Recovery), then stop.
  2. No agent spawning — runs in main context only.
  3. No code generation — analysis only. No code writing or suggestions.
  4. No request restatement — don't summarize what the user asked. Analyze what's happening now.
  5. 10-line cap — more than 10 lines means over-explaining. Cut.
  6. 1 question only — suppress the urge to generate multiple step-back questions.

Scope Boundary

DoesDoes NOT
Read recent conversation context for work directionWrite code or modify files
Generate 1 abstract reframing questionSpawn agents, or ask more than the one clarifying question allowed when the work context is unclear
Run 3 checks (scope/side effects/better approach)Suggest next actions or generate menus
Output under 10 lines and return immediatelyContinue working on the task

Safety Layers

Risky ActionReversibilityApplied Layers
(none — read-only one-shot)—L1 (Invariant 3: immediate return, no further action)

Invariants (never violate)

  1. 10-line cap: Output exceeding 10 lines has already failed. Cut it down. Violation → over-explanation dilutes the perspective reset.
  2. 1 question limit: Multiple questions split focus. Pick the most important one. Violation → user gets a list instead of a lens.
  3. Immediate return: No follow-up after output. User decides what to do next. Violation → stepback becomes a dialogue instead of a reset.

Error Recovery

Failure TypeDetectionRecovery
input_errorCurrent work context unclearAsk once: "tell me in one line what you're doing now"
missing_dataNo concrete work context in the conversation (no files, changes or goal mentioned)Infer from the user's last message. If inference is impossible, use generic reframing. This skill has no shell, so it does not read git state

Example

User: "/stepback"
(Context: debugging a flaky integration test that intermittently times out)

**Step-Back:** Is the test flaky because of a timing issue, or because the component under test has a non-deterministic dependency that shouldn't be there?

**Scope Drift:** Started with fixing one test, now touching retry logic in three modules.
**Side Effects:** Changing the retry config could mask real failures in CI.
**Better Approach:** Check if the test is testing the right thing — a unit test might eliminate the flakiness entirely.

Stop here and decide whether to return to the original goal.

Rationalization Table

RationalizationCounter
"10 lines isn't enough, I need to explain more"If 10 lines isn't enough, the question isn't abstract enough. Go higher.
"I should ask the user to confirm before continuing"Stepback is one-shot. If confirmation is needed, the user will follow up.
"Two questions would be more useful"Two questions halve the focus. Picking one better question is the answer.
"Showing code would make it more concrete"Stepback is direction check, not code review. No code generation.

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.