deviation-handling

Detect and resolve project plan deviations using a four-rule system.

39|2|Updated Jan 31, 2026
One-click install
npx skills add https://github.com/hffmnnj/opencode-goopspec --skill deviation-handling
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: deviation-handling
Source: https://github.com/hffmnnj/opencode-goopspec/tree/main/skills/deviation-handling
Command: npx skills add https://github.com/hffmnnj/opencode-goopspec --skill deviation-handling

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Deviation handling automatically detects and resolves deviations from a project plan by applying a four-rule system to drive safe, deterministic fixes and prevent drift.

Core Features & Use Cases

  • Auto-detect deviations: identify when outcomes diverge from the agreed spec.
  • 4-rule automated responses: apply Rule 1 (Bug Fixes), Rule 2 (Missing Critical Functionality), Rule 3 (Blocking Issues), or Rule 4 (Architectural Decisions STOP) to steer execution.
  • Audit & traceability: log every deviation, generate atomic commits, and maintain a clear execution trail.
  • Use Case: When an implementation misses input validation, Rule 2 auto-adds the fix and logs the decision for governance.

Quick Start

Use the deviation-handling skill to automatically manage deviations in a GoopSpec project.

Frequently Asked Questions about deviation-handling

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

FAQPage Schema
How do I automatically detect and fix deviations from my project specification?▼

Deviation handling automatically identifies when implementation outcomes diverge from your agreed specification and applies a four-rule system to resolve them: Bug Fixes, Missing Critical Functionality, Blocking Issues, or escalates Architectural Decisions to you for confirmation.

What is the four-rule system for handling deviations?▼

The system categorizes deviations into four rules: Rule 1 (Bug Fixes) auto-resolves bugs, Rule 2 (Missing Critical Functionality) adds missing features, Rule 3 (Blocking Issues) unblocks execution, and Rule 4 (Architectural Decisions) stops and escalates to you for manual confirmation.

How does deviation handling maintain audit and traceability during execution?▼

Every detected deviation is logged, changes are committed atomically, and a clear execution trail is maintained, ensuring governance compliance and transparency across your project plan enforcement.

Can deviation handling work with GoopSpec projects?▼

Yes, deviation handling is designed to automatically manage deviations in GoopSpec projects by enforcing specification integrity and applying deterministic fix rules throughout execution.

When should I use deviation handling instead of manual code review?▼

Deviation handling is best for continuous, deterministic enforcement of spec compliance—it catches drift early, auto-fixes low-risk issues like missing validation, and logs decisions for audit trails without blocking on manual review for every change.