Skip to content

docs(readme): retire corpus-as-moat, add the Program Surface, refresh counts - #264

Merged
ernanibmurtinho merged 1 commit into
mainfrom
docs/readme-positioning-refresh
Aug 3, 2026
Merged

docs(readme): retire corpus-as-moat, add the Program Surface, refresh counts#264
ernanibmurtinho merged 1 commit into
mainfrom
docs/readme-positioning-refresh

Conversation

@ernanibmurtinho

Copy link
Copy Markdown
Contributor

Aligns the README with current positioning — the corpus is no longer framed as the future moat, and the Program Surface (the big recent change) is now represented.

Changes

Retire corpus-as-moat (the flagged issue) — every mention:

  • Architecture step 6, the validator.py module row, the "correctness harness" row, and the License line no longer call the corpus a future moat. The moat now reads as execution — comprehension + anti-poisoning + auth-day-one — which the rest of the README already argues.

Add "Beyond HTTP — the Program Surface" with the ownership stated correctly:

  • Gecko does the comprehension (recovers the PDA seeds an IDL/llms.txt drops, derives first-plan-correct); Orquestra does the access (builds + submits the transaction). We comprehend; Orquestra accesses.
  • Proven on 4 mainnet programs (Meteora DLMM, Pump.fun, ORE, MetaDAO) against a $0 surfpool fork. Custody/signing layer kept generic.
  • Plus a ToC entry, a "What you get" row, four module-table rows (pda.py, provider_config.py, providers/, signing_gate.py), and an on-chain FAQ entry.

Freshen the provider offering → Agent-Readiness Scorecard + drift-watch (what shipped).

Fix stale/inconsistent test counts → consistent 2,170+ (badge said 2074; body said 1,630 in three spots).

Untouched (already on-message): the hero, three-layer table, "not a wrapper" FAQ, surface-graph section.

Docs-only; no code changes.

🤖 Generated with Claude Code

… counts

- Retire corpus/moat/flywheel framing (architecture, module table, license) — the
  moat is execution (comprehension + anti-poisoning + auth-day-one), not a data corpus.
- Add 'Beyond HTTP — the Program Surface': Gecko does the comprehension (recovers the
  PDA seeds an IDL drops, derives first-plan-correct); Orquestra does the access (builds
  + submits the tx). Proven on 4 mainnet programs via a $0 surfpool fork. Credits +
  links Orquestra; custody/signing layer kept generic.
- Freshen the provider offering (Agent-Readiness Scorecard + drift-watch).
- Fix stale/inconsistent test counts (2074/1,630 -> 2,170+).

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
@ernanibmurtinho ernanibmurtinho self-assigned this Aug 3, 2026
@ernanibmurtinho
ernanibmurtinho merged commit b95cb51 into main Aug 3, 2026
1 check failed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant