Skip to content

Commit 7fdcdee

Browse files
authored
Create RESOLUTION.md
1 parent 539d425 commit 7fdcdee

File tree

1 file changed

+80
-0
lines changed

1 file changed

+80
-0
lines changed

RESOLUTION.md

Lines changed: 80 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,80 @@
1+
# Resolution Log
2+
3+
This file tracks all lifecycle changes to CommandLayer verbs, aliases, and schemas.
4+
It is the **single source of truth** for why something was added, deprecated, or removed.
5+
Every entry must be documented here to maintain transparency and trust.
6+
7+
---
8+
9+
## Format
10+
11+
Each entry should include:
12+
13+
- **Date** — When the decision was made.
14+
- **Verb(s)** — Affected canonical verb(s) or aliases.
15+
- **Action** — Added, Deprecated, Replaced, or Removed.
16+
- **Reason** — Short explanation (ecosystem need, duplication, ambiguity, etc.).
17+
- **Resolution** — The final decision (what replaces it, if anything).
18+
- **Maintainers** — Who approved the change.
19+
20+
---
21+
22+
## Example Entries
23+
24+
### 2025-09-15 — Verb Addition
25+
- **Verb(s):** `stream`
26+
- **Action:** Added
27+
- **Reason:** Needed for continuous broadcast use cases (audio/video agents).
28+
- **Resolution:** Accepted as a **commercial** verb with 2 aliases (`broadcast`, `cast`).
29+
- **Maintainers:** @greg, @ayden
30+
31+
---
32+
33+
### 2025-09-12 — Deprecation
34+
- **Verb(s):** `register`
35+
- **Action:** Deprecated
36+
- **Reason:** Overlaps semantically with `subscribe`; caused confusion.
37+
- **Resolution:** Marked as deprecated. Remains valid until **2025-07-10**.
38+
- Developers should migrate to `subscribe`.
39+
- **Maintainers:** @nicole
40+
41+
---
42+
43+
### 2025-09-22 — Removal
44+
- **Verb(s):** `log`
45+
- **Action:** Removed
46+
- **Reason:** Completed the 90-day deprecation window.
47+
- **Resolution:** Permanently removed from canonical verbs.
48+
- **Maintainers:** @roman, @kai
49+
50+
---
51+
52+
### 2025-09-01 — Alias Update
53+
- **Verb(s):** `checkout`
54+
- **Alias(es):** `buy`
55+
- **Action:** Rejected alias proposal
56+
- **Reason:** Ambiguous with `purchase` and `order`.
57+
- **Resolution:** Alias `buy` will not be added.
58+
- **Maintainers:** @ethan @julia
59+
60+
---
61+
62+
## Rules of Thumb
63+
64+
1. **No silent changes** — everything must be logged here.
65+
2. **Stability first** — once a verb is stable, only replace if absolutely necessary.
66+
3. **Deprecation window** — always give at least **90 days** before removal.
67+
4. **Aliases are soft** — easier to add/remove, but still require reasoning.
68+
5. **Governance matters** — if there’s disagreement, it must be resolved before merging.
69+
70+
---
71+
72+
Maintainers: Please update this file with every schema, verb, or alias decision.
73+
If it’s not in `RESOLUTION.md`, it didn’t officially happen.
74+
75+
## Links
76+
77+
- [Security Policy](./SECURITY.md) — responsible disclosure and vulnerability handling
78+
- [RESOLUTION.md](./RESOLUTION.md) — governance and deprecation log
79+
- [Policy](./POLICY.md) — verbs, aliases, and ENS binding rules
80+
- [GOVERNANCE.md](./GOVERNANCE.md) — decision-making and multisig control

0 commit comments

Comments
 (0)