jerry/buzz
1
0
Fork 0
mirror of https://github.com/block/buzz.git synced 2026-11-02 15:31:27 +00:00
Code Issues Packages Projects Releases Wiki Activity
Files
cfd16deb77ca0496827765e4c2e73bf8f003b0b4
buzz/docs/guides/agents.md
npub19zza5yyr075j4vvlg2drsh2xe0xy3dqxhfchlgtw8vryglrry3gq8q7tzk cfd16deb77 docs: scaffold documentation information architecture (Phase 1) 
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>
2026-07-07 11:48:10 -07:00

766 B
Raw Blame History

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)