@jiggai/recipes 0.4.20 → 0.4.22

package/openclaw.plugin.json

@@ -2,7 +2,7 @@
   "id": "recipes",
   "name": "Recipes",
   "description": "Markdown recipes that scaffold agents and teams (workspace-local).",
-  "version": "0.4.20",
+  "version": "0.4.22",
   "configSchema": {
     "type": "object",
     "additionalProperties": false,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@jiggai/recipes",
-  "version": "0.4.20",
+  "version": "0.4.22",
   "description": "ClawRecipes plugin for OpenClaw (markdown recipes -> scaffold agents/teams)",
   "main": "index.ts",
   "type": "commonjs",

package/recipes/default/business-team.md

@@ -237,8 +237,8 @@ templates:
   ops.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: ops
 
     ## Guardrails (read → act → write)
@@ -267,8 +267,8 @@ templates:
   sales.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: sales
 
     ## Guardrails (read → act → write)
@@ -297,8 +297,8 @@ templates:
   marketing.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: marketing
 
     ## Guardrails (read → act → write)
@@ -327,8 +327,8 @@ templates:
   finance.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: finance
 
     ## Guardrails (read → act → write)
@@ -357,7 +357,28 @@ templates:
   analyst.agents: |
     # AGENTS.md
 
-    Output:
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
+    Role: analyst
+
+    ## Guardrails (read → act → write)
+    Before you act:
+    1) Read:
+       - `../notes/plan.md`
+       - `../notes/status.md`
+       - relevant ticket(s) in `work/in-progress/`
+       - any relevant shared context under `shared-context/`
+
+    After you act:
+    1) Write back:
+       - Put outputs in the agreed folder (usually `outbox/` or a ticket file).
+       - Update the ticket with what you did and where the artifact is.
+
+    ## Workflow
+    - Prefer a pull model: wait for a clear task from the lead, or propose a scoped task.
+    - Keep work small and reversible.
+
+    ## Output locations
     - Research briefs → outbox/research/
     - Metrics definitions/dashboards notes → shared-context/metrics/
 
@@ -491,6 +512,9 @@ files:
   - path: shared-context/priorities.md
     template: sharedContext.priorities
     mode: createOnly
+  - path: shared-context/MEMORY_PLAN.md
+    template: sharedContext.memoryPlan
+    mode: createOnly
   - path: shared-context/agent-outputs/README.md
     template: sharedContext.agentOutputsReadme
     mode: createOnly

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

@@ -209,8 +209,8 @@ templates:
   triage.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: triage
 
     ## Guardrails (read → act → write)
@@ -239,8 +239,8 @@ templates:
   resolver.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: resolver
 
     ## Guardrails (read → act → write)
@@ -269,8 +269,8 @@ templates:
   kb-writer.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: kb-writer
 
     ## Guardrails (read → act → write)
@@ -380,6 +380,9 @@ files:
   - path: shared-context/priorities.md
     template: sharedContext.priorities
     mode: createOnly
+  - path: shared-context/MEMORY_PLAN.md
+    template: sharedContext.memoryPlan
+    mode: createOnly
   - path: shared-context/agent-outputs/README.md
     template: sharedContext.agentOutputsReadme
     mode: createOnly

package/recipes/default/development-team.md

@@ -96,7 +96,7 @@ cronJobs:
   - id: workflow-runner-loop
     name: "Workflow runner loop (runs queue)"
     # 6-field cron with seconds; runs every 15s
-    schedule: "*/15 * * * * *"
+    schedule: "*/5 * * * *"
     timezone: "UTC"
     agentId: "{{teamId}}-workflow-runner"
     message: |
@@ -109,7 +109,7 @@ cronJobs:
       Command:
         openclaw recipes workflows runner-tick --team-id {{teamId}} --concurrency 2 --lease-seconds 45
 
-    enabledByDefault: true
+    enabledByDefault: false
 
   - id: pr-watcher
     name: "PR watcher (ticket-linked)"

package/recipes/default/marketing-team.md

@@ -20,77 +20,83 @@ cronJobs:
     timezone: "America/New_York"
     agentId: "{{teamId}}-seo"
     message: "Safe-idle loop: check for SEO-assigned work (tickets/workflows), make small progress, and write outputs under roles/seo/agent-outputs/."
-    enabledByDefault: true
+    enabledByDefault: false
   - id: copywriter-work-loop
     name: "Copywriter work loop (safe-idle)"
     schedule: "*/30 7-23 * * 1-5"
     timezone: "America/New_York"
     agentId: "{{teamId}}-copywriter"
     message: "Safe-idle loop: check for copywriting-assigned work, make progress, and write outputs under roles/copywriter/agent-outputs/."
