Spec-Lint Checklist for IMPLEMENTATION_PLAN.md (Fail-Closed)

Validate implementation plans against safety contracts with fail-closed linting.

1|Updated Jan 10, 2026
One-click install
npx skills add https://github.com/speelbreaker/ralph-trader --skill spec-lint-checklist-for-implementation-plan-md-fail-closed
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Spec-Lint Checklist for IMPLEMENTATION_PLAN.md (Fail-Closed)
Source: https://github.com/speelbreaker/ralph-trader/tree/main/SKILLS/implementation_plan_checklist
Command: npx skills add https://github.com/speelbreaker/ralph-trader --skill spec-lint-checklist-for-implementation-plan-md-fail-closed

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a rigorous, machine-checkable blueprint to validate implementation plans against safety contracts, preventing conflicting guidance and unsafe gate behavior.

Core Features & Use Cases

  • Split-brain detection: identify conflicting thresholds and schedules within a plan.
  • Gate canonicalization: enforce precise inputs, comparators, durations, and exit criteria for every safety gate.
  • Precedence enforcement: require a single PolicyGuard ladder and a clear chokepoint with no bypass.
  • Test mapping & artifacts: ensure every rule has a test and all required artifacts are explicitly defined.

Quick Start

Run the spec-lint suite on the target implementation plan to surface any policy violations, then iteratively fix issues until the lint passes.

Frequently Asked Questions about Spec-Lint Checklist for IMPLEMENTATION_PLAN.md (Fail-Closed)

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

FAQPage Schema
How do I validate an implementation plan against safety contracts in a PR review?

To validate an implementation plan against safety contracts during PR review, you run an automated spec-lint suite that checks for explicit gate definitions, test mappings, and verifiable artifact paths. This ensures plan governance and prevents unsafe merges.

What is split-brain detection in implementation plan governance?

Split-brain detection in implementation plan governance identifies conflicting thresholds and schedules within a safety plan. It prevents contradictory guidance by enforcing a single PolicyGuard ladder with a clear, non-bypassable chokepoint.

How do I enforce canonical safety gates for an implementation plan?

You enforce canonical safety gates by applying lint rules that require precise inputs, comparators, durations, and exit criteria for every gate. This canonicalization ensures all safety checks are explicit and testable.

Can I use automated linting to verify test mapping and artifact freshness in implementation plans?

Yes, you can use automated linting to verify test mapping and artifact freshness in implementation plans. The lint suite ensures every rule has a corresponding test and all required artifacts have explicitly defined freshness paths.

What happens if my implementation plan lacks explicit precedence and chokepoint definitions?

If an implementation plan lacks explicit precedence and chokepoint definitions, the fail-closed spec-lint suite will surface policy violations and block the plan. It requires a single PolicyGuard ladder to prevent bypass behavior.