alive-bundle

star 107

Create, manage, and graduate bundles -- the unit of focused work within a walnut

alivecontext By alivecontext schedule Updated 4/10/2026

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
Install via CLI
npx skills add https://github.com/alivecontext/alive --skill alive-bundle
Repository Details
star Stars 107
call_split Forks 5
navigation Branch main
article Path SKILL.md
More from Creator
alivecontext
alivecontext Explore all skills →