docs: define ECC platform value loop (#2119)

This commit is contained in:
Affaan Mustafa
2026-06-02 19:51:02 +08:00
committed by GitHub
parent d86fadad0d
commit 99baa82500
6 changed files with 284 additions and 0 deletions
@@ -51,6 +51,9 @@ not place trades. They can help a user:
## Growth Loop
For the general product-integration contract, see
[`docs/architecture/platform-value-loop.md`](../../architecture/platform-value-loop.md).
The loop is intentionally simple:
1. ECC users discover useful public prediction-market skills.
@@ -14,6 +14,7 @@ tagging plugin surfaces, uploading video, or posting announcements.
| `skills/hermes-imports/SKILL.md` | Sanitized Hermes-to-ECC import workflow | Includes import rules, sanitization checklist, conversion pattern, and output contract |
| `docs/architecture/cross-harness.md` | Shared substrate model for Claude Code, Codex, OpenCode, Cursor, Gemini, Hermes, and terminal-only use | Names portability boundaries and does not claim unsupported native parity |
| `docs/architecture/harness-adapter-compliance.md` | Adapter matrix and scorecard | Verified by `npm run harness:adapters -- --check` |
| `docs/architecture/platform-value-loop.md` | Product integration and full-stack platform thesis | Keeps external product skill packs, gated APIs, case studies, sponsorship, Pro, and consulting loops separate from unsupported GA/control-pane claims |
| `docs/architecture/observability-readiness.md` | Local operator-readiness gate | Verified by `npm run observability:ready` |
| `docs/architecture/progress-sync-contract.md` | GitHub, Linear, handoff, roadmap, and work-item sync boundary | Checked by `node scripts/platform-audit.js --json` |
| `scripts/preview-pack-smoke.js` | Deterministic preview-pack smoke gate | Verified by `npm run preview-pack:smoke` |
@@ -46,6 +47,11 @@ tagging plugin surfaces, uploading video, or posting announcements.
## Itô Skill Pack Boundary
The general product-integration contract is recorded in
`docs/architecture/platform-value-loop.md`. The Itô pack is the first worked
example: useful public workflows, separate gated API access, and sanitized
operator patterns feeding back into ECC without merging business ownership.
The preview pack includes six public teaser skills for prediction-market and
Itô-adjacent workflows:
@@ -66,6 +66,27 @@ The operating rhythm after launch should be weekly:
5. one measurable funnel readback covering repo traffic, sponsor clicks, Pro
conversions, MRR movement, and inbound replies.
## Platform Value Loop
The long-term platform thesis is recorded in
[`docs/architecture/platform-value-loop.md`](../../architecture/platform-value-loop.md).
ECC should stay useful as free OSS while the managed value accrues around team
memory, observable sessions, release gates, evals, security evidence, hosted
analysis, billing, partner workflows, and product-specific integrations.
Product integrations should behave like repeatable distribution loops:
1. ship a public skill pack that works without private credentials;
2. keep live product data or actions behind an explicit gated API path;
3. add fixtures, docs, evals, and risk gates so the workflow is testable;
4. convert sanitized product usage back into ECC skills, docs, or evidence;
5. route serious teams toward sponsors, Pro, partners, or consulting.
Itô is the current example: prediction-market research, basket comparison,
manual non-advisory planning, and data-atlas workflows can be distributed
through ECC, while live Itô data and account-specific calls remain gated by
`ITO_API_KEY` and separate from ECC Tools billing.
## Release Gates
| Lane | Done when | Current action |