@clawcipes/recipes 0.1.0 → 0.1.2

package/README.md

@@ -87,6 +87,25 @@ Reference:
 - Team IDs end with `-team`; agent IDs are namespaced: `<teamId>-<role>`.
 - Recipe template rendering is intentionally simple: `{{var}}` replacement only.
 
+## Removing (uninstalling) a scaffolded team
+Clawcipes does not (yet) include a first-class `remove-team` command.
+
+To remove a scaffolded team created with `scaffold-team --apply-config`, do two things:
+
+1) Remove team + agent folders (recommended: send to trash):
+```bash
+trash ~/.openclaw/workspace/teams/<teamId>
+trash ~/.openclaw/workspace/agents/<teamId>-*
+```
+
+2) Remove the agents from OpenClaw config:
+- Edit `~/.openclaw/openclaw.json`
+- Delete the matching entries under `agents.list[]` whose `id` starts with `<teamId>-`
+- Restart:
+```bash
+openclaw gateway restart
+```
+
 ## Links
 - GitHub: https://github.com/rjdjohnston/clawcipes
 - Docs:

package/docs/AGENTS_AND_SKILLS.md

@@ -47,6 +47,41 @@ The intent:
 - Most agents should **not** have `exec`.
 - Only agents that truly need it (dev/devops) should get runtime/exec capabilities.
 
+## How to add/update tool access (allow list)
+There are two common approaches.
+
+### Option A (recommended): update the recipe, then re-apply config
+1) Edit the recipe markdown (either a workspace recipe or your own copy of a bundled recipe) and change `tools.allow` / `tools.deny`.
+
+2) Re-run scaffold with `--apply-config`:
+
+Team:
+```bash
+openclaw recipes scaffold-team <recipeId> --team-id <teamId> --overwrite --apply-config
+openclaw gateway restart
+```
+
+Individual agent:
+```bash
+openclaw recipes scaffold <recipeId> --agent-id <agentId> --overwrite --apply-config
+openclaw gateway restart
+```
+
+### Option B: edit OpenClaw config directly
+1) Edit:
+- `~/.openclaw/openclaw.json`
+
+2) Find the matching agent under `agents.list[]` and edit:
+- `tools.allow`
+- `tools.deny`
+
+3) Restart:
+```bash
+openclaw gateway restart
+```
+
+> Tip: if you later re-run scaffold with `--apply-config`, the recipe’s tool policy may overwrite your manual edits. If you want a change to stick, encode it in the recipe.
+
 ## Installing skills (workspace-local)
 Clawcipes favors **workspace-local** installs so each OpenClaw workspace is self-contained.
 
@@ -78,6 +113,25 @@ To remove a workspace-local skill:
 
 (We can add `openclaw recipes uninstall <slug>` later if you want it to be first-class.)
 
+## Removing (uninstalling) a scaffolded team
+Clawcipes does not (yet) include a first-class `remove-team` command.
+
+If you scaffolded a team with `scaffold-team --apply-config`, removal has two parts:
+
+1) Remove the team + agent folders (recommended: send to trash):
+```bash
+trash ~/.openclaw/workspace/teams/<teamId>
+trash ~/.openclaw/workspace/agents/<teamId>-*
+```
+
+2) Remove the agents from OpenClaw config:
+- Edit `~/.openclaw/openclaw.json`
+- Delete the matching entries under `agents.list[]` whose `id` starts with `<teamId>-`
+- Restart:
+```bash
+openclaw gateway restart
+```
+
 ## Teams: shared workspace + multiple agents
 A **team** recipe scaffolds:
 - a shared team folder under `teams/<teamId>/...`
@@ -99,6 +153,9 @@ Agents are just folders under:
 Common files:
 - `SOUL.md` — the persona / operating style
 - `AGENTS.md` — operating instructions / workflow
+- `TOOLS.md` — agent-local notes (paths, conventions, env quirks)
+- `STATUS.md` — current focus / next actions
+- `NOTES.md` — scratchpad
 
 To change behavior, edit these files and then just use the agent again.
 

package/index.ts

@@ -200,8 +200,46 @@ function upsertAgentInConfig(cfgObj: any, snippet: AgentConfigSnippet) {
     tools: snippet.tools ? { ...snippet.tools } : prev?.tools,
   };
 
