harness-supervise

Analyzes 7-stage task folders and generates supervision reports flagging pipeline anti-patterns.

Updated May 15, 2026
One-click install
npx skills add https://github.com/Alan-IFT/harness-kit --skill harness-supervise-alan-ift
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: harness-supervise
Source: https://github.com/Alan-IFT/harness-kit/tree/main/skills/harness-supervise
Command: npx skills add https://github.com/Alan-IFT/harness-kit --skill harness-supervise-alan-ift

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When running multi-stage AI development pipelines, problems like repeated rollbacks, thin stage documentation, and skipped intervention checks accumulate silently. This Skill audits in-flight or archived task folders and surfaces these anti-patterns with severity ratings so you know when to step in. ## Core Features & Use Cases - Anti-pattern detection: Detects five fixed-threshold anti-patterns (same-stage rollbacks, cross-stage rollback tallies, stage-doc thinness, missing intervention checks, missing archive calls) with deterministic INFO/WARN/ALERT severity. - Single-task and cross-task modes: Audit one task by slug, the last N archived tasks, or every archived task, with token-budgeted reads in cross-task mode. - Verdict emission: Writes a single SUPERVISION_REPORT.md ending in a HEALTHY, WATCH, or INTERVENE verdict that the verify_all passive guard can later observe. - Use Case: After a long autonomous pipeline run, invoke the supervisor on the archived task to check whether the AI looped on the same stage or skipped required human checkpoints before you trust the delivery. ## Quick Start Run /harness-supervise on my last 5 archived tasks and tell me which ones need intervention.

Frequently Asked Questions about harness-supervise

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I audit an AI pipeline task for anti-patterns?▼

Invoke the supervisor with a task slug to audit a single task folder, or use --recent N to audit the last N archived tasks. It reads PM_LOG.md and stage documents, then writes a SUPERVISION_REPORT.md with severity-rated findings and a final verdict.

What anti-patterns does pipeline supervision detect?▼

It detects five patterns: same-stage rollback ladders, cross-stage rollback tallies, stage-doc thinness, missing intervention checks, and missing archive calls. Each has fixed thresholds mapping to INFO, WARN, or ALERT severity.

Can the supervisor modify task documents or dispatch agents?▼

No. The skill is restricted to Read, Write, Glob, and Grep tools, so it physically cannot edit upstream docs, run scripts, or prompt the user. Its only write is the single destination report file.

What do the HEALTHY, WATCH, and INTERVENE verdicts mean?▼

HEALTHY means no WARN or ALERT findings, WATCH means at least one WARN but no ALERTs, and INTERVENE means at least one ALERT. INFO findings alone never raise the verdict above HEALTHY.

Why is my supervision report missing or blocked?▼

A report is not written when the task folder exists in neither the active nor archived directory, producing a BLOCKED message. An empty task folder still yields a HEALTHY report with an INFO note that the pipeline has not started.

Does the supervisor run automatically during the pipeline?▼

No. It is manually invoked only and is not part of the canonical 7-stage routing. Auto-dispatch is reserved for a later version once false-positive rates are validated against real tasks.