name: alive-bundle description: Create, manage, and graduate bundles -- the unit of focused work within a walnut version: 1.0.0 author: ALIVE Context System license: MIT toolsets:
- terminal
- file triggers:
- "create bundle"
- "new bundle"
- "bundle"
- "start a bundle"
- "graduate bundle" metadata: hermes: tags: [ALIVE, context, bundle, work]
Bundle Management
Bundles are self-contained units of work inside a walnut. Any folder with a context.manifest.yaml is a bundle.
Create
What's this bundle for?
1. Outcome -- produces something specific (deliverable, has a done state)
2. Evergreen -- accumulates context over time (collection, ongoing)
Ask for:
- Name: kebab-case (e.g.,
website-rebuild) - Goal: one sentence describing the deliverable or collection
Scaffold:
BUNDLE_PATH="$WALNUT_PATH/[bundle-name]"
mkdir -p "$BUNDLE_PATH/raw"
Write context.manifest.yaml:
goal: "[goal]"
status: draft
version: v0.1
sensitivity: private
pii: false
created: [today]
updated: [today]
context: |
Bundle created. [Initial context from conversation.]
sources: []
linked_bundles: []
tags: []
squirrels: [[session_id]]
active_sessions:
- session: [session_id]
engine: hermes-agent
started: [now]
working_on: "Initial setup"
Write tasks.json:
{"tasks": []}
Status Lifecycle
draft -> prototype -> published -> done
- draft -- actively worked on, markdown only
- prototype -- has a visual (HTML), maybe shared with 1-2 people
- published -- shared externally
- done -- outputs complete, bundle stays as historical record
Graduate
When a *-v1.md or *-v1.html file exists:
v1 exists. Graduate this bundle?
1. Yes, mark as done
2. Yes, mark as published
3. Not yet
Flip status: in manifest. Bundle folder stays where it is.
Routing
When content arrives:
- Same goal -> same bundle
- Related but different goal -> new bundle, link to existing
- Ambiguous -> ask once