docs(P00): validate specification
---ci--- project: oy phase: 0 milestone: v0.1 status: specify ---/ci--- Vision v3.0 (22 sections) and Primary Architecture v0.1 (14 components) ingested. 21 REQ-IDs established. 4-phase roadmap defined. Component dependencies mapped.
This commit is contained in:
Jon Chery
@@ -1,3 +1,60 @@
|
||||
# Architecture: OpenYield (oy)
|
||||
# Architecture: OpenYield (oy) — Phase 0 Index
|
||||
|
||||
TBD - Waiting for architecture documents.
|
||||
## Source
|
||||
- Vision v3.0 (22 sections, locked)
|
||||
- Primary Architecture Document v0.1 draft (14 modular components, 6 interfaces)
|
||||
|
||||
## Component Index (14 Modular Documents — Phase 1+)
|
||||
|
||||
| # | Component | Vision § | Dependencies | Phase |
|
||||
|---|---|---|---|---|
|
||||
| 1 | OY Chain & Mirror | §7 | — | P1 |
|
||||
| 2 | Cross-Chain & Exit | §7 | 1, 3 | P3 |
|
||||
| 3 | Bread Unit & Root Basket | §6, §16 | 1 | P1 |
|
||||
| 4 | Bloom Engine | §6 | 3, 5 | P1 |
|
||||
| 5 | Storage Substrate | §5 | 1, 3 | P1 |
|
||||
| 6 | Identity, Standing & Citizenship | §8, §9 | 1, 5 | P1 |
|
||||
| 7 | Window Primitive | §10 | 5, 6, 11 | P2 |
|
||||
| 8 | Pacts Suite (Pause, Ground, Stance, Cover, Stand Registry, Hub API, Bonds) | §16, §17 | 3, 4, 5, 6, 13 | P2 |
|
||||
| 9 | Mesh Experience (Maps, Pay, Maya's Day) | §8 | 6, 12, 13 | P1 |
|
||||
| 10 | Organizational Primitives (Stands, Guilds) | §11, §12 | 5, 6, 13 | P2 |
|
||||
| 11 | Partner Spectrum & Forex (Ops, Piers, Anchors) | §13 | 1, 5, 6, 13 | P2 |
|
||||
| 12 | Bearers & Processing Mesh | §14, §15 | 1, 3, 5, 13 | P1 |
|
||||
| 13 | Fee Covenant | §18 | 5, 15 | P1 |
|
||||
| 14 | Governance (Mesh/Guild/Stand Councils) | §19 | 1, 6 | P2 |
|
||||
|
||||
## Cross-Component Interfaces (6)
|
||||
1. **Standing API** — Identity, Window, Pacts, Orgs, Partners, Governance consume. [§4.1]
|
||||
2. **Forge / Fold Interface** — Bread minting against Root Basket assets only. [§4.2]
|
||||
3. **Watcher Attestation Interface (The Mirror)** — 9 Watchers, 6-of-9 quorum. [§4.3]
|
||||
4. **Window Lifecycle Interface** — Holder-authorized, scope-bounded, revocable. [§4.4]
|
||||
5. **Fee Covenant Interface** — Auto-decline, ceiling/floor enforced by smart contract. [§4.5]
|
||||
6. **Voice / Council Interface** — Multi-source Voice, Mission Lock enforced. [§4.6]
|
||||
|
||||
## Critical Blocker Chain
|
||||
```
|
||||
OY Chain (1) → Bread/Root Basket (3) → Storage (5) → Identity/Standing (6)
|
||||
│
|
||||
▼
|
||||
{Window (7), Pacts (8), Orgs (10),
|
||||
Partners (11), Governance (14)}
|
||||
|
||||
Fee Covenant (13) blocks {Pacts (8), Orgs (10), Partners (11), Bearers (12)}
|
||||
```
|
||||
|
||||
## Non-Negotiables (Architect Prompt)
|
||||
- Six Principles
|
||||
- Fee ceiling 0.1% / floor 0.01% / 1-Grain internal minimum
|
||||
- FCFS processing
|
||||
- 6-of-9 Watcher quorum
|
||||
- Four Freeholder signals
|
||||
- Bayesian Standing formula
|
||||
- Lexicon compliance
|
||||
- No KYC at protocol level
|
||||
- No fractional reserve lending
|
||||
- No equity, shareholders, or exit
|
||||
|
||||
## Phase 0 Architecture Deliverables
|
||||
- This index file
|
||||
- Persona assessment (created during RESEARCH stage)
|
||||
- Phase plans (created during PLAN stage)
|
||||
+51
-7
@@ -1,15 +1,59 @@
|
||||
# Project: OpenYield (oy)
|
||||
|
||||
## Objective
|
||||
Create a multiproject called OpenYield. OY is the system name, but each subsystem will be developed as individual projects.
|
||||
OpenYield (OY) is a durable, anti-greed, jurisdiction-light financial layer — a public-good mesh owned by its Holders, run by its Guilds, defended by code, and sustained by the real yield of the real economy.
|
||||
|
||||
## Vision Source
|
||||
- Vision v3.0 (22 sections, locked commitments, covenant preserved)
|
||||
- Primary Architecture Document v0.1 (14 modular components, 6 cross-component interfaces)
|
||||
|
||||
## Requirements
|
||||
- Create a new owner group in Gitea at git.cloudinit.dev/oy.
|
||||
- Each subsystem will have its own repository within this group.
|
||||
- **REQ-001**: Mesh must enforce the Six Principles (real value, sustainability, mission-lock, openness, ownership, self-service). [§2]
|
||||
- **REQ-002**: Fee ceiling 0.1% / floor 0.01% / 1-Grain internal minimum, mission-locked, enforced by smart contract. [§18]
|
||||
- **REQ-003**: Bloom must originate only from real yield (Root Basket: Treasuries ~35%, IG corporate ~25%, tokenized gold ~20%, Bitcoin ~10%, other RWAs ~10%). [§6]
|
||||
- **REQ-004**: 9 Watchers, 6-of-9 quorum, daily attestations, 100,000 Bread bond each. [§7]
|
||||
- **REQ-005**: Four Freeholder signals locked (90d Stash, 4.5★+ in 3 cats, Capital, Vouch). [§9.1]
|
||||
- **REQ-006**: Standing anti-gaming formula locked (Bayesian + time-decay + diversity + voucher-weighted − slashes). [§9.2]
|
||||
- **REQ-007**: FCFS processing (not fee-auctioned), geographic proximity wins. [§15]
|
||||
- **REQ-008**: OY Chain (Layer 1) — canonical state for Root-Pool, Root Basket, Forge/Fold, Pacts, Bloom, Voucher bonds, Watcher attestations, Partner registry. [§7]
|
||||
- **REQ-009**: Satellite chains (Layer 2) — wrapped Bread, Pass-Act propagation on Polygon/Base/Arbitrum/Optimism/Solana. [§7]
|
||||
- **REQ-010**: Exit layer (Layer 3) — DEX swaps, bridges, off-mesh services (Holder-initiated). [§7]
|
||||
- **REQ-011**: Three Councils (Mesh, Guild, Stand) with multi-source Voice. Mission Lock cannot be amended. [§19]
|
||||
- **REQ-012**: Lexicon compliance — never use: bank, deposit, interest, yield, currency, dollar/euro, account, savings, depositor. [§3]
|
||||
- **REQ-013**: Bread unit with scale: Grain → Crumb → Bread → Loaf → Batch → Cake → Bakery → Granary → Mill → Harvest → Earth. [§4]
|
||||
- **REQ-014**: Three pools of storage: Stash (Holder), Vault (Stand), Root-Pool (treasury). [§5]
|
||||
- **REQ-015**: Window primitive — scope, duration, rate-limit, audit log, revoke. [§10]
|
||||
- **REQ-016**: Nine Stand types (Household, Crew, Entity, Co-op, Circle, Trust, Foundation, Confederation, Shadow). [§11]
|
||||
- **REQ-017**: Guilds with Hand-Passes at 0% protocol fee. [§12]
|
||||
- **REQ-018**: Four-tier Partner Spectrum (Op, Master Op, Pier, Anchor). [§13]
|
||||
- **REQ-019**: Six bearers (Internet, OY-LR, OY-BLE, OY-WiFi-Direct, OY-SAT, OY-QR) via Unified Bearer Layer. [§14]
|
||||
- **REQ-020**: Six Pacts (Pause, Ground, Stance, Cover, Stand Registry, Hub API). [§16]
|
||||
- **REQ-021**: Mesh Bond Market with 8% upper coupon cap, 0% floor. [§17]
|
||||
|
||||
## Constraints
|
||||
- Must follow CIAgent initialization workflow.
|
||||
- Use multi-project mode in `.ciagent/config.json`.
|
||||
- 14 modular component docs govern subsystem development. [Architecture §3]
|
||||
- Six cross-component interfaces (Standing, Forge/Fold, Mirror, Window, Fee Covenant, Voice/Council) are the integration contract. [Architecture §4]
|
||||
- Hardest blocker chain: OY Chain → Bread/Root Basket → Storage → Identity/Standing → {Window, Pacts, Orgs, Partners, Governance}. [Architecture §5.2]
|
||||
- Phase 0 must ship before any execution phases.
|
||||
- Multi-project mode active; project slug = `oy`.
|
||||
|
||||
## Out of Scope
|
||||
- Actual implementation of subsystems (waiting for vision + architecture docs).
|
||||
## Out of Scope (Phase 0)
|
||||
- Maya's Day integration spec (deferred to Mesh Experience component) [Architecture Q1]
|
||||
- Full sub-tables for Standing anti-gaming (formula locked; sub-tables deferred) [Architecture Q2]
|
||||
- Full risk mitigations for 19 risk items (listed, distributed across components) [Architecture Q3]
|
||||
- Detailed phase deliverables beyond high-level roadmap [Architecture Q4]
|
||||
- Pier credential routing details (e-Residency, biometric IDs) [Architecture Q5]
|
||||
- Experimental bond forms (Phase 4+ only) [Architecture Q6]
|
||||
- Cover Pool seniority mechanics and over-pledging math [Architecture Q7]
|
||||
- Processor share tier boundary exact volumes [Architecture Q8]
|
||||
|
||||
## Phase 0 Deliverables
|
||||
- `.ciagent/oy/PROJECT.md` — this file
|
||||
- `.ciagent/oy/ARCHITECTURE.md` — initial architecture index
|
||||
- `.ciagent/oy/ROADMAP.md` — phase breakdown
|
||||
- `.ciagent/oy/REQUIREMENTS.md` — REQ-IDs
|
||||
- Persona assessment
|
||||
- Phase plans
|
||||
|
||||
## Milestone
|
||||
v1.0 — OpenYield Foundation Init
|
||||
@@ -1,7 +1,25 @@
|
||||
# Requirements: OpenYield (oy)
|
||||
|
||||
| ID | Requirement | Priority | Status |
|
||||
|----|-------------|----------|--------|
|
||||
| REQ-001 | System must be organized as a multiproject with OY as the umbrella. | High | Pending |
|
||||
| REQ-002 | Owner group `oy` must be created at git.cloudinit.dev. | High | Pending |
|
||||
| REQ-003 | Each subsystem must have a dedicated repository. | High | Pending |
|
||||
| ID | Requirement | Vision § | Priority | Status |
|
||||
|----|-------------|----------|----------|--------|
|
||||
| REQ-001 | Enforce Six Principles | §2 | High | Pending |
|
||||
| REQ-002 | Fee ceiling 0.1% / floor 0.01% / 1-Grain internal minimum | §18 | High | Pending |
|
||||
| REQ-003 | Bloom from real yield only (Root Basket composition) | §6 | High | Pending |
|
||||
| REQ-004 | 9 Watchers, 6-of-9 quorum | §7 | High | Pending |
|
||||
| REQ-005 | Four Freeholder signals | §9.1 | High | Pending |
|
||||
| REQ-006 | Standing anti-gaming formula | §9.2 | High | Pending |
|
||||
| REQ-007 | FCFS processing | §15 | High | Pending |
|
||||
| REQ-008 | OY Chain (Layer 1) | §7 | High | Pending |
|
||||
| REQ-009 | Satellite chains (Layer 2) | §7 | Medium | Pending |
|
||||
| REQ-010 | Exit layer (Layer 3) | §7 | Medium | Pending |
|
||||
| REQ-011 | Three Councils with Mission Lock | §19 | High | Pending |
|
||||
| REQ-012 | Lexicon compliance | §3 | High | Pending |
|
||||
| REQ-013 | Bread unit with scale | §4 | High | Pending |
|
||||
| REQ-014 | Three pools of storage | §5 | High | Pending |
|
||||
| REQ-015 | Window primitive | §10 | High | Pending |
|
||||
| REQ-016 | Nine Stand types | §11 | Medium | Pending |
|
||||
| REQ-017 | Guilds with free Hand-Passes | §12 | Medium | Pending |
|
||||
| REQ-018 | Four-tier Partner Spectrum | §13 | Medium | Pending |
|
||||
| REQ-019 | Six bearers via Unified Bearer Layer | §14 | Medium | Pending |
|
||||
| REQ-020 | Six Pacts | §16 | Medium | Pending |
|
||||
| REQ-021 | Mesh Bond Market with 8% cap | §17 | Medium | Pending |
|
||||
+58
-6
@@ -1,9 +1,61 @@
|
||||
# Roadmap: OpenYield (oy)
|
||||
|
||||
## Phase 0: Pre-Execution
|
||||
- [x] Initialize CIAgent project
|
||||
- [ ] Ingest vision and architecture documents
|
||||
- [ ] Define subsystem projects
|
||||
## Phase 0 — Pre-Execution (Current)
|
||||
- [x] Initialize CIAgent project (init workflow)
|
||||
- [ ] SPECIFY — validate specification
|
||||
- [ ] CLARIFY — resolve ambiguities (autonomy: full → auto-decide defaults)
|
||||
- [ ] RESEARCH — domain research + persona assessment
|
||||
- [ ] PLAN — create phase plans
|
||||
- [ ] GRILL — adversarial review
|
||||
- [ ] Ship phase 0
|
||||
|
||||
## Phase 1: Specification
|
||||
- [ ] Detailed subsystem specifications
|
||||
## Phase 1 — Foundation (Year 1)
|
||||
**Target**: first 10,000 Holders, 50 Master Ops
|
||||
|
||||
| Component | Deliverable |
|
||||
|---|---|
|
||||
| OY Chain & Mirror (1) | L1 chain launched, 9 Watchers bonded, Mirror live |
|
||||
| Bread Unit & Root Basket (3) | Forge/Fold on Ethereum + 2–3 L2s; initial Root Basket |
|
||||
| Storage Substrate (5) | Stash, Vault, Root-Pool contracts |
|
||||
| Bloom Engine (4) | Bloom accrual loop tied to Mirror attestations |
|
||||
| Fee Covenant (13) | 0.1% ceiling live, processor share 50%, internal minimum 1 Grain |
|
||||
| Identity, Standing & Citizenship (6) | Reach v1, Standing v1, Nomad/Freeholder system |
|
||||
| Bearers & Processing Mesh (12) | Processing v1, OY-BLE, OY-WiFi-Direct |
|
||||
| Mesh Experience (9) | Maps, Pay v1 |
|
||||
|
||||
## Phase 2 — The Mesh (Year 2)
|
||||
**Target**: $1B annual volume, 4 service categories
|
||||
|
||||
| Component | Deliverable |
|
||||
|---|---|
|
||||
| Organizational Primitives (10) | 9 Stand types, Guilds (Hand-Passes free) |
|
||||
| Partner Spectrum & Forex (11) | First Piers, Forex Engine v1 |
|
||||
| Window Primitive (7) | Holder-authorized data channels |
|
||||
| Pacts Suite (8) | Pause, Ground, Stance, Cover, Stand Registry |
|
||||
| Governance (14) | Mesh Council activated |
|
||||
| Bearers expansion | OY-LR + Beacon v1 |
|
||||
| Bonds | First Mesh Bonds |
|
||||
|
||||
## Phase 3 — The Bearers (Year 3)
|
||||
**Target**: $10B annual volume → fee auto-declines to 0.07%
|
||||
|
||||
| Component | Deliverable |
|
||||
|---|---|
|
||||
| Cross-Chain & Exit (2) | Full L2/L1 bridges, DEX integration |
|
||||
| Bearers expansion | OY-SAT, OY-QR |
|
||||
| Hub API | B2B backbone: custody, lending primitive, compliance |
|
||||
| Anchors | First institutional partners |
|
||||
| Services | Care / SIM / Vault / Mail |
|
||||
| Bond market | Full market, Growth Bonds |
|
||||
|
||||
## Phase 4 — Maturity (Years 4–5+)
|
||||
**Target**: $50–100B volume → fees auto-decline to 0.03%
|
||||
|
||||
- Cross-chain expansion, Confederation support, 10+ language app
|
||||
- Yield Token, Travel + 11 service categories
|
||||
- Protocol funded primarily by Root-Pool Bloom
|
||||
|
||||
## Long Run (Years 5–10+)
|
||||
**Target**: Fee at 0.01% floor; $1T+ annual volume; Root-Pool funds everything; millions of Freeholders; hundreds of Piers
|
||||
|
||||
> _The covenant is fulfilled._
|
||||
Reference in New Issue
Block a user