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.