mirror of
https://github.com/block/buzz.git
synced 2026-08-18 06:50:31 +02:00
ccdaa16161
## 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>
52 lines
1.7 KiB
Markdown
52 lines
1.7 KiB
Markdown
# 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
|
|
|
|
```bash
|
|
# 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.
|