@questionbase/deskfree 0.3.0-alpha.31 → 0.3.0-alpha.32

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@questionbase/deskfree",
-  "version": "0.3.0-alpha.31",
+  "version": "0.3.0-alpha.32",
   "description": "OpenClaw channel plugin for DeskFree — turns DeskFree into a messaging platform for OpenClaw AI agents",
   "type": "module",
   "main": "dist/index.js",

package/skills/deskfree/SKILL.md

@@ -78,20 +78,15 @@ Proposals are stored as message metadata — **no tasks, files, or initiatives a
 
 Each `deskfree_propose` call handles one initiative (existing or new) or no initiative. Separate calls for separate initiatives.
 
-### Substeps
+### Task Instructions
 
-Substeps are human-reviewable checklist items. The human can toggle each on/off before approving:
+Write instructions as rich markdown — use **bold**, lists, and `inline code`. Do NOT use markdown headers (#); use **bold text** for section labels instead. The human sees these in a rich-text editor and can edit before approving.
 
 ```javascript
 deskfree_propose({
   tasks: [{
     title: "Audit auth endpoints",
-    instructions: "Review all authentication endpoints for security issues...",
-    substeps: [
-      "Review session management",
-      "Check CSRF protection",
-      "Verify rate limiting"
-    ]
+    instructions: "**What to do**\n- Review session management\n- Check CSRF protection\n- Verify rate limiting\n\n**Done when**\nAll endpoints pass security checklist."
   }]
 })
 ```
@@ -212,7 +207,7 @@ Sub-agent:    deskfree_start_task → deskfree_update_file → deskfree_complete
 
 ### Human Gives You Work
 1. `deskfree_state` → check existing tasks + initiatives + files
-2. `deskfree_propose` → with context, substeps, file links, initiative
+2. `deskfree_propose` → with context, instructions (markdown), file links, initiative
 3. Human approves → spawn sub-agent → `deskfree_start_task`
 4. Work → `deskfree_update_file` incrementally
 5. `deskfree_complete_task`

package/skills/deskfree/references/tools.md

@@ -32,27 +32,22 @@ Get full workspace snapshot — all tasks, recently done tasks, active initiativ
 ---
 
 ### `deskfree_propose`
-Suggest tasks for human approval. Creates tasks with `suggested` status. Can also propose new initiatives and pre-create linked files.
+Propose a plan for human approval. Nothing is created until the human reviews and approves in a modal. One initiative per call — make multiple calls for multiple initiatives.
 
 | Parameter | Type | Required | Description |
 |-----------|------|----------|-------------|
-| `suggestions` | array | Yes | Array of task suggestions (1-20) |
-| `suggestions[].title` | string | Yes | Task title — short, action-oriented (max 200 chars) |
-| `suggestions[].instructions` | string | No | Detailed instructions: what to do, why, what done looks like, constraints |
-| `suggestions[].estimatedTokens` | number | No | Estimated token cost for completing this task |
-| `suggestions[].initiativeId` | string | No | Link task to an existing active initiative |
-| `suggestions[].scheduledFor` | string | No | ISO-8601 date for when this task should become available |
-| `suggestions[].fileId` | string | No | Link task to an existing file — bot receives file content when claiming |
-| `suggestions[].newFile` | object | No | Pre-create a new file and link it to this task |
-| `suggestions[].newFile.name` | string | Yes (if newFile) | File name (max 200 chars) |
-| `suggestions[].newFile.description` | string | No | File description |
-| `initiativeSuggestions` | array | No | Propose new initiatives (0-5) |
-| `initiativeSuggestions[].title` | string | Yes | Initiative title (max 200 chars) |
-| `initiativeSuggestions[].content` | string | Yes | Initial initiative content (markdown) |
-| `initiativeSuggestions[].taskRefs` | number[] | No | Indexes into `suggestions[]` to auto-link when approved |
-| `parentTaskId` | string | No | Parent task ID — set when suggesting follow-ups from within a task |
-
-**Returns:** `{ suggestionIds: string[], initiativeSuggestionIds?: string[] }`
+| `initiative` | string \| object | No | Existing initiative ID (e.g. `"INI_123"`) or `{title, content}` to create new |
+| `context` | string | No | Why this plan is being proposed — helps the human understand the reasoning |
+| `tasks` | array | Yes | Array of tasks to propose (1-20) |
+| `tasks[].title` | string | Yes | Task title — short, action-oriented (max 200 chars) |
+| `tasks[].instructions` | string | No | Rich markdown instructions (bold, lists, inline code — no # headers). Include: what to do, steps, what done looks like, constraints. |
+| `tasks[].estimatedTokens` | number | No | Estimated token cost for completing this task |
+| `tasks[].scheduledFor` | string | No | ISO-8601 date for when this task should become available |
+| `tasks[].file` | object | No | `{existingId}` to link existing file, or `{name, description}` to create new on approval |
+
+**Note:** The `substeps` field is deprecated and ignored. Put all steps in the `instructions` field as markdown instead.
+
+**Returns:** Confirmation that proposal was attached to the message.
 
 ---