Skip to content

docs: add Ponytail personality to project instructions#3271

Closed
ousamabenyounes wants to merge 1 commit into
Hmbown:mainfrom
ousamabenyounes:docs/ponytail-personality
Closed

docs: add Ponytail personality to project instructions#3271
ousamabenyounes wants to merge 1 commit into
Hmbown:mainfrom
ousamabenyounes:docs/ponytail-personality

Conversation

@ousamabenyounes

@ousamabenyounes ousamabenyounes commented Jun 16, 2026

Copy link
Copy Markdown
Contributor

Blocked by DietrichGebert/ponytail#124 — Ponytail must officially list CodeWhale as a supported agent before CodeWhale recommends Ponytail to its users.


Adds a reference to Ponytail in the Project instructions section of CONFIGURATION.md.

What

Ponytail is a personality overlay (a pre-built AGENTS.md) that makes any AI agent lazy-efficient:

  • 80–94% less code
  • 47–77% cheaper
  • 3–6× faster

Why here

CodeWhale already reads AGENTS.md natively. Ponytail users can already copy the file and it works. This PR just surfaces that option in the docs so CodeWhale users know it exists.

What changes

One paragraph in docs/CONFIGURATION.md, under the AGENTS.md bullet. No code changes.

Prior art

  • 14 agent adapters supported (Claude Code, Codex, Gemini, OpenCode, Cursor, Windsurf, Cline, Copilot, Kiro, Zed, Antigravity, OpenClaw, Pi, CodeWhale)
  • 38k+ GitHub stars
  • MIT licensed

🤖 Generated with Claude Code

Adds a reference to Ponytail's AGENTS.md as a pre-built personality
template that CodeWhale users can copy as their project instructions.
Ponytail enforces lazy, minimal-code discipline (YAGNI, stdlib first,
native features, one-liners) and cuts 80-94% of generated code in
benchmarks with zero install — it works because CodeWhale already
reads AGENTS.md natively.
@ousamabenyounes ousamabenyounes requested a review from Hmbown as a code owner June 16, 2026 17:13

@greptile-apps greptile-apps Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Your free trial has ended. If you'd like to continue receiving code reviews, you can add a payment method here.

@gemini-code-assist gemini-code-assist Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request updates the configuration documentation to suggest using Ponytail's AGENTS.md for a pre-built agent personality. The review feedback recommends polishing the added text to improve professionalism and grammar, providing a clear code suggestion for the rewrite.

Important

The consumer version of Gemini Code Assist on GitHub is being sunset. Starting June 18, 2026, new organization installations will be blocked, and all code review activity will officially cease on July 17, 2026.
For more details on the timeline and next steps, please review the Help Documentation.

Comment thread docs/CONFIGURATION.md
Comment on lines +17 to +21
For a pre-built personality that enforces lazy, minimal-code discipline,
copy [Ponytail's `AGENTS.md`](https://github.com/DietrichGebert/ponytail/blob/main/AGENTS.md)
as your project instructions. It cuts 80–94% of generated code in benchmarks
by forcing the agent to try stdlib, native features, and one-liners before
writing anything. No install, no plugin — just the instruction file.

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The phrasing can be polished to sound more professional and grammatically complete. Specifically:

  • Use "a lazy, minimal-code discipline" instead of "lazy, minimal-code discipline".
  • Use "the standard library" instead of "stdlib" for better clarity and formality.
  • Use "No installation or plugins are required" instead of "No install, no plugin" to avoid colloquialisms ("install" as a noun).
Suggested change
For a pre-built personality that enforces lazy, minimal-code discipline,
copy [Ponytail's `AGENTS.md`](https://github.com/DietrichGebert/ponytail/blob/main/AGENTS.md)
as your project instructions. It cuts 80–94% of generated code in benchmarks
by forcing the agent to try stdlib, native features, and one-liners before
writing anything. No install, no plugin — just the instruction file.
For a pre-built personality that enforces a lazy, minimal-code discipline,
copy [Ponytail's AGENTS.md](https://github.com/DietrichGebert/ponytail/blob/main/AGENTS.md)
as your project instructions. It cuts 80–94% of generated code in benchmarks
by forcing the agent to try the standard library, native features, and one-liners before
writing anything. No installation or plugins are required — just the instruction file.

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@ousamabenyounes

Copy link
Copy Markdown
Contributor Author

Depends on DietrichGebert/ponytail#108 — the PR that officially adds CodeWhale to Ponytail's supported agent list (README badge bump, install section, agent-portability table). CodeWhale already reads AGENTS.md and works today, but the official endorsement should land first.

@artaidart39-max

artaidart39-max commented Jun 16, 2026 via email

Copy link
Copy Markdown

@artaidart39-max

artaidart39-max commented Jun 16, 2026 via email

Copy link
Copy Markdown

@Hmbown

Hmbown commented Jun 17, 2026

Copy link
Copy Markdown
Owner

Thanks for this, Ben — and appreciate the nod to Ponytail. Closing this one for now, but want to explain why and point at what we'd genuinely welcome instead.

Why we're not merging a third-party-personality recommendation here:

  • Our own AGENTS.md / constitution.md are the base prompt and repo authority surface, and we've intentionally kept those as our first-party guidance rather than pointing users at an external overlay. Recommending a specific third-party AGENTS.md in the core config docs is a positioning step we'd rather not take from a single doc PR.
  • The PR is also currently self-described as blocked on docs: add CodeWhale to supported agents (native AGENTS.md reader, zero setup) DietrichGebert/ponytail#124 — Ponytail officially listing CodeWhale as a supported agent. It's backwards for us to recommend a personality overlay that doesn't yet claim to support us.
  • The "80–94% less code" figures are Ponytail's benchmark claims; putting them in our docs would make us vouch for a number we haven't reproduced.

What we'd genuinely welcome instead: the effect you're after — a "lazy/minimal-code" discipline that actually reduces code volume — is exactly the kind of thing that belongs in the base prompt and constitution, not a doc pointer. We'd love a PR that proposes concrete adjustments to AGENTS.md / constitution.md (or a documented opt-in profile) aimed at the same outcome, so that we can benchmark it ourselves against our own suite and see whether it holds up without regressing thoroughness. A first-party, measurable version of this idea is something we'd take seriously.

If Ponytail ships a CodeWhale adapter and you want to revisit a first-class integration later, that's a separate conversation — file an issue and we'll talk. Thanks again for kicking it off.

@Hmbown Hmbown closed this Jun 17, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants