impasse-detector

name	Impasse Detector
description	Detects when the agent is stuck in a reasoning loop or unproductive state by analyzing tool usage and sentiment patterns.
version	1.0.0
author	Antigravity Skills Library
created	"2026-01-16T00:00:00.000Z"
leverage_score	5/5

SKILL-017: Impasse Detector

Overview

Critical meta-cognitive skill that acts as a circuit breaker for unproductive loops. It analyzes recent conversation history and tool outputs to detect "stuck" states, preventing token wastage on failing paths and forcing escalation or delegation.

Trigger Phrases

• check logic
• am i stuck
• detect loop
• impasse check

Inputs

Parameter	Type	Required	Default	Description
--TranscriptPath	string	No	$null	Path to conversation log/json
--Content	string	No	$null	Direct string content to analyze
--Lookback	int	No	10	Number of recent turns to analyze

Outputs

1. Analysis Result (JSON)

{
  "status": "IMPASSE",
  "confidence": 0.95,
  "reasons": [
    "Apology loop detected (4 occurrences)",
    "High frequency of file reads (6 in window)"
  ],
  "recommendation": "ESCALATE_TO_USER",
  "score": 80
}

2. Status Codes

• CLEAR: No issues detected.
• IMPASSE: Significant loop/blockage detected.
• UNKNOWN: Insufficient data.

Preconditions

1. Access to conversation history OR a provided transcript string.
2. PowerShell 5.1+ or Core 7+.

Safety/QA Checks

1. Read-Only: This skill only analyzes text; it does not modify state.
2. Fail-Safe: If input is missing/malformed, defaults to "UNKNOWN" rather than crashing.

Stop Conditions

Condition	Action
No input provided	Return status "UNKNOWN" (0 confidence)
File not found	Return error JSON

Implementation

See scripts/detect_impasse.ps1.

Integration with Other Skills

All agent loops should:

1. Call SKILL-017 every 5-10 turns.
2. If status is IMPASSE, trigger SKILL-020 (Failure Postmortem) AND SKILL-010 (Async Feedback).
3. If score > 90, stop execution and warn user.