Sandbox
@ilindaniel/ponytail-lite

One AGENTS.md file for agent instructions

Ponytail Lite is a stripped-down instruction file for coding agents. It keeps the anti-overengineering rules in one `AGENTS.md` instead of a plugin system, hooks, commands, or MCP setup.

171 stars13 forksUpdated 1mo ago
Who it's for

Builders who want their coding agent to check for existing code, standard library support, and native features before adding anything new.

What it delivers

You can keep agent work focused on the smallest useful change instead of letting it drift into extra machinery.

What it does

Single-file setup

You copy one `AGENTS.md` file into the instruction location your agent already uses.

Anti-overengineering ladder

The file tells the agent to check whether something already exists, whether the standard library covers it, and whether a one-line fix is enough.

Agent-specific install paths

The README maps the same instructions to paths for Claude Code, Codex, Cursor, Gemini CLI, Copilot, Windsurf, and others.

No plugin baggage

It deliberately avoids hooks, slash commands, MCP servers, and mode switching.

How to get it

  1. 1Ponytail Lite is what a lazy senior dev would have expected
    AGENTS.md

README

Ponytail LitePonytail Lite

Ponytail Lite

One file. No plugin. He would have wanted it this way.


"Ponytail Lite" is Ponytail without the plugin madness.

Not to be confused with Ponytail's lite mode. This is a separate one-file version.

Just copy AGENTS.md into the place your agent reads instructions. That's it. No plugin, hooks, commands, MCP, or mode switching.

The Joke

Ponytail is a beautiful contradiction: an anti-overengineering tool delivered as a whole plugin ecosystem, with lifecycle hooks, slash commands, MCP, statuslines, adapter tests, and enough install paths to make a senior engineer stare silently at the wall.

Ponytail Lite is what a lazy senior dev would have expected:

AGENTS.md

Why This Exists

Could you just copy AGENTS.md from Ponytail? Yes... But:

The AGENTS.md here is not a byte-for-byte copy. It is an opinionated cleanup of the original: same lazy senior dev idea, less plugin baggage, and guardrails rewritten for people who just want the file.

Install

Copy AGENTS.md, or copy the same text into whatever your agent calls "project instructions" or "rules".

AgentPut the Ponytail Lite text here
AiderYour project instructions / conventions file
Antigravity CLIAGENTS.md or .agents/rules/ponytail.md
Claude CodeCLAUDE.md or project instructions
Cline.clinerules/ponytail.md
CodeWhaleAGENTS.md
CodexAGENTS.md or Settings > Personalization > Custom instructions
Cursor.cursor/rules/ponytail.mdc
Devin CLICustom instructions / project instructions
Gemini CLIAGENTS.md
GitHub Copilot.github/copilot-instructions.md
GitHub Copilot CLIAGENTS.md, .github/copilot-instructions.md, or ~/.copilot/copilot-instructions.md
Hermes AgentCustom instructions / system prompt
Kiro.kiro/steering/ponytail.md
OpenClawCustom skill / instruction file
OpenCodeAGENTS.md or OpenCode instructions
Pi agentCustom instructions / system prompt
SwivalAGENTS.md or ~/.config/swival/AGENTS.md
Windsurf.windsurf/rules/ponytail.md
ZedCustom instructions / rules

Uninstall

Delete the file you copied.

If you pasted the text into a global instructions file, delete that paragraph.

No leftover mode flag, statusline entry, and hidden MCP server still thinking about your dependency graph.

What It Does

Before writing code, the agent climbs this ladder:

  1. Does this need to exist?
  2. Does it already exist in the codebase?
  3. Does the standard library do it?
  4. Does a native platform feature cover it?
  5. Does an installed dependency solve it?
  6. Can this be one line?
  7. Only then, write the minimum code that works.

License

MIT

Files in the repo

Repository payload6 top-level entries
  • assets
  • .gitattributes
  • .gitignore
  • AGENTS.md
  • LICENSE
  • README.md

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More rules & prompts

All parts of Claude Code's system prompt, 27 builtin tool descriptions, sub agent prompts (Plan/Explore/Task), utility prompts (CLAUDE.md, compact, statusline, magic docs, WebFetch, Bash cmd, security review, agent creation). Updated for each Claude Code version.

13k
wanshuiyin/
HERO-Anti-OverDefense

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.

444
repowise-dev/
claude-code-prompts

Independently authored prompt templates for AI coding agents — system prompts, tool prompts, agent delegation, memory management, and multi-agent coordination. Informed by studying Claude Code.

1.2k
wshobson/
commands
wshobson/commandsRules & Prompts

A collection of production-ready slash commands for Claude Code

2.6k