[PR #640] [MERGED] docs: codify generated entry refactor guidance #736

New issue

Closed

opened 2026-05-06 13:09:52 +02:00 by BreizhHardware · 0 comments

BreizhHardware commented

2026-05-06 13:09:52 +02:00

Owner

📋 Pull Request Information

Original PR: https://github.com/cloudflare/vinext/pull/640
Author: @southpolesteve
Created: 3/22/2026
Status: ✅ Merged
Merged: 3/22/2026
Merged by: @southpolesteve

Base: main ← Head: codex/agents-generated-entry-guidance

📝 Commits (1)

fd576d0 docs: codify generated entry refactor guidance

📊 Changes

1 file changed (+47 additions, -0 deletions)

View changed files

📝 AGENTS.md (+47 -0)

📄 Description

Summary

Add repo guidance for the refactor pattern we've been using to make generated entry code more maintainable:

prefer vp for local check/test/build loops
keep packages/vinext/src/entries/* as thin codegen glue
move request lifecycle logic into typed helpers under packages/vinext/src/server/*
prefer helper unit tests plus delegation assertions over giant generated-string assertions
document the small stacked-PR + /bigbonk review loop for high-risk refactors

Why

We've been steadily extracting App Router runtime logic out of large generated template strings. This codifies the broad strokes of that pattern in AGENTS.md so future agents keep moving in the same direction instead of reintroducing large inline runtime subsystems.

Testing

vp check AGENTS.md

_{🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.}

## 📋 Pull Request Information **Original PR:** https://github.com/cloudflare/vinext/pull/640 **Author:** [@southpolesteve](https://github.com/southpolesteve) **Created:** 3/22/2026 **Status:** ✅ Merged **Merged:** 3/22/2026 **Merged by:** [@southpolesteve](https://github.com/southpolesteve) **Base:** `main` ← **Head:** `codex/agents-generated-entry-guidance` --- ### 📝 Commits (1) - [`fd576d0`](https://github.com/cloudflare/vinext/commit/fd576d044ef7b214285d3ab02a4c0e45e74aaa67) docs: codify generated entry refactor guidance ### 📊 Changes **1 file changed** (+47 additions, -0 deletions) <details> <summary>View changed files</summary> 📝 `AGENTS.md` (+47 -0) </details> ### 📄 Description ## Summary Add repo guidance for the refactor pattern we've been using to make generated entry code more maintainable: - prefer `vp` for local check/test/build loops - keep `packages/vinext/src/entries/*` as thin codegen glue - move request lifecycle logic into typed helpers under `packages/vinext/src/server/*` - prefer helper unit tests plus delegation assertions over giant generated-string assertions - document the small stacked-PR + `/bigbonk` review loop for high-risk refactors ## Why We've been steadily extracting App Router runtime logic out of large generated template strings. This codifies the broad strokes of that pattern in `AGENTS.md` so future agents keep moving in the same direction instead of reintroducing large inline runtime subsystems. ## Testing - `vp check AGENTS.md` --- <sub>🔄 This issue represents a GitHub Pull Request. It cannot be merged through Gitea due to API limitations.</sub>