@staff0rd/assist 0.134.0 → 0.135.0

package/README.md

@@ -36,6 +36,7 @@ After installation, the `assist` command will be available globally. You can als
 - `/comment` - Add pending review comments to the current PR
 - `/commit` - Commit only relevant files from the session
 - `/devlog` - Generate devlog entry for the next unversioned day
+- `/draft` - Draft a new backlog item with LLM-assisted questioning
 - `/next-backlog-item` - Pick and implement the next backlog item
 - `/pr` - Raise a PR with a concise description
 - `/refactor` - Run refactoring checks for code quality
@@ -78,9 +79,14 @@ After installation, the `assist` command will be available globally. You can als
 - `assist backlog init` - Create an empty assist.backlog.yml
 - `assist backlog list [--status <type>] [-v]` - List all backlog items with status icons
 - `assist backlog add` - Add a new backlog item interactively (prompts for type: story/bug)
+- `assist backlog add --json` - Add a backlog item from JSON on stdin (used by `/draft`)
+- `assist backlog next` - Pick and run the next backlog item, or open `/draft` if none remain
 - `assist backlog start <id>` - Set a backlog item to in-progress
 - `assist backlog done <id>` - Set a backlog item to done
 - `assist backlog delete <id>` - Delete a backlog item
+- `assist backlog plan <id>` - Display the phased plan for a backlog item
+- `assist backlog phase-done <id> <phase>` - Signal that a plan phase is complete (used by orchestrator)
+- `assist backlog run <id>` - Run a backlog item's plan phase-by-phase with Claude
 - `assist backlog web [-p, --port <number>]` - Start a web view of the backlog (default port 3000)
 - `assist roam auth` - Authenticate with Roam via OAuth (opens browser, saves tokens to ~/.assist.yml)
 - `assist roam show-claude-code-icon` - Forward Claude Code hook activity to Roam local API

package/claude/commands/draft.md

@@ -0,0 +1,71 @@
+---
+description: Draft a new backlog item with LLM-assisted questioning
+allowed_args: "[rough description of what you want to build]"
+---
+
+You are helping the user create a well-structured backlog item with a phased implementation plan.
+
+## Step 1: Understand the idea
+
+If the user provided a description via $ARGUMENTS, use that as a starting point. Otherwise, ask what they want to build.
+
+Read relevant parts of the codebase to understand the current architecture and patterns.
+
+## Step 2: Ask clarifying questions
+
+Ask 2-4 targeted questions conversationally to flesh out the idea. Focus on:
+
+- **Scope**: What exactly should this include? What is out of scope?
+- **Done criteria**: What does "done" look like? How will we know it works?
+- **Constraints**: Are there existing patterns, APIs, or conventions to follow?
+- **Edge cases**: What happens when things go wrong?
+
+Ask one question at a time. Wait for the user's response before asking the next.
+
+## Step 3: Propose the item
+
+Once you have enough context, propose a complete backlog item. Show it to the user in a readable format:
+
+**Name:** (concise title)
+**Type:** story or bug
+**Description:** 1-3 sentences
+**Acceptance Criteria:**
+- (specific, testable criteria)
+
+**Plan:**
+- Phase 1: (name) — tasks...
+- Phase 2: (name) — tasks...
+
+Keep phases small (2-4 tasks each). A typical item should have 2-3 phases.
+
+## Step 4: Iterate
+
+Ask the user if they want to change anything. Iterate until they confirm.
+
+## Step 5: Save
+
+Once confirmed, pipe the JSON to the CLI. The JSON must match this shape:
+
+```json
+{
+  "name": "...",
+  "type": "story",
+  "description": "...",
+  "acceptanceCriteria": ["...", "..."],
+  "plan": [
+    {
+      "name": "Phase name",
+      "tasks": [
+        { "task": "Do something", "verify": "optional verification step" }
+      ]
+    }
+  ]
+}
+```
+
+Run:
+```
+echo '<the confirmed json>' | assist backlog add --json 2>&1
+```
+
+Then show the user the item was created and suggest they can run `assist backlog run <id>` to start implementation.

package/claude/settings.json

@@ -33,6 +33,9 @@
 			"Bash(assist backlog list:*)",
 			"Bash(assist backlog start:*)",
 			"Bash(assist backlog done:*)",
+			"Bash(assist backlog plan:*)",
+			"Bash(assist backlog phase-done:*)",
+			"Bash(assist backlog add:*)",
 			"Bash(assist transcript summarise:*)",
 			"Bash(assist complexity:*)",
 			"Bash(assist transcript format:*)",
@@ -86,6 +89,8 @@
 			"SlashCommand(/inspect)",
 			"Skill(screenshot)",
 			"SlashCommand(/screenshot)",
+			"Skill(draft)",
+			"SlashCommand(/draft)",
 			"WebFetch(domain:staffordwilliams.com)"
 		],
 		"deny": ["Bash(git commit:*)", "Bash(npm run:*)", "Bash(npx assist:*)"]