update-agent

Files (1)

• SKILL.md

SKILL.md (first lines)

# Update Agent

This skill walks the user through updating an existing agent without losing its accumulated MEMORY.md state.

## Invariants (READ THIS FIRST)

> **NEVER read or write `agents/<name>/MEMORY.md`.** It's the agent's accumulated state — preserving it across edits is the entire point of this skill.
>
> **NEVER touch `agents/<name>/session.json`.** Same reason.
>
> The **only** exception is the "Delete agent" menu option, which removes the entire `agents/<name>/` directory by design.
>
> All edits go through helpers in `src/agents.ts` — they're full-file rewrites with marker-aware patching. Do not hand-edit SOUL.md or CLAUDE.md with the Edit tool.

## Tone

Friendly, brief, opinionated. Same vibe as `create-agent`. Acknowledge each answer in a sentence or less and move on.

## Flow

### Step 1 — List agents

If `$ARGUMENTS` already names an agent, skip to Step 3. Otherwise:

```bash
bun -e 'const { listAgents } = await import(`${process.env.CLAUDECLAW_ROOT || "."}/src/agents.ts`); console.log((await listAgents()).join("\n"));'
```

Show the list and ask "Which one?".

### Step 2 — Pick agent

Capture the chosen name. Validate it exists in the list above.

### Step 3 — Show current state

```bash
bun -e '
const { loadAgent, listAgentJobs } = await import(`${process.env.CLAUDECLAW_ROOT || "."}/src/agents.ts`);
const ctx = await loadAgent("AGENT_NAME");
const jobs = await listAgentJobs("AGENT_NAME");
console.log("SOUL.md (head):");
console.log((await Bun.file(ctx.soulPath).text()).split("\n").slice(0,30).join("\n"));
console.log("\nJobs:");
for (const j of jobs) console.log(`  - ${j.label} (${j.cron}) ${j.enabled ? "" : "[disabled]"} ${j.model ? "model="+j.model : ""}`);
'
```

### Step 4 — Menu loop

Present this menu and **loop until the user picks Done**. One selection at a time.

```
1. Workflow         — rewrite the agent's operating manual
2. Personality      — rewrite the personality block
3. Add job          — add a new scheduled task
4. Edit job         — change cron / trigger / enabled / model on an existing job
5. Remove job       — delete a scheduled task
6. Discord channels — re-set the channel list
7. Data sources     — rewrite the data sources block
8. Default model    — set or clear the agent's defaultModel (opus/sonnet/haiku/glm — middle fallback tier)
9. Delete agent     — nuke the entire agent directory (requires re-typing the name)
10. Done            — exit
```

For each option, ask the relevant follow-up question(s), then run the matching `bun -e` invocation. Use temp JSON files for any multi-line content (workflow, personality, trigger prompts) to keep escaping sane.

> **IMPORTANT — Jobs are LOCAL cron.** The Add/Edit/Remove job options below operate on `agents/<name>/jobs/<label>.md` files which are scanned by `loadJobs()` and fired by ClaudeClaw's in-process cron loop. They are NOT the remote `schedule` skill. Do NOT invoke the `schedule` skill from this wizard.

#### Mode selection (Options 1, 2, 7)

Before collecting new content for Workflow / Personality / Data sources, ask:

```
How should this be applied?
  a. Append        — add to the existing <section> (keeps everything already there) [DEFAULT]
  b. Replace       — wipe and rewrite the entire block
  c. Show current  — print the current content first, then ask again
```

If the user picks `a` or just hits enter → use `mode: "append"` (default — non-destructive).
If `b` → use `mode: "replace"`.
If `c` → read the current marker block from SOUL.md (Workflow/Personality) or CLAUDE.md (Data sources), print it back to the user, then re-prompt for the mode choice.

To read current content for Show current:

```bash
bun -e '
const { loadAgent } = await import(`${process.env.CLAUDECLAW_ROOT || "."}/src/agents.ts`);
const ctx = await loadAgent("AGENT_NAME");
const path = "SOUL_OR_CLAUDE_PATH"; // ctx.soulPath or ctx.claudeMdPath
const text = await Bun.file(path).text();
const start = "<!-- claudeclaw:workflow:start -->"; // or :personality: / :datasources:
const end   = "<!-- claudeclaw:workflow:end -->";
const i = text.indexOf(start), j = text.indexOf(end);
console.log(i === -1 ? "(no existing block)" : text.slice(i + start.length, j).trim());
'
```

#### Option 1 — Workflow

Run the **mode selection** above, then re-prompt: "What's the new workflow? (multi-line)".
Write to `/tmp/claudeclaw-update.json` as `{"value": "...", "mode": "append"|"replace"}` then:

```bash
bun -e '
import { readFileSync } from "fs";
const { updateAgent } = await import(`${process.env.CLAUDECLAW_ROOT || "."}/src/agents.ts`);
const { value, mode } = JSON.parse(readFileSync("/tmp/claudeclaw-update.json", "utf8"));
await updateAgent("AGENT_NAME", { workflow: { value, mode } });
console.log("workflow updated (" + mode + ")");
'
```

#### Option 2 — Personality

Run the **mode selection** above, then re-prompt for the new personality content:

```bash

From TerrysPOV/ClaudeClaw-Plus, MIT.

More from TerrysPOV/ClaudeClaw-Plus