feat(templates): centralize workspace templates

docs/AGENTS.default.md

@@ -16,13 +16,21 @@ Clawdis uses a dedicated workspace directory for the agent. Default: `~/.clawdis
 mkdir -p ~/.clawdis/workspace
 ```
 
-2) Copy this template into the workspace as `AGENTS.md` (overwrites any existing file):
+2) Copy the default workspace templates into the workspace:
+
+```bash
+cp docs/templates/AGENTS.md ~/.clawdis/workspace/AGENTS.md
+cp docs/templates/SOUL.md ~/.clawdis/workspace/SOUL.md
+cp docs/templates/TOOLS.md ~/.clawdis/workspace/TOOLS.md
+```
+
+3) Optional: if you want the personal assistant tool roster, replace AGENTS.md with this file:
 
 ```bash
 cp docs/AGENTS.default.md ~/.clawdis/workspace/AGENTS.md
 ```
 
-3) Optional: choose a different workspace by setting `inbound.workspace` (supports `~`):
+4) Optional: choose a different workspace by setting `inbound.workspace` (supports `~`):
 
 ```json5
 {
@@ -37,6 +45,11 @@ cp docs/AGENTS.default.md ~/.clawdis/workspace/AGENTS.md
 - Don’t run destructive commands unless explicitly asked.
 - Don’t send partial/streaming replies to external messaging surfaces (only final replies).
 
+## Daily memory (recommended)
+- Keep a short daily log at `memory/YYYY-MM-DD.md` (create `memory/` if needed).
+- On session start, read today + yesterday if present.
+- Capture durable facts, preferences, and decisions; avoid secrets.
+
 ## Backup tip (recommended)
 If you treat this workspace as Clawd’s “memory”, make it a git repo (ideally private) so `AGENTS.md` and your memory files are backed up.
 

docs/index.md

@@ -116,7 +116,7 @@ Example:
 - Start here:
   - [Configuration](./configuration.md)
   - [Clawd personal assistant setup](./clawd.md)
-  - [AGENTS.md template (default)](./AGENTS.default.md)
+  - [Workspace templates](./templates/AGENTS.md)
   - [Gateway runbook](./gateway.md)
   - [Nodes (iOS/Android)](./nodes.md)
   - [Web surfaces (Control UI)](./web.md)

docs/onboarding.md

@@ -106,6 +106,11 @@ git add AGENTS.md
 git commit -m "Add agent workspace"
 ```
 
+Daily memory lives under `memory/` in the workspace:
+- one file per day: `memory/YYYY-MM-DD.md`
+- read today + yesterday on session start
+- keep it short (durable facts, preferences, decisions; avoid secrets)
+
 ## Remote mode note (why OAuth is hidden)
 
 If the Gateway runs on another machine, the Anthropic OAuth credentials must be created/stored on that host (where Pi runs).

docs/templates/AGENTS.md

@@ -0,0 +1,31 @@
+---
+summary: "Workspace template for AGENTS.md"
+read_when:
+  - Bootstrapping a workspace manually
+---
+# AGENTS.md - Clawdis Workspace
+
+This folder is the assistant's working directory.
+
+## Backup tip (recommended)
+If you treat this workspace as the agent's "memory", make it a git repo (ideally private) so identity
+and notes are backed up.
+
+```bash
+git init
+git add AGENTS.md
+git commit -m "Add agent workspace"
+```
+
+## Safety defaults
+- Don't exfiltrate secrets or private data.
+- Don't run destructive commands unless explicitly asked.
+- Be concise in chat; write longer output to files in this workspace.
+
+## Daily memory (recommended)
+- Keep a short daily log at memory/YYYY-MM-DD.md (create memory/ if needed).
+- On session start, read today + yesterday if present.
+- Capture durable facts, preferences, and decisions; avoid secrets.
+
+## Customize
+- Add your preferred style, rules, and "memory" here.

docs/templates/SOUL.md

@@ -0,0 +1,12 @@
+---
+summary: "Workspace template for SOUL.md"
+read_when:
+  - Bootstrapping a workspace manually
+---
+# SOUL.md - Persona & Boundaries
+
+Describe who the assistant is, tone, and boundaries.
+
+- Keep replies concise and direct.
+- Ask clarifying questions when needed.
+- Never send streaming/partial replies to external messaging surfaces.

docs/templates/TOOLS.md

@@ -0,0 +1,20 @@
+---
+summary: "Workspace template for TOOLS.md"
+read_when:
+  - Bootstrapping a workspace manually
+---
+# TOOLS.md - User Tool Notes (editable)
+
+This file is for your notes about external tools and conventions.
+It does not define which tools exist; Clawdis provides built-in tools internally.
+
+## Examples
+
+### imsg
+- Send an iMessage/SMS: describe who/what, confirm before sending.
+- Prefer short messages; avoid sending secrets.
+
+### sag
+- Text-to-speech: specify voice, target speaker/room, and whether to stream.
+
+Add whatever else you want the assistant to know about your local toolchain.