Fix 'add' tool command

This commit is contained in:
2026-08-20 13:20:15 +02:00
committed by Ansho Rei
parent bcb24f1fa6
commit 12f34a3442
3 changed files with 166 additions and 36 deletions
+82
View File
@@ -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: <feature name>
### Ticket 1: <title>
**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.
+81 -33
View File
@@ -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}`;
}