spec-lint-implementation-plan

Lint IMPLEMENTATION_PLAN.md files for fail-closed safety gate definitions.

1|Updated Jan 10, 2026
One-click install
npx skills add https://github.com/speelbreaker/ralph-trader --skill spec-lint-implementation-plan
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-lint-implementation-plan
Source: https://github.com/speelbreaker/ralph-trader/tree/main/SKILLS/spec-lint-implementation-plan
Command: npx skills add https://github.com/speelbreaker/ralph-trader --skill spec-lint-implementation-plan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill ensures that implementation plans remain fail-closed by enforcing a rigorous safety lint that prevents weakening of safety gates and contract thresholds.

Core Features & Use Cases

  • Split-brain detection: identifies conflicting gate rules, legacy text, or bypass attempts within a plan.
  • Gate canonicalization & test mapping: enforces precise gate definitions (inputs, comparators, thresholds, durations, and exit criteria) and requires explicit tests for each gate.
  • Precedence & artifact governance: validates the plan's policy guard, single chokepoint, artifact paths, and write order to avoid manual overrides.
  • Use Case: A PR introduces a new gate; the lint ensures exact criteria and test coverage before acceptance.

Quick Start

Run the plan-lint tool against an IMPLEMENTATION_PLAN.md to validate safety gates and tests.

Frequently Asked Questions about spec-lint-implementation-plan

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

FAQPage Schema
How do I lint an implementation plan to prevent safety gate weakening?

You can lint an implementation plan by validating its YAML frontmatter, exact gate definitions, and single precedence ladder to prevent weakening of contract thresholds and detect split-brain conflicts.

What is split-brain conflict detection in implementation plan governance?

Split-brain conflict detection is a safety lint mechanism that identifies conflicting gate rules, legacy text, or bypass attempts within an implementation plan to prevent weakening of contract gates.

How to enforce gate canonicalization and test mapping for safety gates?

Enforce gate canonicalization by requiring precise gate definitions including inputs, comparators, thresholds, durations, and exit criteria, and mapping explicit tests to each gate in the plan.

Does the safety lint require specific frontmatter or structure for IMPLEMENTATION_PLAN.md?

Yes, the safety lint requires YAML frontmatter with name and description, exact gate definitions, a single precedence ladder, and documented rollback, test, and artifact requirements to pass validation.

What happens if my implementation plan lacks documented rollback and artifact paths?

If your plan lacks documented rollback and artifact paths, the fail-closed safety lint will reject it by flagging missing artifact governance, invalid write order, and incomplete safety gate prerequisites.