Skip to content

docs(site): scaffold public AEX docs site#56

Open
hebbianloop wants to merge 4 commits into
mainfrom
docs/site-scaffold
Open

docs(site): scaffold public AEX docs site#56
hebbianloop wants to merge 4 commits into
mainfrom
docs/site-scaffold

Conversation

@hebbianloop

Copy link
Copy Markdown
Member

Starts the public documentation that will become docs.aex.human.tech or the aex-ui /docs route (TBD — recommendation: Nextra, source kept as portable Markdown so the hosting choice isn't locked).

What's here (docs/site/)

  • README.md — site plan: audience split (operators vs builders), proposed nav, Nextra-vs-Gitea recommendation, and a source-of-truth mapping (public pages derive from AGENTS.md / the distribution doc / registry.json — no duplication).
  • index.md — landing / intro.
  • concepts.md — How agents run (public condensation of AGENTS.md).
  • quickstart.md — deploy your first agent.
  • versioning.md — the two-axis version model + provenance pair (derives from agent-distribution-and-versioning.md).
  • _meta.json — Nextra nav order (ignored by Gitea).

Index/Concepts/Quickstart/Versioning are seeded with real content; remaining pages are stubs marked (stub). This is the starting scaffold, not a finished site.

🤖 Generated with Claude Code

…— plan, index, concepts, quickstart, versioning

Signed-off-by: Shady El Damaty <shady@holonym.id>
@vercel

vercel Bot commented Jun 25, 2026

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
aex-agents Ready Ready Preview, Comment Jun 26, 2026 8:13pm

Request Review

Shady El Damaty added 2 commits June 25, 2026 14:13
…ecurity/building/self-host/catalog/glossary + nav

Signed-off-by: Shady El Damaty <shady@holonym.id>
…r-starter pages, policies & custom-agent guides

Signed-off-by: Shady El Damaty <shady@holonym.id>

@hebbianloop hebbianloop left a comment

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

we're missing the backend of the compute market place, how we can support multiple compute providers, giving the user the best price for compute and in the future for inference when we come out of beta

"how-agents-run": "How agents run",
"skills-and-recipes": "Skills & recipes",
"inference": "Inference (metered)",
"security-model": "Security model",

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

where is custody model? seems we should talk about 2PC ~ 2PC/MPC

also what about SCM backend? and docs for compute providers?

@@ -0,0 +1,51 @@
# Building agents

AEX starter agents are **open source** (Apache-2.0). You can author your own — for yourself or as a

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

no em dashes


AEX starter agents are **open source** (Apache-2.0). You can author your own — for yourself or as a
contribution to the catalog. Full engineering reference:
[`AGENTS.md`](https://github.com/holonym-foundation/aex/blob/main/AGENTS.md).

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

this is probably closed source no? would want to link this where its open source

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

missing our arkhai / SCM architecture and how we expose compute providers (v1) and GPU/inference providers (v2/v3)


## Keys never enter the agent

- **AI inference:** the agent holds a per-agent token, not the model provider key. The real key lives in

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

wouldn't give too much information away that helps adversarial opponent figure out what to attack


Built-in skills today:

| Skill | What it does |

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

are these it? there should be other skills from the other bots listed here

@hebbianloop

Copy link
Copy Markdown
Member Author

Per Shady: relocating this to a /docs route in aex-ui (closing the standalone-Nextra plan; full Nextra wants to own the app, so an in-app route is a Nextra-style native route). Addressing the review there:

…w, alkahest escrow, version hygiene, OpenRouter-replacement roadmap

Signed-off-by: Shady El Damaty <shady@holonym.id>
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