From 1b8ea6500e4f34af800fdd0ce8da92ab0ce09ac7 Mon Sep 17 00:00:00 2001 From: Ugur Cekmez Date: Mon, 1 Jun 2026 21:16:02 +0300 Subject: [PATCH] docs(governance): reconcile the EEIP process across authoritative files MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit The EEIP lifecycle parameters disagreed across GOVERNANCE.md, EEIP-TEMPLATE.md and EEIP-0001: submission directory (`proposals/`, which does not exist, vs `docs/eeips/` where EEIPs actually live), vote threshold (majority vs EEIP-0001's ≥2/3), and decision-body name (TSC vs "Standards Committee"). Standardize on `docs/eeips/` (GOVERNANCE + EEIP-TEMPLATE), set the Accepted threshold to ≥2/3, and add a note that the core team (the TSC from v1.0, a.k.a. "Standards Committee" in older docs) is the single decision body. Surfaced by the EEP protocol audit (finding GOV-1). Co-Authored-By: Claude Opus 4.8 (1M context) Signed-off-by: Ugur Cekmez --- GOVERNANCE.md | 8 +++++--- docs/EEIP-TEMPLATE.md | 2 +- 2 files changed, 6 insertions(+), 4 deletions(-) diff --git a/GOVERNANCE.md b/GOVERNANCE.md index c0bcbaa..a1a7bf9 100644 --- a/GOVERNANCE.md +++ b/GOVERNANCE.md @@ -208,16 +208,18 @@ IDEA → Draft → Review → Accepted / Rejected → Final → Deprecated | Stage | Description | Transition Criteria | |---|---|---| -| **Draft** | Author submits PR with `EEIP-{n}-{title}.md`. Open for early feedback. | PR opened to `proposals/` directory | +| **Draft** | Author submits PR with `EEIP-{n}-{title}.md`. Open for early feedback. | PR opened to the `docs/eeips/` directory | | **Review** | EEIP enters a 60-day public comment window. TSC reviews. | TSC acknowledges as Review-Ready via PR label | -| **Accepted** | TSC votes to accept (majority of TSC members). | TSC vote recorded in PR; EEIP merged | +| **Accepted** | TSC votes to accept (≥2/3 majority of TSC members). | TSC vote recorded in PR; EEIP merged | | **Rejected** | EEIP rejected by TSC with written rationale. | TSC vote + rejection reason posted in PR | | **Final** | At least 2 independent, interoperable implementations exist and are documented. | Author submits 2 conformance test results | | **Deprecated** | EEIP superseded by a newer EEIP. | New EEIP references old EEIP as `Deprecates` | +> **Decision body and submission directory.** During the `0.x` benevolent-dictator phase the **core team** acts as the EEIP decision body; from `v1.0` this role transfers to the elected **TSC**. Some earlier documents (e.g. `docs/eeips/EEIP-0001-core-base.md`) refer to this body as the *Standards Committee* — these names denote the same role. All EEIPs are submitted to the **`docs/eeips/`** directory (there is no `proposals/` directory); `eep.dev/proposals` is the public web mirror of that directory. + ### Pre-1.0 Fast Track -During Phase 0.x (benevolent dictator), the EEIP process is **optional but encouraged**. The core team may accept changes via regular PRs with a shorter review window (14 days). All G1–G23 changes were applied via this fast track. +During Phase 0.x (benevolent dictator), the EEIP process is **optional but encouraged**. The core team may accept changes via regular PRs with a shorter review window (14 days) instead of the 60-day formal window. All G1–G23 changes were applied via this fast track. ### Reference diff --git a/docs/EEIP-TEMPLATE.md b/docs/EEIP-TEMPLATE.md index f7fe2cc..3a45d41 100644 --- a/docs/EEIP-TEMPLATE.md +++ b/docs/EEIP-TEMPLATE.md @@ -1,6 +1,6 @@ # EEIP-TEMPLATE -Use this template to propose changes to the EEP protocol. Copy this file, rename it `EEIP-{number}-{short-title}.md`, and submit a pull request to the `proposals/` directory. +Use this template to propose changes to the EEP protocol. Copy this file, rename it `EEIP-{number}-{short-title}.md`, and submit a pull request to the `docs/eeips/` directory. ---