Add: Server-Is-The-Build Policy

[taras]

Motivation

Captures an architectural principle articulated by Charles Lowell during PR review:

"If there is a principle here to extract, it is that what makes staticalize work is that there is no build, only capture. The server is the build."

This principle guides decisions about build-time vs runtime asset generation, favoring on-demand server generation with capture (staticalize) over separate build pipelines.

Approach

• Created .policies/server-is-the-build.md as a Recommended policy
• Documents the core principle, rules, compliant/non-compliant examples
• Uses the OG image generation work (feat(www): add OG image generation for blog posts effection#1120) as the motivating example
• Added entry to .policies/index.md

Summary by CodeRabbit

• Documentation
  • Added a new policy entry "Server-Is-The-Build" to the policies list.
  • Included a full policy document detailing principles and rules, asset-generation guidance, static-site and feature patterns, a verification checklist, common pitfalls, and compliant vs. non-compliant implementation examples.

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

---

📝 Walkthrough

Walkthrough

Adds a new policy "Server-Is-The-Build": updates the policies index to include the entry and adds a new policy document describing the server-as-build principle, rules for asset generation and static builds, verification checklist, examples, and common mistakes.

Changes

Cohort / File(s)	Summary
Policy Documentation .policies/index.md, .policies/server-is-the-build.md	Inserted a new "Server-Is-The-Build" entry into the Established Policies table and policy documents list in the index; added a comprehensive server-is-the-build.md policy covering principles, rules, verification checklist, compliant/non-compliant examples, and related guidance.

Estimated code review effort

🎯 3 (Moderate) | ⏱️ ~20 minutes

🚥 Pre-merge checks | ✅ 4

✅ Passed checks (4 passed)

Check name	Status	Explanation
Title check	✅ Passed	The title 'Add: Server-Is-The-Build Policy' clearly and specifically summarizes the main change: introducing a new policy document.
Description check	✅ Passed	The description includes both required sections (Motivation and Approach) with substantial, relevant content that explains the principle and implementation details.
Docstring Coverage	✅ Passed	No functions found in the changed files to evaluate docstring coverage. Skipping docstring coverage check.
Policy Compliance	✅ Passed	PR adds new Server-Is-The-Build policy document and updates policies index with markdown-only changes, no source code modifications.

_{✏️ Tip: You can configure your own custom pre-merge checks in the settings.}

✨ Finishing Touches

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch policy/server-is-the-build

---

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

[coderabbitai]

Actionable comments posted: 1

🤖 Prompt for all review comments with AI agents

Verify each finding against the current code and only fix it if needed.

Inline comments:
In @.policies/server-is-the-build.md:
- Around line 45-54: The TypeScript example's signature is incorrect:
blogRoutes() is declared to return Route[] but actually returns a single Route
object; either adjust the function to return an array (wrap the returned object
in [...]) or change the return type to Route; update the signature to match the
implementation (modify blogRoutes() return type or return value) and ensure the
symbol names Route and blogRoutes are consistent across the file.