spec-harness-learn

Convert AI correction feedback into dated enforced rules for AGENTS.md ratchet systems.

28|2|Updated Oct 3, 2025
One-click install
npx skills add https://github.com/chohra-med/expo_boilerplate --skill spec-harness-learn
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: spec-harness-learn
Source: https://github.com/chohra-med/expo_boilerplate/tree/main/.claude/skills/spec-harness-learn
Command: npx skills add https://github.com/chohra-med/expo_boilerplate --skill spec-harness-learn

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill eliminates the risk of repeating the same AI coding errors after corrections or verifier failures by capturing lessons as permanent, dated rules that are automatically enforced in all future development sessions.

Core Features & Use Cases

  • 6-Step Learning Loop: Captures feedback, distills it to a single imperative rule, classifies it to the correct location in the project's rule set, injects it as a dated rule, optionally generates a human-readable lesson, and verifies the rule is loaded at startup.
  • Ratchet Enforcement: Ensures the project's AGENTS.md rule set only ever tightens (rules are appended or sharpened, never removed) to maintain consistent coding patterns over time.
  • Use Case: If you correct an AI for generating incorrect Redux Toolkit slice structure, this Skill will add a dated rule to AGENTS.md that enforces the correct structure for all future code generation, eliminating the need to re-explain the pattern every session.

Quick Start

Use the spec-harness-learn skill to capture the correction you just gave for the incorrect API endpoint implementation as a permanent enforced rule.

Frequently Asked Questions about spec-harness-learn

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

FAQPage Schema
How do I stop AI coding assistants from repeating the same coding errors across sessions?

To stop AI coding assistants from repeating errors, you must capture correction feedback as permanent, dated rules in an AGENTS.md ratchet system. This ensures the AI loads and enforces these tightening rules at startup for all future development sessions.

What is a ratchet system for AI development rule enforcement?

A ratchet system for AI development is an append-only rule set where corrections are codified as dated rules that only ever tighten. It ensures coding patterns remain consistent over time by preventing previously enforced rules from being removed or relaxed.

How do I convert verifier failure root causes into enforced coding rules?

You convert verifier failure root causes into enforced coding rules by running a learning loop that distills the failure into a single imperative rule, classifies it, and injects it as a dated rule into your AGENTS.md startup load path.

Does spec-harness-learn work with verifier-driven development cycles?

Yes, spec-harness-learn works directly with verifier-driven development cycles by capturing verifier failure root causes and converting them into permanent, dated rules that are automatically loaded and enforced in future AI-assisted development sessions.

How do I maintain an append-only tightening rule set for AI-assisted development?

You maintain an append-only tightening rule set by capturing AI correction feedback and injecting it as a dated rule into your AGENTS.md file. This ratchet approach ensures rules are appended or sharpened, never removed, eliminating recurring errors.

Can I automate capturing AI correction feedback as permanent project rules?

Yes, you can automate capturing AI correction feedback through a 6-step learning loop that distills the feedback into a single imperative rule, classifies it to the correct location, injects it as a dated rule, and verifies it loads at startup.