bitter-lesson-audit

Audit Claude Code harness files for Bitter Lesson overfitting.

Updated Jun 30, 2026
One-click install
npx skills add https://github.com/Festo-Wampamba/Claude-Features --skill bitter-lesson-audit
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bitter-lesson-audit
Source: https://github.com/Festo-Wampamba/Claude-Features/tree/main/skills/bitter-lesson-audit
Command: npx skills add https://github.com/Festo-Wampamba/Claude-Features --skill bitter-lesson-audit

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill reviews a Claude Code harness for rules, hooks, and skills that compensate for today's model weaknesses instead of enduring constraints.

Core Features & Use Cases

  • Identifies capability scaffolding, durable safeguards, and ambiguous cases in Claude Code setup files.
  • Flags redundant verification, brittle triggers, and procedural overengineering that may age badly as models improve.
  • Produces a concrete modernization plan with examples pulled from the actual configuration.

Quick Start

Ask this Skill to audit your Claude Code setup and tell you which rules and hooks are future-proof versus overfitted.

Frequently Asked Questions about bitter-lesson-audit

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

FAQPage Schema
What is Claude Code harness overfitting and why does it matter?

Harness overfitting happens when hooks, CLAUDE.md rules, and skills hard-code workarounds for current model weaknesses instead of enforcing durable safeguards, creating brittle workflow scaffolding that ages poorly as models improve.

How do I audit my Claude Code setup for rules that compensate for model weaknesses?

Audit your Claude Code setup by reviewing hooks and CLAUDE.md rules to distinguish durable safety constraints from capability scaffolding, then generate concrete modernization recommendations with expiry conditions for overfitted workarounds.

Can I review my prompt engineering workflows to find brittle triggers and redundant verification?

Yes, you can review prompt engineering workflows to identify redundant verification steps, brittle triggers, and procedural overengineering in your configuration that may become obsolete as model capabilities advance.

Does this approach work with existing CLAUDE.md rules and workflow scaffolding?

Yes, this approach applies directly to existing CLAUDE.md rules, hooks, skills, agents, and workflow scaffolding, extracting examples from your actual configuration to flag future-proof rules versus overfitted ones.

When should I remove hard-coded workarounds from my Claude Code hooks?

Remove hard-coded workarounds when they compensate for current model weaknesses rather than enforcing durable safety constraints, especially if the audit identifies expiry conditions indicating the scaffolding is no longer necessary.

What's the best way to modernize a Claude Code harness that relies on capability scaffolding?

Modernize a Claude Code harness by running an audit to produce a concrete plan that separates durable safeguards from overfitted rules, applying upgrade recommendations with specific expiry conditions to remove fossilized workarounds.