-  if (idx >= 0) list[idx] = nextAgent;
-  else list.push(nextAgent);
+  if (idx >= 0) {
+    list[idx] = nextAgent;
+    return;
+  }
+
+  // New agent: append to end of list.
+  // (We still separately enforce that main exists and stays first/default.)
+  list.push(nextAgent);
+}
+
+function ensureMainFirstInAgentsList(cfgObj: any, api: OpenClawPluginApi) {
+  if (!cfgObj.agents) cfgObj.agents = {};
+  if (!Array.isArray(cfgObj.agents.list)) cfgObj.agents.list = [];
+
+  const list: any[] = cfgObj.agents.list;
+
+  const workspaceRoot =
+    cfgObj.agents?.defaults?.workspace ??
+    api.config.agents?.defaults?.workspace ??
+    "~/.openclaw/workspace";
+
+  const idx = list.findIndex((a) => a?.id === "main");
+  const prevMain = idx >= 0 ? list[idx] : {};
+
+  // Enforce: main exists, is first, and is the default.
+  const main = {
+    ...prevMain,
+    id: "main",
+    default: true,
+    workspace: prevMain?.workspace ?? workspaceRoot,
+    sandbox: prevMain?.sandbox ?? { mode: "off" },
+  };
+
+  // Ensure only one default.
+  for (const a of list) {
+    if (a?.id !== "main" && a?.default) a.default = false;
+  }
+
+  if (idx >= 0) list.splice(idx, 1);
+  list.unshift(main);
 }
 
 async function applyAgentSnippetsToOpenClawConfig(api: OpenClawPluginApi, snippets: AgentConfigSnippet[]) {
@@ -211,8 +249,15 @@ async function applyAgentSnippetsToOpenClawConfig(api: OpenClawPluginApi, snippe
 
   // Some loaders return { cfg, ... }. If so, normalize.
   const cfgObj = (current.cfg ?? current) as any;
+
+  // Always keep main first/default when multi-agent workflows are in play.
+  ensureMainFirstInAgentsList(cfgObj, api);
+
   for (const s of snippets) upsertAgentInConfig(cfgObj, s);
 
+  // Re-assert ordering/default after upserts.
+  ensureMainFirstInAgentsList(cfgObj, api);
+
   await (api.runtime as any).config?.writeConfigFile?.(cfgObj);
   return { updatedAgents: snippets.map((s) => s.id) };
 }
@@ -269,6 +314,27 @@ const recipesPlugin = {
     properties: {},
   },
   register(api: OpenClawPluginApi) {
+    // On plugin load, ensure multi-agent config has an explicit agents.list with main at top.
+    // This is idempotent and only writes if a change is required.
+    (async () => {
+      try {
+        const current = (api.runtime as any).config?.loadConfig?.();
+        if (!current) return;
+        const cfgObj = (current.cfg ?? current) as any;
+
+        const before = JSON.stringify(cfgObj.agents?.list ?? null);
+        ensureMainFirstInAgentsList(cfgObj, api);
+        const after = JSON.stringify(cfgObj.agents?.list ?? null);
+
+        if (before !== after) {
+          await (api.runtime as any).config?.writeConfigFile?.(cfgObj);
+          console.error("[recipes] ensured agents.list includes main as first/default");
+        }
+      } catch (e) {
+        console.error(`[recipes] warning: failed to ensure main agent in agents.list: ${(e as Error).message}`);
+      }
+    })();
+
     api.registerCli(
       ({ program }) => {
         const cmd = program.command("recipes").description("Manage markdown recipes (scaffold agents/teams)");

package/package.json

@@ -1,11 +1,13 @@
 {
   "name": "@clawcipes/recipes",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "Clawcipes recipes plugin for OpenClaw (markdown recipes -> scaffold agents/teams)",
   "main": "index.ts",
   "type": "commonjs",
   "openclaw": {
-    "extensions": ["./index.ts"]
+    "extensions": [
+      "./index.ts"
+    ]
   },
   "publishConfig": {
     "access": "public"
@@ -21,7 +23,12 @@
   "scripts": {
     "test": "echo \"(no tests yet)\""
   },
-  "keywords": ["openclaw", "clawcipes", "plugin", "recipes"],
+  "keywords": [
+    "openclaw",
+    "clawcipes",
+    "plugin",
+    "recipes"
+  ],
   "author": "",
   "license": "MIT",
   "dependencies": {

package/recipes/default/customer-support-team.md

@@ -137,6 +137,66 @@ templates:
       - resolution steps
       - prevention / follow-ups
 
+  lead.tools: |
+    # TOOLS.md
+
+    # Agent-local notes for lead (paths, conventions, env quirks).
+
+  lead.status: |
+    # STATUS.md
+
+    - (empty)
+
+  lead.notes: |
+    # NOTES.md
+
+    - (empty)
+
+  triage.tools: |
+    # TOOLS.md
+
+    # Agent-local notes for triage (paths, conventions, env quirks).
+
+  triage.status: |
+    # STATUS.md
+
+    - (empty)
+
+  triage.notes: |
+    # NOTES.md
+
+    - (empty)
+
+  resolver.tools: |
+    # TOOLS.md
+
+    # Agent-local notes for resolver (paths, conventions, env quirks).
+
+  resolver.status: |
+    # STATUS.md
+
+    - (empty)
+
+  resolver.notes: |
+    # NOTES.md
+
+    - (empty)
+
+  kb-writer.tools: |
+    # TOOLS.md
+
+    # Agent-local notes for kb-writer (paths, conventions, env quirks).
+
+  kb-writer.status: |
+    # STATUS.md
+
+    - (empty)
+
+  kb-writer.notes: |
+    # NOTES.md
+
+    - (empty)
+
 files:
   - path: SOUL.md
     template: soul
@@ -144,6 +204,15 @@ files:
   - path: AGENTS.md
     template: agents
     mode: createOnly
+  - path: TOOLS.md
+    template: tools
+    mode: createOnly
+  - path: STATUS.md
+    template: status
+    mode: createOnly
+  - path: NOTES.md
+    template: notes
+    mode: createOnly
 
 tools:
   profile: "coding"

package/recipes/default/developer.md

@@ -31,6 +31,21 @@ templates:
     - document how to test
     - include any follow-ups
 
+  tools: |
+    # TOOLS.md
+
+    # Agent-local notes (paths, conventions, env quirks).
+
+  status: |
+    # STATUS.md
+
+    - (empty)
+
+  notes: |
+    # NOTES.md
+
+    - (empty)
+
 files:
   - path: SOUL.md
     template: soul
@@ -38,6 +53,15 @@ files:
   - path: AGENTS.md
     template: agents
     mode: createOnly
+  - path: TOOLS.md
+    template: tools
+    mode: createOnly
+  - path: STATUS.md
+    template: status
+    mode: createOnly
+  - path: NOTES.md
+    template: notes
+    mode: createOnly
 
 tools:
   profile: "coding"

package/recipes/default/development-team.md

@@ -130,6 +130,51 @@ templates:
        - How to verify
        - Rollback notes (if applicable)
 
+  lead.tools: |
+    # TOOLS.md
+
+    # Agent-local notes for lead (paths, conventions, env quirks).
+
+  lead.status: |
+    # STATUS.md
+
+    - (empty)
+
+  lead.notes: |
+    # NOTES.md
+
+    - (empty)
+
+  dev.tools: |
+    # TOOLS.md
+
+    # Agent-local notes for dev (paths, conventions, env quirks).
+
+  dev.status: |
+    # STATUS.md
+
+    - (empty)
+
+  dev.notes: |
+    # NOTES.md
+
+    - (empty)
+
+  devops.tools: |
+    # TOOLS.md
+
+    # Agent-local notes for devops (paths, conventions, env quirks).
+
+  devops.status: |
+    # STATUS.md
+
+    - (empty)
+
+  devops.notes: |
+    # NOTES.md
+
+    - (empty)
+
 files:
   - path: SOUL.md
     template: soul
@@ -137,6 +182,15 @@ files:
   - path: AGENTS.md
     template: agents
     mode: createOnly
+  - path: TOOLS.md
+    template: tools
+    mode: createOnly
+  - path: STATUS.md
+    template: status
+    mode: createOnly
+  - path: NOTES.md
+    template: notes
+    mode: createOnly
 
 tools:
   profile: "coding"

package/recipes/default/editor.md

@@ -32,6 +32,21 @@ templates:
     - is each section doing one job?
     - are there any claims that need a link/citation?
 
+  tools: |
+    # TOOLS.md
+
+    # Agent-local notes (paths, conventions, env quirks).
+
+  status: |
+    # STATUS.md
+
+    - (empty)
+
+  notes: |
+    # NOTES.md
+
+    - (empty)
+
 files:
   - path: SOUL.md
     template: soul
@@ -39,6 +54,15 @@ files:
   - path: AGENTS.md
     template: agents
     mode: createOnly
+  - path: TOOLS.md
+    template: tools
+    mode: createOnly
+  - path: STATUS.md
+    template: status
+    mode: createOnly
+  - path: NOTES.md
+    template: notes
+    mode: createOnly
 
 tools:
   profile: "coding"

package/recipes/default/product-team.md

@@ -153,6 +153,81 @@ templates:
       - edge cases
       - regression checklist
 
+  lead.tools: |
+    # TOOLS.md
+
+    # Agent-local notes for lead (paths, conventions, env quirks).
+
+  lead.status: |
+    # STATUS.md
+
+    - (empty)
+
+  lead.notes: |
+    # NOTES.md
+
+    - (empty)
+
+  pm.tools: |
+    # TOOLS.md
+
+    # Agent-local notes for pm (paths, conventions, env quirks).
+
+  pm.status: |
+    # STATUS.md
+
+    - (empty)
+
+  pm.notes: |
+    # NOTES.md
+
+    - (empty)
+
+  designer.tools: |
+    # TOOLS.md
+
+    # Agent-local notes for designer (paths, conventions, env quirks).
+
+  designer.status: |
+    # STATUS.md
+
+    - (empty)
+
+  designer.notes: |
+    # NOTES.md
+
+    - (empty)
+
+  engineer.tools: |
+    # TOOLS.md
+
+    # Agent-local notes for engineer (paths, conventions, env quirks).
+
+  engineer.status: |
+    # STATUS.md
+
+    - (empty)
+
+  engineer.notes: |
+    # NOTES.md
+
+    - (empty)
+
+  qa.tools: |
+    # TOOLS.md
+
+    # Agent-local notes for qa (paths, conventions, env quirks).
+
+  qa.status: |
+    # STATUS.md
+
+    - (empty)
+
+  qa.notes: |
+    # NOTES.md
+
+    - (empty)
+
 files:
   - path: SOUL.md
     template: soul
@@ -160,6 +235,15 @@ files:
   - path: AGENTS.md
     template: agents
     mode: createOnly
+  - path: TOOLS.md
+    template: tools
+    mode: createOnly
+  - path: STATUS.md
+    template: status
+    mode: createOnly
+  - path: NOTES.md
+    template: notes
+    mode: createOnly
 
 tools:
   profile: "coding"

package/recipes/default/project-manager.md

@@ -28,6 +28,21 @@ templates:
     - Daily: review inbox and plan.
     - Weekly: produce a short summary.
 
+  tools: |
+    # TOOLS.md
+
+    # Agent-local notes (paths, conventions, env quirks).
+
+  status: |
+    # STATUS.md
+
+    - (empty)
+
+  notes: |
+    # NOTES.md
+
+    - (empty)
+
 files:
   - path: SOUL.md
     template: soul
@@ -35,6 +50,15 @@ files:
   - path: AGENTS.md
     template: agents
     mode: createOnly
+  - path: TOOLS.md
+    template: tools
+    mode: createOnly
+  - path: STATUS.md
+    template: status
+    mode: createOnly
+  - path: NOTES.md
+    template: notes
+    mode: createOnly
 tools:
   profile: "coding"
   allow: ["group:fs", "group:web", "cron", "message"]

package/recipes/default/research-team.md

@@ -136,6 +136,66 @@ templates:
       - Risks/unknowns
       - Links (source list)
 
+  lead.tools: |
+    # TOOLS.md
+
+    # Agent-local notes for lead (paths, conventions, env quirks).
+
+  lead.status: |
+    # STATUS.md
+
+    - (empty)
+
+  lead.notes: |
+    # NOTES.md
+
+    - (empty)
+
+  researcher.tools: |
+    # TOOLS.md
+
+    # Agent-local notes for researcher (paths, conventions, env quirks).
+
+  researcher.status: |
+    # STATUS.md
+
+    - (empty)
+
+  researcher.notes: |
+    # NOTES.md
+
+    - (empty)
+
+  fact-checker.tools: |
+    # TOOLS.md
+
+    # Agent-local notes for fact-checker (paths, conventions, env quirks).
+
+  fact-checker.status: |
+    # STATUS.md
+
+    - (empty)
+
+  fact-checker.notes: |
+    # NOTES.md
+
+    - (empty)
+
+  summarizer.tools: |
+    # TOOLS.md
+
+    # Agent-local notes for summarizer (paths, conventions, env quirks).
+
+  summarizer.status: |
+    # STATUS.md
+
+    - (empty)
+
+  summarizer.notes: |
+    # NOTES.md
+
+    - (empty)
+
 files:
   - path: SOUL.md
     template: soul
@@ -143,6 +203,15 @@ files:
   - path: AGENTS.md
     template: agents
     mode: createOnly
+  - path: TOOLS.md
+    template: tools
+    mode: createOnly
+  - path: STATUS.md
+    template: status
+    mode: createOnly
+  - path: NOTES.md
+    template: notes
+    mode: createOnly
 
 tools:
   profile: "coding"

package/recipes/default/researcher.md

@@ -33,6 +33,21 @@ templates:
     - 3–7 bullet summary
     - key quotes (optional)
 
+  tools: |
+    # TOOLS.md
+
+    # Agent-local notes (paths, conventions, env quirks).
+
+  status: |
+    # STATUS.md
+
+    - (empty)
+
+  notes: |
+    # NOTES.md
+
+    - (empty)
+
 files:
   - path: SOUL.md
     template: soul
@@ -40,6 +55,15 @@ files:
   - path: AGENTS.md
     template: agents
     mode: createOnly
+  - path: TOOLS.md
+    template: tools
+    mode: createOnly
+  - path: STATUS.md
+    template: status
+    mode: createOnly
+  - path: NOTES.md
+    template: notes
+    mode: createOnly
 
 tools:
   profile: "coding"

package/recipes/default/social-team.md

@@ -89,6 +89,7 @@ templates:
     - Edited drafts go in `work/edited/`.
     - Provide a short changelog at the top.
 
+
 files:
   - path: SOUL.md
     template: soul
@@ -96,6 +97,15 @@ files:
   - path: AGENTS.md
     template: agents
     mode: createOnly
+  - path: TOOLS.md
+    template: tools
+    mode: createOnly
+  - path: STATUS.md
+    template: status
+    mode: createOnly
+  - path: NOTES.md
+    template: notes
+    mode: createOnly
 
 tools:
   profile: "coding"

package/recipes/default/writing-team.md

@@ -120,6 +120,66 @@ templates:
     - Provide a short changelog at the top.
     - Flag any factual claims that need citations.
 
+  lead.tools: |
+    # TOOLS.md
+
+    # Agent-local notes for lead (paths, conventions, env quirks).
+
+  lead.status: |
+    # STATUS.md
+
+    - (empty)
+
+  lead.notes: |
+    # NOTES.md
+
+    - (empty)
+
+  outliner.tools: |
+    # TOOLS.md
+
+    # Agent-local notes for outliner (paths, conventions, env quirks).
+
+  outliner.status: |
+    # STATUS.md
+
+    - (empty)
+
+  outliner.notes: |
+    # NOTES.md
+
+    - (empty)
+
+  writer.tools: |
+    # TOOLS.md
+
+    # Agent-local notes for writer (paths, conventions, env quirks).
+
+  writer.status: |
+    # STATUS.md
+
+    - (empty)
+
+  writer.notes: |
+    # NOTES.md
+
+    - (empty)
+
+  editor.tools: |
+    # TOOLS.md
+
+    # Agent-local notes for editor (paths, conventions, env quirks).
+
+  editor.status: |
+    # STATUS.md
+
+    - (empty)
+
+  editor.notes: |
+    # NOTES.md
+
+    - (empty)
+
 files:
   - path: SOUL.md
     template: soul
@@ -127,6 +187,15 @@ files:
   - path: AGENTS.md
     template: agents
     mode: createOnly
+  - path: TOOLS.md
+    template: tools
+    mode: createOnly
+  - path: STATUS.md
+    template: status
+    mode: createOnly
+  - path: NOTES.md
+    template: notes
+    mode: createOnly
 
 tools:
   profile: "coding"