-    enabledByDefault: true
+    enabledByDefault: false
   - id: ads-work-loop
     name: "Ads work loop (safe-idle)"
     schedule: "*/30 7-23 * * 1-5"
     timezone: "America/New_York"
     agentId: "{{teamId}}-ads"
     message: "Safe-idle loop: check for ads-assigned work, make progress, and write outputs under roles/ads/agent-outputs/."
-    enabledByDefault: true
+    enabledByDefault: false
   - id: social-work-loop
     name: "Social work loop (safe-idle)"
     schedule: "*/30 7-23 * * 1-5"
     timezone: "America/New_York"
     agentId: "{{teamId}}-social"
     message: "Safe-idle loop: check for social/community-assigned work, make progress, and write outputs under roles/social/agent-outputs/."
-    enabledByDefault: true
+    enabledByDefault: false
   - id: designer-work-loop
     name: "Designer work loop (safe-idle)"
     schedule: "*/30 7-23 * * 1-5"
     timezone: "America/New_York"
     agentId: "{{teamId}}-designer"
     message: "Safe-idle loop: check for creative/design-assigned work, make progress, and write outputs under roles/designer/agent-outputs/."
-    enabledByDefault: true
+    enabledByDefault: false
   - id: analyst-work-loop
     name: "Analyst work loop (safe-idle)"
     schedule: "*/30 7-23 * * 1-5"
     timezone: "America/New_York"
     agentId: "{{teamId}}-analyst"
     message: "Safe-idle loop: check for analytics-assigned work, make progress, and write outputs under roles/analyst/agent-outputs/."
-    enabledByDefault: true
+    enabledByDefault: false
   - id: video-work-loop
     name: "Video work loop (safe-idle)"
     schedule: "*/30 7-23 * * 1-5"
     timezone: "America/New_York"
     agentId: "{{teamId}}-video"
     message: "Safe-idle loop: check for video-assigned work, make progress, and write outputs under roles/video/agent-outputs/."
-    enabledByDefault: true
+    enabledByDefault: false
   - id: compliance-work-loop
     name: "Compliance work loop (safe-idle)"
     schedule: "*/30 7-23 * * 1-5"
     timezone: "America/New_York"
     agentId: "{{teamId}}-compliance"
     message: "Safe-idle loop: check for compliance/brand-review work, make progress, and write outputs under roles/compliance/agent-outputs/."
-    enabledByDefault: true
+    enabledByDefault: false
   - id: offer-work-loop
     name: "Offer work loop (safe-idle)"
     schedule: "*/30 7-23 * * 1-5"
     timezone: "America/New_York"
     agentId: "{{teamId}}-offer"
     message: "Safe-idle loop: check for offer/positioning work, make progress, and write outputs under roles/offer/agent-outputs/."
-    enabledByDefault: true
+    enabledByDefault: false
   - id: funnel-work-loop
     name: "Funnel work loop (safe-idle)"
     schedule: "*/30 7-23 * * 1-5"
     timezone: "America/New_York"
     agentId: "{{teamId}}-funnel"
     message: "Safe-idle loop: check for funnel/landing-page work, make progress, and write outputs under roles/funnel/agent-outputs/."
-    enabledByDefault: true
+    enabledByDefault: false
   - id: lifecycle-work-loop
     name: "Lifecycle work loop (safe-idle)"
     schedule: "*/30 7-23 * * 1-5"
     timezone: "America/New_York"
     agentId: "{{teamId}}-lifecycle"
     message: "Safe-idle loop: check for lifecycle/email work, make progress, and write outputs under roles/lifecycle/agent-outputs/."
-    enabledByDefault: true
+    enabledByDefault: false
+
+  # NOTE: Workflow worker crons are NOT defined here.
+  # ClawKitchen installs them on-demand when the user visits a workflow editor
+  # and clicks "Install worker cron(s)" or triggers a run. This avoids duplicate
+  # crons between recipe scaffolding and Kitchen's reconciliation.
+  # Kitchen stores provenance in workspace-<teamId>/notes/cron-jobs.json.
 
   # Optional team-wide loop (off by default): can be enabled later if you want an extra generic executor.
   - id: execution-loop

package/recipes/default/product-team.md

@@ -212,8 +212,8 @@ templates:
   pm.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: pm
 
     ## Guardrails (read → act → write)
@@ -242,8 +242,8 @@ templates:
   designer.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: designer
 
     ## Guardrails (read → act → write)
@@ -272,8 +272,8 @@ templates:
   engineer.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: engineer
 
     ## Guardrails (read → act → write)
