diff --git a/.github/PULL_REQUEST_TEMPLATE.md b/.github/PULL_REQUEST_TEMPLATE.md new file mode 100644 index 00000000..a45ab2cc --- /dev/null +++ b/.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) + +- diff --git a/README.md b/README.md index 02037ed0..3778c6ee 100644 --- a/README.md +++ b/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 diff --git a/docs/dogfooding-first-policy.md b/docs/dogfooding-first-policy.md new file mode 100644 index 00000000..923fcd11 --- /dev/null +++ b/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('')` 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.