Skip to content

docs: add token-efficient spec bundle#507

Draft
bussyjd wants to merge 1 commit into
mainfrom
docs/token-efficient-spec-bundle
Draft

docs: add token-efficient spec bundle#507
bussyjd wants to merge 1 commit into
mainfrom
docs/token-efficient-spec-bundle

Conversation

@bussyjd
Copy link
Copy Markdown
Collaborator

@bussyjd bussyjd commented May 20, 2026

Summary

Adds a root-level, token-efficient specification bundle for Obol Stack, reverse-engineered from the current code surfaces and upstream spec-bundler structure.

What changed

  • Adds SPEC.md, ARCHITECTURE.md, and BEHAVIORS_AND_EXPECTATIONS.md as the canonical root spec set.
  • Adds focused BDD feature files under features/ for stack lifecycle, agent runtime, sell-side monetization, buy-side payments, ERC-8004 discovery, tunnel/storefront, OBOL payment assets, and release smoke.
  • Adds ADRs under docs/adr/ for the major decisions coding agents should not relitigate.
  • Replaces the stale chart-oriented CONTRIBUTING.md with Obol Stack developer rules tied to the spec bundle.

Notes

The bundle is intentionally compact for agent consumption: stable IDs, dense tables, short scenarios, and cross-references instead of long narrative prose.

Validation

  • git diff --check
  • ASCII-only scan over the generated docs

No Go tests were run because this is docs/spec-only.

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