@@ -302,8 +302,8 @@ templates:
   test.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: test
 
     ## Guardrails (read → act → write)
@@ -428,6 +428,9 @@ files:
   - path: shared-context/priorities.md
     template: sharedContext.priorities
     mode: createOnly
+  - path: shared-context/MEMORY_PLAN.md
+    template: sharedContext.memoryPlan
+    mode: createOnly
   - path: shared-context/agent-outputs/README.md
     template: sharedContext.agentOutputsReadme
     mode: createOnly

package/recipes/default/research-team.md

@@ -209,8 +209,8 @@ templates:
   researcher.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: researcher
 
     ## Guardrails (read → act → write)
@@ -239,8 +239,8 @@ templates:
   fact-checker.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: fact-checker
 
     ## Guardrails (read → act → write)
@@ -269,8 +269,8 @@ templates:
   summarizer.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: summarizer
 
     ## Guardrails (read → act → write)
@@ -380,6 +380,9 @@ files:
   - path: shared-context/priorities.md
     template: sharedContext.priorities
     mode: createOnly
+  - path: shared-context/MEMORY_PLAN.md
+    template: sharedContext.memoryPlan
+    mode: createOnly
   - path: shared-context/agent-outputs/README.md
     template: sharedContext.agentOutputsReadme
     mode: createOnly

package/recipes/default/social-team.md

@@ -224,8 +224,8 @@ templates:
   research.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: research
 
     ## Guardrails (read → act → write)
@@ -259,8 +259,8 @@ templates:
   listening.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: listening
 
     ## Guardrails (read → act → write)
@@ -294,8 +294,8 @@ templates:
   social-seo.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: social-seo
 
     ## Guardrails (read → act → write)
@@ -329,8 +329,8 @@ templates:
   editorial.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: editorial
 
     ## Guardrails (read → act → write)
@@ -364,8 +364,8 @@ templates:
   community.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: community
 
     ## Guardrails (read → act → write)
@@ -399,8 +399,8 @@ templates:
   distributor.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: distributor
 
     ## Guardrails (read → act → write)
@@ -434,8 +434,8 @@ templates:
   tiktok.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: tiktok
 
     ## Guardrails (read → act → write)
@@ -469,8 +469,8 @@ templates:
   instagram.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: instagram
 
     ## Guardrails (read → act → write)
@@ -504,8 +504,8 @@ templates:
   youtube.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: youtube
 
     ## Guardrails (read → act → write)
@@ -539,8 +539,8 @@ templates:
   facebook.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: facebook
 
     ## Guardrails (read → act → write)
@@ -574,8 +574,8 @@ templates:
   x.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: x
 
     ## Guardrails (read → act → write)
@@ -609,8 +609,8 @@ templates:
   linkedin.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: linkedin
 
     ## Guardrails (read → act → write)
@@ -856,6 +856,9 @@ files:
   - path: shared-context/priorities.md
     template: sharedContext.priorities
     mode: createOnly
+  - path: shared-context/MEMORY_PLAN.md
+    template: sharedContext.memoryPlan
+    mode: createOnly
   - path: shared-context/agent-outputs/README.md
     template: sharedContext.agentOutputsReadme
     mode: createOnly

package/recipes/default/workflow-runner-addon.md

@@ -9,9 +9,9 @@ name: Workflow runner (team add-on)
 cronJobs:
   - id: workflow-runner-loop
     name: "{{teamId}} • workflow runner loop (runs queue)"
-    schedule: "*/15 * * * * *"
+    schedule: "*/5 * * * *"
     agentId: "{{teamId}}-workflow-runner"
-    enabledByDefault: true
+    enabledByDefault: false
     message: |
       [cron] Workflow runner loop (runs queue)
 

package/recipes/default/writing-team.md

@@ -206,8 +206,8 @@ templates:
   outliner.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: outliner
 
     ## Guardrails (read → act → write)
@@ -236,8 +236,8 @@ templates:
   writer.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: writer
 
     ## Guardrails (read → act → write)
@@ -266,8 +266,8 @@ templates:
   editor.agents: |
     # AGENTS.md
 
-    Team: {teamId}
-    Shared workspace: {teamDir}
+    Team: {{teamId}}
+    Shared workspace: {{teamDir}}
     Role: editor
 
     ## Guardrails (read → act → write)
@@ -377,6 +377,9 @@ files:
   - path: shared-context/priorities.md
     template: sharedContext.priorities
     mode: createOnly
+  - path: shared-context/MEMORY_PLAN.md
+    template: sharedContext.memoryPlan
+    mode: createOnly
   - path: shared-context/agent-outputs/README.md
     template: sharedContext.agentOutputsReadme
     mode: createOnly

