diff --git a/.opencode/agent/feature-planner-agent.md b/.opencode/agent/feature-planner-agent.md new file mode 100644 index 0000000..93af048 --- /dev/null +++ b/.opencode/agent/feature-planner-agent.md @@ -0,0 +1,82 @@ +--- +id: feature-planner-agent +name: Feature Planner Agent +description: Analyzes feature requests, breaks them down into structured tickets with acceptance criteria and implementation plans, and creates them in the worklane backlog after user confirmation +category: planning +type: standard +version: 1.0.0 +author: opencode +mode: primary +temperature: 0.1 +tools: + bash: true + read: true + glob: true + grep: true +permissions: + bash: + "sudo *": "deny" + skill: + "worklane_kanban": "allow" +--- + +# Feature Planner Agent + +You break down feature requests into manageable, well-structured tickets and create them in the worklane backlog. + +## Process + +### 1. Understand the request + +Read the user's feature request carefully. If the user hasn't provided enough detail, ask clarifying questions before proceeding. + +### 2. Explore the codebase + +Familiarize yourself with the project structure. Understand the relevant files, existing patterns, and conventions. Look at: +- Project structure (top-level files and directories) +- Existing code patterns in relevant areas +- Configuration files (package.json, Cargo.toml, etc.) +- `AGENTS.md` if present for project-specific conventions + +### 3. Break down the feature + +Decompose the feature into logical, incremental tickets. Each ticket should: + +- **Be self-contained**: implementable and testable on its own +- **Have clear acceptance criteria**: measurable conditions that define "done" +- **Have a practical implementation plan**: actionable steps +- **Depend logically on previous tickets**: order them so they build on each other +- **Be appropriately scoped**: not too large (hard to review) nor too small (too much overhead) + +A good breakdown typically produces 3-8 tickets depending on complexity. + +### 4. Present the plan to the user + +Show the full plan with all tickets and their details. Use this format: + +```markdown +## Feature: + +### Ticket 1: +**Description**: <what this ticket covers> +**Acceptance Criteria**: +- <criterium 1> +- <criterium 2> +**Implementation Plan**: +1. <step 1> +2. <step 2> +**Tags**: <tag1, tag2> + +### Ticket 2: <title> +... +``` + +Then **ask the user explicitly** to confirm or request changes. Do NOT proceed without confirmation. + +### 5. Create tickets on confirmation + +Once the user confirms, create each ticket using `worklane_add` with: +- `owner` set to `"planning agent"` +- All fields populated from the plan above + +Do NOT use bash to call `worklane add` — use the `worklane_add` tool directly. diff --git a/.opencode/tools/worklane.ts b/.opencode/tools/worklane.ts index c96a651..67840d8 100644 --- a/.opencode/tools/worklane.ts +++ b/.opencode/tools/worklane.ts @@ -10,10 +10,9 @@ export const init = tool({ "Initialize worklane in the current project. Creates the .worklane/ directory with backlog, committed, reviewing, and done subdirectories.", args: {}, async execute(_args: Record<string, any>, context: ToolContext) { + const workdir = resolveWorklaneDir(context); try { - const result = await Bun.$`worklane init` - .cwd(resolveWorklaneDir(context)) - .text(); + const result = await Bun.$`worklane init`.cwd(workdir).text(); return result.trim(); } catch (err: any) { return `Error initializing worklane: ${err.message}`; @@ -23,21 +22,34 @@ export const init = tool({ export const add = tool({ description: - "Add a new ticket to the worklane backlog. Supports title, description, acceptance criteria, implementation plan, tags, due date, and owner.", + "Add a new ticket to the worklane backlog. Requires a title. Description, acceptance criteria, and plan each support multiple lines (one item per line). Tags are comma-separated.", args: { - title: tool.schema.string().describe("Ticket title (required)"), - description: tool.schema.string().describe("Multiline ticket description"), + title: tool.schema + .string() + .describe("Ticket title (required)"), + description: tool.schema + .string() + .describe("Description text. Use newlines between paragraphs."), acceptance: tool.schema .string() - .describe("Acceptance criteria one per line"), + .describe("Acceptance criteria, one per line. Put each criterium on its own line."), plan: tool.schema .string() - .describe("Implementation plan with one step per line"), - tags: tool.schema.string().describe("Tags as comma-separated list"), - due: tool.schema.string().describe("Due date in YYYY-MM-DD format"), - owner: tool.schema.string().describe("Owner name"), + .describe("Implementation plan steps, one per line. Put each step on its own line."), + tags: tool.schema + .string() + .describe("Comma-separated tags, e.g. 'bug,frontend,urgent'"), + due: tool.schema + .string() + .describe("Due date in YYYY-MM-DD format"), + owner: tool.schema + .string() + .describe("Ticket owner name. If omitted, defaults to the git user."), }, async execute(args: Record<string, any>, context: ToolContext) { + if (!args.title) { + return "Error adding ticket: title is required"; + } const cmd: (string | number)[] = ["add", "--title", args.title]; if (args.description) { args.description @@ -69,15 +81,24 @@ export const add = tool({ const workdir = resolveWorklaneDir(context); try { - const proc = Bun.spawn(["worklane", ...cmd], { cwd: workdir }); - const { exitCode, stdout, stderr } = await proc.exited; + const proc = Bun.spawn(["worklane", ...cmd], { + cwd: workdir, + stdout: "pipe", + stderr: "pipe", + }); + const [stdout, stderr, exitCode] = await Promise.all([ + new Response(proc.stdout).text(), + new Response(proc.stderr).text(), + proc.exited, + ]); if (exitCode !== 0) { - const stderrStr = new TextDecoder().decode(stderr); - throw new Error(stderrStr.trim() || `Exit code ${exitCode}`); + throw new Error( + stderr.trim() || `Exit code ${exitCode}, stderr: ${stderr}`, + ); } - return new TextDecoder().decode(stdout).trim(); + return stdout; } catch (err: any) { - return `Error adding ticket: ${err.message}`; + return `Error adding ticket: ${err.message}, cmd: ${cmd}`; } }, }); @@ -115,9 +136,12 @@ export const show = tool({ args: { id: tool.schema .string() - .describe("Ticket UUID (8+ chars) or title substring"), + .describe("Ticket UUID (8+ chars) or title substring (required)"), }, async execute(args: Record<string, any>, context: ToolContext) { + if (!args.id) { + return "Error showing ticket: id is required"; + } const workdir = resolveWorklaneDir(context); try { const result = await Bun.$`worklane show ${args.id}`.cwd(workdir).text(); @@ -134,16 +158,22 @@ export const mv = tool({ args: { ticket: tool.schema .string() - .describe("Ticket UUID (8+ chars) or title substring"), + .describe("Ticket UUID (8+ chars) or title substring (required)"), status: tool.schema .enum(["backlog", "committed", "reviewing", "done"]) - .describe("Target status"), + .describe("Target status (required)"), force: tool.schema .boolean() - .describe("Force move (allows non-sequential moves like done -> backlog)") + .describe("Force move (allows non-sequential moves like done -> backlog). Use with caution.") .optional(), }, async execute(args: Record<string, any>, context: ToolContext) { + if (!args.ticket) { + return "Error moving ticket: ticket is required"; + } + if (!args.status) { + return "Error moving ticket: status is required. Must be one of: backlog, committed, reviewing, done"; + } const cmd: (string | number)[] = [ "mv", args.ticket, @@ -155,12 +185,15 @@ export const mv = tool({ const workdir = resolveWorklaneDir(context); try { const proc = Bun.spawn(["worklane", ...cmd], { cwd: workdir }); - const { exitCode, stdout, stderr } = await proc.exited; + const [stdout, stderr, exitCode] = await Promise.all([ + new Response(proc.stdout).text(), + new Response(proc.stderr).text(), + proc.exited, + ]); if (exitCode !== 0) { - const stderrStr = new TextDecoder().decode(stderr); - throw new Error(stderrStr.trim() || `Exit code ${exitCode}`); + throw new Error(stderr.trim() || `Exit code ${exitCode}`); } - return new TextDecoder().decode(stdout).trim(); + return stdout.trim(); } catch (err: any) { return `Error moving ticket: ${err.message}`; } @@ -168,27 +201,42 @@ export const mv = tool({ }); export const comment = tool({ - description: "Add a comment to an existing ticket.", + description: "Add a comment to an existing ticket. The comment body supports markdown and newlines. Use it to add review feedback, notes, or status updates.", args: { ticket: tool.schema .string() - .describe("Ticket UUID (8+ chars) or title substring"), - body: tool.schema.string().describe("Comment body (required)"), - owner: tool.schema.string().describe("Comment author").optional(), + .describe("Ticket UUID (8+ chars) or title substring (required)"), + body: tool.schema + .string() + .describe("Comment body text (required). Supports markdown formatting and multiple paragraphs separated by newlines."), + owner: tool.schema + .string() + .describe("Comment author. If omitted, defaults to the git user.") + .optional(), }, async execute(args: Record<string, any>, context: ToolContext) { + if (!args.ticket) { + return "Error adding comment: ticket is required"; + } + if (!args.body) { + return "Error adding comment: body is required"; + } + const cmd: (string | number)[] = ["comment", args.ticket, args.body]; if (args.owner) cmd.push("--owner", args.owner); const workdir = resolveWorklaneDir(context); try { const proc = Bun.spawn(["worklane", ...cmd], { cwd: workdir }); - const { exitCode, stdout, stderr } = await proc.exited; + const [stdout, stderr, exitCode] = await Promise.all([ + new Response(proc.stdout).text(), + new Response(proc.stderr).text(), + proc.exited, + ]); if (exitCode !== 0) { - const stderrStr = new TextDecoder().decode(stderr); - throw new Error(stderrStr.trim() || `Exit code ${exitCode}`); + throw new Error(stderr.trim() || `Exit code ${exitCode}`); } - return new TextDecoder().decode(stdout).trim(); + return stdout.trim(); } catch (err: any) { return `Error adding comment: ${err.message}`; } diff --git a/src/command.rs b/src/command.rs index d0f50e2..585cfa5 100644 --- a/src/command.rs +++ b/src/command.rs @@ -19,15 +19,15 @@ pub enum Command { #[arg(short, long)] title: String, - /// Ticket description + /// Ticket description. Use multiple flags to create multiline descriptions. #[arg(short, long)] description: Vec<String>, - /// Acceptance criteria (comma-separated) + /// Acceptance criteria. Accepts multiple flags, each will be interpreted as a single criterium #[arg(short, long)] acceptance: Vec<String>, - /// Implementation plan (comma-separated steps) + /// Implementation plan. Accepts multiple flags, each will be interpreted as a single step #[arg(short, long)] plan: Vec<String>,