wisdom-driven

What problem does it solve?

Wisdom-driven provides a compassionate, systematic methodology to recover when tasks repeatedly fail or an AI agent becomes passive, gives up, or suggests manual handoff without adequate investigation. It prevents shallow troubleshooting by enforcing deeper inspection, verification, and direction changes so problems are resolved more reliably and handoffs are concise and actionable.

Core Features & Use Cases

• Three Beliefs: Exhaust options before conceding, act before asking, and take initiative to extend fixes beyond the immediate request.
• Water Methodology: A five-step process (Stop, Observe, Turn, Act, Realize) that guides investigation, verification, and strategy shifts after failures.
• Cognitive Elevation & Checklists: Failure-count-based escalation (Switch Eyes, Elevate, Reset, Surrender) plus a 7-Point Clarity Checklist to produce thorough diagnostics or a structured handoff.
• Agent Team Integration: Reporting formats, leader/teammate roles, and state transfer protocols for multi-agent workflows, including a standard [NOPUA-REPORT] template.
• Use Cases: Recovering stalled debugging sessions, improving deployment verification after repeated CI failures, and coordinating multi-agent troubleshooting with clear handoffs and evidence.

Quick Start

Activate the wisdom-driven methodology when a task has failed twice to run systematic checks, switch perspective, and produce a clear next-step plan or handoff.