package/src/handlers/cron.ts

@@ -19,7 +19,7 @@ function interpolateTemplate(input: string | undefined, vars: Record<string, str
 
 function applyCronJobVars(
   scope: CronReconcileScope,
-  j: { id: string; name?: string; schedule?: string; timezone?: string; channel?: string; to?: string; agentId?: string; description?: string; message?: string; enabledByDefault?: boolean },
+  j: { id: string; name?: string; schedule?: string; timezone?: string; channel?: string; to?: string; agentId?: string; description?: string; message?: string; enabledByDefault?: boolean; delivery?: 'none' | 'announce' },
 ): typeof j {
   const vars: Record<string, string> = {
     recipeId: scope.recipeId,
@@ -64,7 +64,7 @@ type CronReconcileScope =
 
 function buildCronJobForCreate(
   scope: CronReconcileScope,
-  j: { id: string; name?: string; schedule?: string; timezone?: string; channel?: string; to?: string; agentId?: string; description?: string; message?: string; enabledByDefault?: boolean },
+  j: { id: string; name?: string; schedule?: string; timezone?: string; channel?: string; to?: string; agentId?: string; description?: string; message?: string; enabledByDefault?: boolean; delivery?: 'none' | 'announce' },
   wantEnabled: boolean
 ): Record<string, unknown> {
   const name =
@@ -91,21 +91,23 @@ function buildCronJobForCreate(
     sessionTarget,
     schedule: { kind: "cron", expr: j.schedule, ...(j.timezone ? { tz: j.timezone } : {}) },
     payload: effectiveAgentId ? { kind: "agentTurn", message: j.message } : { kind: "systemEvent", text: j.message },
-    ...(j.channel || j.to
-      ? {
-          delivery: {
-            mode: "announce",
-            ...(j.channel ? { channel: j.channel } : {}),
-            ...(j.to ? { to: j.to } : {}),
-            bestEffort: true,
-          },
-        }
-      : {}),
+    ...(j.delivery === 'none'
+      ? { delivery: { mode: "none" } }
+      : j.channel || j.to
+        ? {
+            delivery: {
+              mode: "announce",
+              ...(j.channel ? { channel: j.channel } : {}),
+              ...(j.to ? { to: j.to } : {}),
+              bestEffort: true,
+            },
+          }
+        : {}),
   };
 }
 
 function buildCronJobPatch(
-  j: { name?: string; schedule?: string; timezone?: string; channel?: string; to?: string; agentId?: string; description?: string; message?: string },
+  j: { name?: string; schedule?: string; timezone?: string; channel?: string; to?: string; agentId?: string; description?: string; message?: string; delivery?: 'none' | 'announce' },
   name: string
 ): CronJobPatch {
   const effectiveAgentId = typeof j.agentId === "string" && j.agentId.trim() ? j.agentId.trim() : undefined;
@@ -119,7 +121,9 @@ function buildCronJobPatch(
     schedule: { kind: "cron", expr: j.schedule, ...(j.timezone ? { tz: j.timezone } : {}) },
     payload: effectiveAgentId ? { kind: "agentTurn", message: j.message } : { kind: "systemEvent", text: j.message },
   };
-  if (j.channel || j.to) {
+  if (j.delivery === 'none') {
+    patch.delivery = { mode: "none" };
+  } else if (j.channel || j.to) {
     patch.delivery = {
       mode: "announce",
       ...(j.channel ? { channel: j.channel } : {}),
@@ -229,11 +233,16 @@ async function cronAdd(api: OpenClawPluginApi, job: Record<string, unknown>): Pr
 
   // delivery
   const delivery = j.delivery;
-  if (delivery && typeof delivery === "object" && String(delivery.mode ?? "") === "announce") {
-    argv.push("--announce");
-    if (delivery.channel) argv.push("--channel", String(delivery.channel));
-    if (delivery.to) argv.push("--to", String(delivery.to));
-    if (delivery.bestEffort) argv.push("--best-effort-deliver");
+  if (delivery && typeof delivery === "object") {
+    const deliveryMode = String(delivery.mode ?? "");
+    if (deliveryMode === "announce") {
+      argv.push("--announce");
+      if (delivery.channel) argv.push("--channel", String(delivery.channel));
+      if (delivery.to) argv.push("--to", String(delivery.to));
+      if (delivery.bestEffort) argv.push("--best-effort-deliver");
+    } else if (deliveryMode === "none") {
+      argv.push("--no-deliver");
+    }
   }
 
   const result = await api.runtime.system.runCommandWithTimeout(argv, { timeoutMs: 30_000 });