Skip to content

docs(agents): try a week of agents owning the codebase - #953

Merged
badcuban merged 1 commit into
mainfrom
docs/agents-md-ownership-trial
Nov 16, 2026
Merged

badcuban merged 1 commit into
mainfrom
docs/agents-md-ownership-trial

Conversation

@badcuban

Copy link
Copy Markdown
Collaborator

Agents tend to add to existing code instead of consolidating it. Anthropic's Fable 5.2 prompting guide found that one sentence telling the model it owns and maintains the codebase made it consolidate duplicated code in about 75% of runs instead of under 10%. This adds that sentence to AGENTS.md for a one-week trial.

  • The ownership line, at the top of "A note from Will": "You are the owner and long-term maintainer of this codebase, and its design is up to you."
  • "List every change you made in your report, small ones included." Anthropic also saw agents with the ownership line make changes nobody asked for and then leave small ones out of their summaries; this keeps them visible.
  • The provider glossary entry points to the Providers list under "Hit every surface" instead of repeating it.

What to watch over the week: larger diffs, unrequested changes, and output tokens (Anthropic measured roughly 70 to 80% more with the line). If those outweigh the consolidation, revert the first two lines.

…rovider glossary points at the Providers list
@vercel

vercel Bot commented Nov 16, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated
threadlines Ready Ready Preview Nov 16, 2026 10:04am UTC

Request Review

@badcuban
badcuban added this pull request to the merge queue Nov 16, 2026
Merged via the queue into main with commit a3e7f05 Nov 16, 2026
21 checks passed
@badcuban
badcuban deleted the docs/agents-md-ownership-trial branch November 16, 2026 10:15

This branch was successfully deployed

1 active deployment
Preview — a8bf794d Deployed Nov 16, 2026 by vercel[bot]
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant