Skip to content

docs(agents): judge the product as a whole; shape instead of append - #732

Merged
eizedev merged 1 commit into
mainfrom
docs/agents-product-principles
Nov 22, 2026
Merged

eizedev merged 1 commit into
mainfrom
docs/agents-product-principles

Conversation

@eizedev

@eizedev eizedev commented Nov 22, 2026

Copy link
Copy Markdown
Owner

AGENTS.md starts with the principles every change follows, and two rules that pushed every change into many places are rewritten.

  • New section "How we build": look at the whole, shape what exists, one place per fact, small units, common practice, say what does not fit.
  • Docs: a change is described on the one page that owns its topic; overview pages are checked, corrected and linked, never filled with copies.
  • Reviews judge the product after the change; the rule applies to every AI-written change, not only mine.
  • The package table lives in the README and the docs-site commands in CONTRIBUTING; AGENTS.md links to them (197 lines).

Checked: root tests 114/114, vale on the new lines.

🤖 Generated with Claude Code

- New section "How we build": look at the whole, shape what exists,
  one place per fact, small units, common practice, say what does not
  fit.
- Docs rule: a change is described on the one page that owns its
  topic; overview pages are checked, corrected and linked, not filled
  with copies.
- Reviews judge the product after the change. The review rule no
  longer singles out the maintainer's own agents.
- The package table and the docs-site commands live in one place
  each (README, CONTRIBUTING); AGENTS.md links to them.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@eizedev
eizedev merged commit 1365f35 into main Nov 22, 2026
23 checks passed
@eizedev
eizedev deleted the docs/agents-product-principles branch November 22, 2026 16:39
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.

1 participant