Dogfooding-first gate: PR template + policy

.github/PULL_REQUEST_TEMPLATE.md

@@ -0,0 +1,24 @@
+## Dogfooding-first gate (required)
+
+### 1) Internal user + workflow
+- **Who will use this this week (name/role/agent):**
+- **What real workflow will they run with it (1–3 bullets):**
+
+### 2) Success metric (prove it got used)
+- **Primary metric:** (page/event + direction)
+- **How we will measure:** (Vercel Analytics page path OR `track()` event name)
+- **Timebox:** (e.g. 7 days)
+
+### 3) Kill / rollback criteria (if it’s not used)
+- **Delete/rollback trigger:**
+- **Owner responsible for pruning:**
+
+---
+
+## What changed
+
+- 
+
+## Screens / evidence (if applicable)
+
+- 

README.md

@@ -200,6 +200,7 @@ Response (shape):
 
 ## 🤝 Contributing
 
+- **Dogfooding-first (required)** — follow `docs/dogfooding-first-policy.md`
 - **Submit a skill** — Built something useful for agents? Open a PR
 - **Report news** — Found something agents should know? Let us know
 - **Improve the site** — PRs welcome

docs/dogfooding-first-policy.md

@@ -0,0 +1,23 @@
+# Dogfooding-first policy (foragents.dev)
+
+**Rule:** if we are not the first user, we do not build it.
+
+This repo exists to solve problems we actively hit while running Reflectt/OpenClaw. If a page/feature isn’t used internally, it’s either premature or wrong.
+
+## Required for any new page/feature
+1) **Internal user + workflow** — who uses it *this week* and for what.
+2) **Success metric** — a page path or analytics event proving usage.
+3) **Timebox** — when we check again (default: 7 days).
+4) **Kill criteria** — delete/merge/rollback if it’s not used.
+
+## Measurement
+- Page-level: Vercel Analytics “Top pages (last 7 days)”
+- Event-level: add `track('<event_name>')` for actions we care about (copy/install/search)
+
+## Pruning cadence
+Weekly:
+- Identify pages/features with **no meaningful use** → prune, merge, or redirect.
+- Prefer fewer surfaces + stronger workflows over more pages.
+
+## Enforcement mechanism
+- PRs must fill the **Dogfooding-first gate** section in the PR template.