Design and Architecture

Design + Architecture

This section is for engineers reading or contributing to the Auki SDK source. It frames the in-repo documentation for a wider audience.

Where to start

• The Five Questions — the architectural backbone (Identity / Spatial / Temporal / Networking / Tokenomics)
• Glossary — long-form companion to GLOSSARY.md, with code refs and common confusions per term
• Crate map — what each Rust crate does, in narrative form (stub)

In-repo documentation

The repo holds frozen-in-time design records for major changes:

• docs/superpowers/specs/ — design specifications
• docs/superpowers/plans/ — implementation plans
• dataproducts.md — the peer-discovery / resource catalog reference
• docs/control-api.md — HTTP control API for SDK-session daemons

Release / tag history

• Release history — annotated tag list with what changed (stub)

git tag --list --sort=-v:refname shows the current set; git show vX.Y.Z is the authoritative annotated-tag message.

Authoritative spec

• VISION.md — the aspirational protocol spec
• GLOSSARY.md — domain terms (this wiki's Glossary page expands on it)

Contributing

• CONTRIBUTING.md — folder convention, board flow, git hygiene
• CLAUDE.md — the equivalent for AI agents