mirror of
https://github.com/block/buzz.git
synced 2026-11-09 02:41:57 +00:00
cfd16deb77
Add the docs/ skeleton for the full docs implementation: getting-started, architecture, guides, reference, and vision sections, with a nav/TOC home page. Every page is a stub carrying its heading outline and pointers to the source material to be migrated in Phase 2 (content). docs/nips/, docs/spec/, and the loose design docs stay at their current paths (55 references from code, tests, and migrations outside docs/); reference/nips.md and reference/design-docs.md index them instead. Root GitHub-convention files are untouched. ARCHITECTURE/NOSTR/TESTING/ RELEASING/VISION* remain in place this phase and will become pointer files in Phase 2. Co-authored-by: npub19zza5yyr075j4vvlg2drsh2xe0xy3dqxhfchlgtw8vryglrry3gq8q7tzk <2885da10837fa92ab19f429a385d46cbcc48b406ba717fa16e3b06447c632450@sprout-oss.stage.blox.sqprod.co> Signed-off-by: npub19zza5yyr075j4vvlg2drsh2xe0xy3dqxhfchlgtw8vryglrry3gq8q7tzk <2885da10837fa92ab19f429a385d46cbcc48b406ba717fa16e3b06447c632450@sprout-oss.stage.blox.sqprod.co>
23 lines
766 B
Markdown
23 lines
766 B
Markdown
# Working with Agents
|
|
|
|
> **Status: stub — Phase 1 (structure).** Content to be written in Phase 2.
|
|
>
|
|
> **Scope:** Running agents against a relay: the ACP harness, agent identity, memory, personas, and example agents.
|
|
|
|
## Outline
|
|
|
|
- Agent model overview (buzz-acp harness, buzz-agent)
|
|
- Minting an agent identity + channel membership (sharp edges called out)
|
|
- Running buzz-acp (env, ws:// vs http://)
|
|
- Core memory / NIP-AE prompt injection
|
|
- Personas (buzz-persona)
|
|
- Examples: countdown-bot, meadow-core
|
|
- Troubleshooting (idle agent, quiet stdout)
|
|
|
|
## Source material
|
|
|
|
- `TESTING.md` §ACP Harness
|
|
- `crates/buzz-acp`, `crates/buzz-agent/README.md`, `crates/buzz-persona`
|
|
- `examples/countdown-bot`, `examples/meadow-core`
|
|
- `docs/MCP_DRIVEN_HOOKS.md` (linked)
|