decision-gates

Enforces checkpoint evidence anchors and zero-token validation gates for long-running agent tasks.

3|Updated Feb 13, 2026
One-click install
npx skills add https://github.com/ooooooooooooooooooop/personal-ai --skill decision-gates-ooooooooooooooooooop
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: decision-gates
Source: https://github.com/ooooooooooooooooooop/personal-ai/tree/main/skills/decision-gates
Command: npx skills add https://github.com/ooooooooooooooooooop/personal-ai --skill decision-gates-ooooooooooooooooooop

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) components.

What problem does it solve? Long-running, multi-session agent tasks drift: goals live only in conversation, acceptance relies on self-reported summaries, and recovery trusts lossy summaries. This Skill materializes decision state into raw evidence anchors and hard validation gates so objective drift, acceptance distortion, and summary bias are caught mechanically. ## Core Features & Use Cases - Raw Evidence Anchors: Every checkpoint persists commands, exit codes, log tails, file SHA-256 hashes, and worker SKIP/WARN/PENDING registers; recovery always reads anchors before summaries. - Zero-Token Gate Scripts: Python scripts verify cross-worker consistency, cost/tier reconciliation, summary-bias self-checks, scope-lock boundary enforcement, and deadband loop detection without LLM calls. - Event-Driven Adversarial Audit: An independent subagent that never reads summaries audits alignment on trigger events such as objective changes, high-risk boundaries, and final acceptance. - Use Case: A 200-file permission audit split across 4 parallel workers and two sessions uses gate_consistency.py to surface a worker's SKIP, forcing the checkpoint verdict to PARTIAL instead of a false PASS. ## Quick Start Ask the agent to use decision-gates to set up checkpoint evidence anchors and run the validation gates for your long-running multi-worker task.

Frequently Asked Questions about decision-gates

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

FAQPage Schema
How do I prevent an AI agent from drifting off the original goal in long tasks?

Persist the verbatim objective and raw evidence anchors (commands, exit codes, file hashes) at each checkpoint, then run event-driven adversarial audits with an independent subagent that never reads summaries. Recovery always reads anchors before summaries.

How to validate results from multiple parallel AI workers before accepting them?

Run the gate_consistency.py script on the workers' JSON reports before acceptance. It detects overlapping file conflicts, hash mismatches, coverage gaps, and surfaces SKIP/WARN/PENDING markers so unresolved items cannot be folded into a PASS.

Can these validation gates run without consuming LLM tokens?

Yes, gates for consistency, cost reconciliation, self-check, scope lock, and deadband detection are pure Python standard-library scripts with zero token cost. Only the adversarial audit gate uses an LLM, at the cheapest model tier.

What happens when the same error repeats during an agent task?

The gate_deadband.py script fingerprints each failure and trips DEADBAND_TRIPPED after two consecutive identical failure signatures. This forces hypothesis invalidation and rollback to the previous checkpoint instead of blind retrying.

When should I not use checkpoint gates for a task?

Skip the gates for single-turn small edits or ephemeral Q&A that needs no persistence. The Skill defers scale classification to a task-mode router so lightweight tasks avoid process overhead.

How does the scope lock gate enforce file change boundaries?

The gate_scope_lock.py script compares changed files against allowed and forbidden glob patterns. Any file matching a forbidden pattern or falling outside the allowed scope returns SCOPE_VIOLATION with exit code 1, blocking delivery.