agentleFS
June74June74/agentic-workflow/skills/escalate/SKILL.md

escalate

Skill0 starsChanged 3 months agoMITView on GitHub

Use on convene deadlock, a discovered blocker, an un-inferable acceptance criterion, or any agent error. Produces a one-screen escalation to the human product manager.

5 other projects use a version of this.

Adopted by

Most recently taken up by

The file

We split this skill into the rules it gives an agent

2 rules. 0 are common, 1 is distinctive, and 1 is very specific to this project.

  • 0

    Common

    Most of the 5 edited versions we read keep these.

  • 1

    Distinctive

    This author's own choices. Worth a look.

  • 1

    Very specific

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

  • Common
  • Distinctive
  • Very specific
  1. Very specific:

    Any agent error: after the single retry. See halt.

    line 18
  2. Distinctive:

    Never name the models behind the positions.

    line 54

“Common” is measured: kept by at least 6 in 10 of the 5 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

Escalate

The PM is not the system's runtime. Every escalation costs them an interruption, so each one must be decidable in under a minute and must actually need them.

When to escalate

  • Deadlock — two full convene rounds without convergence.
  • Blocker — work cannot proceed and no team can unblock it.
  • Un-inferable acceptance criteria — the goal does not reasonably imply what "done" means. Ask rather than guess; a guessed criterion is the system grading its own homework.
  • Any agent error after the single retry. See halt.
  • A recorded decision needs reversing and the council cannot agree on the replacement.

When NOT to escalate

Something is merely difficult. A team disagrees but a criterion resolves it. You want reassurance. The answer is recoverable from .agentic/DECISIONS.md, the profile, or the repo. Escalating these trains the PM to skim.

Format — one screen, hard limit

Use templates/escalation.md.

BLOCKED: <what cannot proceed, one line>

QUESTION: <the actual decision, phrased as a choice>

OPTION A — <name>
  case:  <one paragraph, the strongest version of this side>
  costs: <what it gives up>

OPTION B — <name>
  case:  <one paragraph, the strongest version of this side>
  costs: <what it gives up>

RECOMMENDATION: <which, and the criterion>

WHILE YOU DECIDE: <what is still running, what is idle, what is burning cost>

Present each option at its strongest. An escalation where one option is obviously strawmanned is a decision already made, dressed as a question — and the PM will notice.

Never name the models behind the positions. The PM decides on merit for the same reason the council drafts blind.

After the answer

Record the PM's decision as a Decision Record with the PM named as the decider. It is now a recorded decision like any other: reversing it later flags the step.

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.

Reviews can't be read right now.

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.