Spec-Lint Checklist for specs/CONTRACT.md Patches

Community

A comprehensive lint guide for contract patches.

Authorspeelbreaker
Version1.0.0
Installs0

System Documentation

What problem does it solve?

This Skill provides a comprehensive, battle-tested checklist to validate patches to specs/CONTRACT.md, ensuring consistency, safety, and test coverage across governance documents.

Core Features & Use Cases

  • Enforces single source of truth for rules and cross‑references to prevent duplication and drift.
  • Detects duplicate enumerations and promotes centralized definitions.
  • Requires acceptance tests for every normative requirement (MUST / SHALL / REQUIRED) and provides guidance on AT blocks.
  • Enforces patch hygiene by labeling and accounting for section references, cross-references, and patch minimality.
  • Tracks cross‑reference validity and drift to maintain contract integrity.
  • Guides handling of threshold changes and boundary testing in contracts.

Quick Start

Review a patch to specs/CONTRACT.md using the checklist:

  • Scan for pasted normative language (MUST, SHALL, REQUIRED) and ensure an AT‑### block exists.
  • Verify there is a single canonical source for each rule and that cross‑references are valid.
  • Check for new or renamed terms and confirm they are defined and test-bound.
  • Confirm patch changes are minimal and well-scoped to reduce churn.

Dependency Matrix

Required Modules

None required

Components

Standard package

💻 Claude Code Installation

Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.

Please help me install this Skill:
Name: Spec-Lint Checklist for specs/CONTRACT.md Patches
Download link: https://github.com/speelbreaker/ralph-trader/archive/main.zip#spec-lint-checklist-for-specs-contract-md-patches

Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
View Source Repository

Agent Skills Search Helper

Install a tiny helper to your Agent, search and equip skill from 223,000+ vetted skills library on demand.