Skip to content

Commit 96bf970

Browse files
authored
Update GOVERNANCE.md
1 parent f1967d1 commit 96bf970

File tree

1 file changed

+57
-59
lines changed

1 file changed

+57
-59
lines changed

GOVERNANCE.md

Lines changed: 57 additions & 59 deletions
Original file line numberDiff line numberDiff line change
@@ -1,19 +1,18 @@
1-
2-
# Governance — Protocol Commons
1+
# Governance — Protocol-Commons
32

43
The CommandLayer Protocol Commons defines the canonical verb and schema layer for agents.
5-
During the v1.0.0 cycle, it operates under a single-maintainer model to ensure stability and accuracy of the command language.
6-
As the protocol matures, stewardship will expand to a small group of trusted maintainers, supported by an open proposal and review process. This ensures the Commons can grow, improve, and remain stable under a clear and transparent governance model.
4+
5+
During the v1.0.0 cycle, it operates under a single-maintainer model to ensure stability and correctness of the core language. As adoption grows, stewardship will expand to a small group of trusted maintainers under a transparent proposal and review process.
76

87
---
98

109
## Stewardship
1110

12-
- **Owner:** `commandlayer.eth`
11+
- **Owner:** commandlayer.eth
1312
- **Maintainer:** CommandLayer Governance Council
14-
- **Contact:** `dev@commandlayer.org`
13+
- **Contact:** dev@commandlayer.org
1514

16-
The Commons layer must remain:
15+
The Commons MUST remain:
1716

1817
- Neutral — no vendor-specific semantics
1918
- Minimal — only what is required for interoperability
@@ -24,67 +23,66 @@ The Commons layer must remain:
2423

2524
## Change Process
2625

27-
1. **Open an issue** describing the proposed update
28-
2. **Provide justification** (interoperability need, bug fix, receipt fix, security hardening)
29-
3. **Run validation**:
30-
- All schemas pass strict Ajv
31-
- All examples pass
32-
- `checksums.txt` regenerated
33-
4. **Maintainer review** and determination
34-
5. **Tagged release + provenance update**:
35-
- New tag (e.g., `commons-v1.0.1`)
36-
- New IPFS CID recorded in `SECURITY_PROVENANCE.md`
37-
- ENS TXT fields updated if applicable
38-
39-
Changes that alter the request/receipt contract, trace semantics, alias mapping rules, or x402 requirements require a **minor or major** version bump.
26+
1. Open an Issue describing the change request
27+
2. Provide justification
28+
- Interoperability need
29+
- Bug fix
30+
- Security correction
31+
3. Update/verifying artifacts:
32+
- Request + receipt schemas validated under strict Ajv
33+
- Checksums regenerated
34+
- Manifest updated
35+
4. Maintainer review + decision
36+
5. Versioned release:
37+
- New tag (e.g., `commons-v1.0.1`)
38+
- New IPFS CID recorded in `SECURITY_PROVENANCE.md`
39+
40+
⚠️ Any change to request/receipt shape or `$id` structure requires a **minor/major** version bump.
4041

4142
---
4243

43-
## ENS Binding Governance
44-
45-
ENS TXT fields associated with Protocol-Commons — such as those stored under `commandlayer.eth` or verb-specific ENS names — are **critical protocol resources**.
46-
47-
Fields include:
48-
49-
- `cl.verb`
50-
- `cl.version`
51-
- `cl.schema.request`
52-
- `cl.schema.receipt`
53-
- `cl.cid.schemas`
54-
- `cl.owner`
55-
- `cl.schemas.mirror.ipfs`
56-
- `cl.agentcard`
57-
- `cl.cid.agentcard`
58-
- `cl.agentcard.mirror.ipfs`
59-
- `cl.checksum.request`
60-
- `cl.checksum.receipt`
61-
- `cl.checksum.agentcard`
62-
- `cl.owner`
63-
64-
Any modification must undergo:
65-
66-
- Maintainer approval
67-
- Out-of-band verification (PGP or signed message)
68-
- Logging in `RESOLUTION.md` with timestamp + rationale
44+
## ENS Binding
45+
46+
Protocol-Commons is responsible ONLY for:
47+
```
48+
cl.verb
49+
cl.version
50+
cl.schema.request
51+
cl.schema.receipt
52+
cl.cid.schemas
53+
cl.schemas.mirror.ipfs
54+
```
55+
56+
These are **immutable protocol commitments** once published.
57+
58+
Updates MUST be approved via governance and logged in `RESOLUTION.md`.
6959

7060
---
7161

7262
## Deprecation
7363

74-
When a verb or schema is deprecated:
64+
1. Log change in `RESOLUTION.md`
65+
2. Mark deprecated in documentation
66+
3. Preserve for backward compatibility unless removal is a security event
67+
68+
Deprecation window: **≥90 days** before removal.
69+
70+
---
71+
72+
## Transparency Artifacts
73+
74+
- `POLICY.md` — rules for verbs & schemas
75+
- `SPEC.md` — normative protocol requirements
76+
- `RESOLUTION.md` — lifecycle history
77+
- `SECURITY_PROVENANCE.md` — CIDs & hashes for each release
78+
79+
---
80+
81+
82+
83+
84+
7585

76-
1. **Record** in `RESOLUTION.md` with:
77-
- Affected `$id`
78-
- Reason
79-
- Replacement (if any)
80-
2. **Mark** deprecated status in `SPEC.md` and public documentation
81-
3. **Preserve** the schema for backward compatibility unless removal is required for security
8286

83-
Removal is treated as an **exceptional event** and requires a documented migration path for downstream integrators.
8487

85-
## Links
8688

87-
- [SECURITY POLICY](./SECURITY.md) — responsible disclosure and vulnerability handling
88-
- [RESOLUTION](./RESOLUTION.md) — governance and deprecation log
89-
- [POLICY](./POLICY.md) — verbs and ENS binding rules
90-
- [GOVERNANCE](./GOVERNANCE.md) — decision-making and multisig control

0 commit comments

Comments
 (0)