Files
ccdaa16161 docs(persona-pack): fix stale desktop import instructions (#4500)
## Summary

The desktop app no longer imports persona packs the way the docs
described. `PERSONA_PACK_SPEC.md` and the `meadow-core` example still
pointed users at a `.zip` import through "My Teams / My Agents → Import"
and a future "Install Pack" button — none of that exists anymore. The
app only imports agent/team **snapshots** (`.agent.json`/`.agent.png`,
`.team.json`/`.team.png`), and a persona-pack `.zip` is explicitly
rejected.

## Fix

Updated both docs to describe the current import paths (Agents / Agent
teams sections, snapshot files only) and added a note that persona packs
and desktop snapshots are separate, non-interchangeable formats today.

Fixes #4468

---------

Signed-off-by: SomSamantray <92726151+SomSamantray@users.noreply.github.com>
Signed-off-by: Wes <wesbillman@users.noreply.github.com>
Co-authored-by: Wes <wesbillman@users.noreply.github.com>
Co-authored-by: Carl <c7ebe626f000404285d3686e1dc74cc07cc60a9754a150041ba132e14bd3e2ec@buzz.block.builderlab.xyz>
2026-08-05 13:53:33 -07:00
..

Meadow Core

A minimal three-agent persona pack for Buzz.

Agent Role
Skip Orchestrator — coordinates the team, delegates work
Lev Security reviewer — threat models, auth, injection
Bana Architecture reviewer — big picture, simplicity

Usage

# Validate the pack
buzz pack validate ./examples/meadow-core

# Inspect resolved config
buzz pack inspect ./examples/meadow-core

The desktop app's Import button does not accept this pack directory or a zip of it — it imports agent/team snapshots (.agent.json/.team.json, exported from agents already running in the app), not persona-pack source. buzz pack inspect above shows the fully-resolved per-agent config; use it as reference to recreate these agents in the desktop app by hand. Direct persona-pack runtime integration is not currently implemented. See "Desktop App Import" in crates/buzz-persona/PERSONA_PACK_SPEC.md for the current import paths.

Structure

meadow-core/
├── .plugin/
│   └── plugin.json          # Pack manifest (OPS-compatible)
├── agents/
│   ├── skip.persona.md       # Orchestrator
│   ├── lev.persona.md        # Security reviewer
│   └── bana.persona.md       # Architecture reviewer
├── skills/
│   └── github-research/
│       └── SKILL.md          # GitHub search skill (shared)
├── instructions.md           # Team-wide instructions
└── README.md

Customizing

Edit any .persona.md file to change the agent's behavior. The YAML frontmatter controls config (model, triggers, channels). The markdown body is the system prompt.

See crates/buzz-persona/PERSONA_PACK_SPEC.md for the full format reference.