Home / Skills / HERO-Anti-OverDefense

wanshuiyin/HERO-Anti-OverDefense

wanshuiyin / HERO-Anti-OverDefense

AGENTS.md & Design.mdMarkdownMIT

HERO = Hashing · Edge cases · Rubrics · Overbuild - the four shapes coding agents over-defend in. A paste-in contract that stops them. Works with Claude Code, Codex, Antigravity, Cursor, Copilot, Windsurf, Gemini CLI.

470stars
10forks
0open issues
2026-09-28last pushed
MITlicense

What it is, and how people use it

HERO = Hashing · Edge cases · Rubrics · Overbuild - the four shapes coding agents over-defend in. A paste-in contract that stops them. Works with Claude Code, Codex, Antigravity, Cursor, Copilot, Windsurf, Gemini CLI. It sits on the AGENTS.md & Design.md shelf of the catalog, maintained by @wanshuiyin.

✓Drop-in for Claude Code, Codex CLI and Cursor - install and it just runs.
✓Read the SKILL.md / README first; most setups are one command from the docs.
✓Teams use it to standardise how agents behave across every repo in the org.
agents-mdai-agentsantigravityclaude-codeclaude-md

Why builders keep it installedAGENTS.md & Design.md benefits

A map, not a manual

AGENTS.md tells any coding agent how to build, test and ship inside your repo in one screen. Onboarding time for agents drops from a dozen correction turns to none.

Fewer destructive mistakes

Declare which commands are safe, which files are off-limits and how migrations run. The agent respects the guardrails instead of discovering them by breaking things.

Model-agnostic by design

One file serves Copilot, Claude Code, Codex and Cursor. It is becoming the industry's shared README-for-robots, checked into the repo where it stays fresh.

It grows with the project

The convention is to update the file in the same PR that changes the build. Your agent context never goes stale because the team owns it like any other doc.

Contributorsloading from GitHub…

Languagesestimated from snapshot

  • Markdown 68.0%
  • TypeScript 20.0%
  • Shell 12.0%

Community pulsesnapshot ratios, normalized

starsforksissues ×3watchers