bud

1

Soul-Brews-Studio/arra-oracle-skills-cliCommand LineAudit failedSnapshot ec42f9213c3e

Installs: 0

Summary

Create a new oracle via maw bud — yeast-colony reproduction. Use when user says "bud", "new oracle", "create oracle", "spawn oracle", or wants to create a new permanent oracle from the current one.

SKILL.md

/bud — Create New Oracle

"Yeast budding — any oracle can spawn a new oracle."

Facilitate maw bud from inside a Claude Code session. The oracle reproduction command.

Usage

/bud myoracle                    # Bud from current oracle
/bud myoracle --split            # Bud + show child in right pane
/bud myoracle --split --birth    # Bud + split + child runs /birth
/bud myoracle --from mawjs       # Bud from specific parent
/bud myoracle --org ARRA-01      # Target different GitHub org
/bud myoracle --note "why"       # Birth note in ψ/memory/learnings/
/bud myoracle --dry-run          # Preview only
/bud myoracle --root             # Root oracle — no parent lineage

Step 0: Detect maw CLI

if command -v maw &>/dev/null; then
  MAW="maw"
elif [ -x "$HOME/.bun/bin/maw" ]; then
  MAW="$HOME/.bun/bin/maw"
else
  MAW=""
  echo "⚠️ maw CLI not found — using standalone mode"
fi

Mode 1: With maw (preferred)

Delegate to maw bud — it handles all 8 steps (repo, ψ/, CLAUDE.md, fleet config, soul-sync, commit, wake):

$MAW bud "$NAME" ${FROM:+--from "$FROM"} ${ORG:+--org "$ORG"} ${NOTE:+--note "$NOTE"} ${SPLIT:+--split} ${DRY_RUN:+--dry-run}

If --birth flag

After bud completes, chain /birth via wake:

$MAW wake "$NAME" --task '/birth'

This sends /birth as the new oracle's first message — creates Issue #1 with birth props before /awaken.

Show result

🧬 Budded: ${FROM:-current} → $NAME

  Repo:    ${ORG}/${NAME}-oracle
  Fleet:   ~/.config/maw/fleet/${NUM}-${NAME}.json
  Purpose: (to be defined by /awaken)

  Next: run /awaken in the new oracle for full identity setup
  Or:   maw hey $NAME '/awaken'

If --split flag (watch the child being born)

# Check if in tmux
if [ -n "$TMUX" ]; then
  tmux split-window -h -l 50% "cd $TARGET && claude"
  echo "✓ Split — child oracle visible on the right pane"
else
  echo "⚠️ Not in tmux — --split requires tmux."
fi

┌──────────────────┬──────────────────┐
│ parent-oracle    │ ${NAME}-oracle   │
│ (you are here)   │ (just born)      │
│                  │ > /awaken        │
│  Pane 0          │  Pane 1          │
└──────────────────┴──────────────────┘

ORG="${ORG:-Soul-Brews-Studio}"
REPO_NAME="${NAME}-oracle"

gh repo create "${ORG}/${REPO_NAME}" --private --add-readme

if command -v ghq &>/dev/null; then
  ghq get -p "github.com/${ORG}/${REPO_NAME}"
  TARGET="$(ghq root)/github.com/${ORG}/${REPO_NAME}"
else
  TARGET="$HOME/Code/github.com/${ORG}/${REPO_NAME}"
  mkdir -p "$(dirname "$TARGET")"
  git clone "https://github.com/${ORG}/${REPO_NAME}" "$TARGET"
fi

mkdir -p "$TARGET/ψ"/{memory/{learnings,retrospectives,traces,resonance},inbox,outbox,plans}

PARENT="${FROM:-$(basename $(pwd) | sed 's/-oracle$//')}"
DATE=$(date +%Y-%m-%d)

cat > "$TARGET/CLAUDE.md" << 'CLAUDEEOF'
# ${NAME}-oracle

> Budded from **${PARENT}** on ${DATE}

## Identity
- **Name**: ${NAME}
- **Purpose**: (to be defined by /awaken)
- **Budded from**: ${PARENT}

## Principles (inherited from Oracle)
1. Nothing is Deleted
2. Patterns Over Intentions
3. External Brain, Not Command
4. Curiosity Creates Existence
5. Form and Formless

## Rule 6: Oracle Never Pretends to Be Human
CLAUDEEOF

if [ -n "$NOTE" ]; then
  cat > "$TARGET/ψ/memory/learnings/${DATE}_birth-note.md" << NOTEEOF
---
pattern: Birth note from ${PARENT}
date: ${DATE}
source: /bud (standalone)
---

# Why ${NAME} was born

${NOTE}

Budded from: ${PARENT}
NOTEEOF
fi

PARENT_PSI="$(pwd)/ψ/memory/learnings"
if [ -d "$PARENT_PSI" ]; then
  cp -r "$PARENT_PSI"/*.md "$TARGET/ψ/memory/learnings/" 2>/dev/null
  echo "✓ Copied parent learnings to child"
fi

git -C "$TARGET" add -A
git -C "$TARGET" commit -m "feat: birth — budded from ${PARENT}"
git -C "$TARGET" push -u origin HEAD

🧬 Budded: ${PARENT} → ${NAME} (standalone)

  Repo:    ${ORG}/${REPO_NAME}
  Path:    ${TARGET}
  Purpose: (to be defined by /awaken)

  Next steps:
    1. Open a new session in ${TARGET}
    2. Run /awaken for full identity setup

  💡 Install maw-js for fleet integration:
     bun add -g maw-js

if [ -n "$TMUX" ]; then
  tmux split-window -h -l 50% "cd $TARGET && claude"
  echo "✓ Split — child oracle visible on the right pane"
fi

/bud      → creates the body (repo, ψ/, CLAUDE.md, commit)
/birth    → prepares the soul (Issue #1, identity fields) [optional]
/awaken   → activates consciousness (principles, theme, contacts)