Skip to content

docs(agents): require maintainer approval for architectural changes#31

Merged
n2p5 merged 1 commit intomainfrom
docs/agents-architecture-rule
May 3, 2026
Merged

docs(agents): require maintainer approval for architectural changes#31
n2p5 merged 1 commit intomainfrom
docs/agents-architecture-rule

Conversation

@n2p5
Copy link
Copy Markdown
Contributor

@n2p5 n2p5 commented May 3, 2026

Adds three principles to AGENTS.md after the tripwire cache-strategy churn made the rules implicit:

  1. Architectural changes (caching, Suspense, error boundaries, runtime exports, vercel.json, next.config.ts) require maintainer approval. Auto mode does not include architectural decisions.
  2. Platform behavior claims need primary sources (official docs, package source, changelogs, or a reproducible experiment). No pattern-matching on symptoms.
  3. Simplification means removing surface area, not swapping abstractions.

Adds three new principles to AGENTS.md after the tripwire cache-strategy
churn made the rules implicit:

- Architectural changes (caching, Suspense patterns, error boundaries,
  runtime exports, vercel.json, next.config.ts) require maintainer
  approval before implementation. Auto mode does not include
  architectural decisions.
- Claims about platform behavior (Next, Bun, Vercel, Neon, @vercel/blob)
  must be backed by primary sources — official docs, package source,
  changelogs, or a reproducible local experiment. No pattern-matching
  on symptoms without evidence.
- Simplification means removing surface area to its essence, not
  swapping one set of abstractions for another.
@vercel
Copy link
Copy Markdown

vercel Bot commented May 3, 2026

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

Project Deployment Actions Updated (UTC)
func-lol Ready Ready Preview, Comment May 3, 2026 11:55am

Request Review

@n2p5 n2p5 merged commit 4e80707 into main May 3, 2026
6 checks passed
@n2p5 n2p5 deleted the docs/agents-architecture-rule branch May 3, 2026 18:53
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