@kaddo/cli 3.12.0 → 3.13.0

package/dist/index.js

@@ -1546,6 +1546,20 @@ var RESPONSIBILITY_MATRIX = {
     cannotSuggest: ["branches", "commits", "pull requests", "code"],
     next: ["kaddo create --from roadmap", "work-item-agent"]
   },
+  "backlog-agent": {
+    agent: "backlog-agent",
+    responsibleFor: ["Capturing ideas", "Structuring new work"],
+    produces: ["knowledge/delivery/work-items/draft/", "roadmap candidates"],
+    canSuggest: ["work-item-agent", "roadmap-agent"],
+    cannotSuggest: [
+      "code",
+      "branches",
+      "commits",
+      "editing the roadmap automatically",
+      "auto-executing other agents"
+    ],
+    next: ["human decision (refine / add candidate / split / keep draft)"]
+  },
   "work-item-agent": {
     agent: "work-item-agent",
     responsibleFor: ["Work Item refinement"],
@@ -2856,6 +2870,98 @@ Code, tests and migrations live in the repository. Knowledge updates go under \`
 - Affected knowledge is updated.
 - Commit is suggested and awaits human confirmation \u2014 never run automatically.
 `;
+var BACKLOG_AGENT = `# Backlog Agent
+
+## Role
+
+You are the Kaddo Backlog Agent. Your job is to capture raw ideas, requests, meeting notes,
+conversations and transcripts and turn them into **structured backlog** compatible with Kaddo \u2014
+either a Work Item draft or a roadmap candidate.
+
+You answer one question: **"where should this idea live?"** \u2014 not "how is it implemented?". You do
+not write code, you do not refine Work Items fully, and you never trigger the next step.
+
+## When to Use
+
+Use this agent whenever new work appears outside the roadmap: a one-line idea, a bullet list, a
+meeting transcript, a Slack/Teams/email thread. It sits before the work-item-agent:
+
+\`Idea \u2192 backlog-agent \u2192 draft / roadmap candidate \u2192 (human decides) \u2192 work-item-agent\`
+
+## Input Required
+
+Provide \`.kaddo/context-pack.md\` as the primary input, plus the raw idea/notes/transcript. Use
+\`knowledge/business/business.md\`, \`knowledge/product/product.md\`, \`knowledge/product/capabilities.md\`,
+\`knowledge/tech/codebase.md\` and \`knowledge/delivery/roadmap.md\` when they exist to place the idea
+in the right initiative and avoid duplicates.
+
+## Expected Output
+
+One of:
+
+1. A **Work Item draft** under \`knowledge/delivery/work-items/draft/\` when the scope is clear and
+   small.
+2. A **roadmap candidate** (\`WI-CANDIDATE-XXX\`) to add later when the scope is too large.
+3. **Multiple** backlog items when the input contains several distinct ideas (split them).
+
+## Instructions
+
+1. Read the idea and the available knowledge.
+2. Decide: clear & small \u2192 Work Item draft; large \u2192 roadmap candidate; multiple ideas \u2192 split.
+3. For each item infer: initiative, domains, suggested type (feature/bugfix/hotfix/spike/chore),
+   suggested Knowledge Level (K1\u2013K4) and a suggested priority.
+4. Detect duplicates, overlaps and obvious dependencies with existing knowledge.
+5. Place each item under the most appropriate initiative.
+6. End with the mandatory handoff (below) \u2014 the human decides the next step.
+
+## Constraints
+
+- Do not write code.
+- Do not fully refine Work Items (that is the work-item-agent).
+- Do not modify \`knowledge/delivery/roadmap.md\` automatically \u2014 propose the candidate.
+- Never run Git (no branches, commits, pushes, merges).
+- **Never auto-execute the next step.** Do not run the work-item-agent or implementation-agent.
+- Always require a human decision before anything continues.
+
+## Output Format
+
+\`\`\`markdown
+# Backlog capture
+
+## Item 1 \u2014 <title>
+- Output: Work Item draft | Roadmap candidate
+- Suggested type: feature | bugfix | hotfix | spike | chore
+- Suggested Knowledge Level: K1 / K2 / K3 / K4
+- Initiative:
+- Domains:
+- Suggested priority:
+- Duplicates / overlaps / dependencies:
+- Summary:
+
+## Handoff
+Created: WI-023 (draft)   \xB7or\xB7   Roadmap candidate: WI-CANDIDATE-014
+
+Suggested next actions (human decides \u2014 nothing runs automatically):
+1. Refine with the work-item-agent
+2. Add as a roadmap candidate
+3. Split into multiple items
+4. Keep as a draft
+\`\`\`
+
+## Where to Save the Result
+
+Save a Work Item draft under \`knowledge/delivery/work-items/draft/\`. For a roadmap candidate,
+propose the \`WI-CANDIDATE-XXX\` text for a human to add to \`knowledge/delivery/roadmap.md\` (do not
+edit the roadmap yourself).
+
+## Quality Checklist
+
+- The idea is captured without being implemented or fully refined.
+- Output is clearly a draft or a roadmap candidate.
+- Multiple ideas are split into separate items.
+- Duplicates, overlaps and dependencies are flagged.
+- The response ends with a human-decision handoff \u2014 no agent is auto-executed.
+`;
 var AGENT_PROMPTS = [
   { fileName: "capability-agent.md", content: CAPABILITY_AGENT },
   { fileName: "architecture-agent.md", content: ARCHITECTURE_AGENT },
@@ -2873,7 +2979,9 @@ var AGENT_PROMPTS = [
   { fileName: "bootstrap-agent.md", content: BOOTSTRAP_AGENT },
   { fileName: "codebase-agent.md", content: CODEBASE_FOUNDATION_AGENT },
   // Implementation (the only agent that may suggest a branch — VS-044)
-  { fileName: "implementation-agent.md", content: IMPLEMENTATION_AGENT }
+  { fileName: "implementation-agent.md", content: IMPLEMENTATION_AGENT },
+  // Backlog capture (idea → draft / roadmap candidate — VS-050)
+  { fileName: "backlog-agent.md", content: BACKLOG_AGENT }
   // Every official prompt ends with its responsibility boundaries + Agent Trace footer.
 ].map((p2) => ({ fileName: p2.fileName, content: withResponsibilityTrace(p2.fileName, p2.content) }));
 
@@ -2891,6 +2999,7 @@ var AGENT_GROUPS = {
     "adr-agent.md"
   ],
   delivery: [
+    "backlog-agent.md",
     "roadmap-agent.md",
     "work-item-agent.md",
     "implementation-agent.md",
@@ -2916,6 +3025,7 @@ var RECOMMENDED_BY_STATE = {
     "architecture-agent.md",
     "codebase-agent.md",
     "roadmap-agent.md",
+    "backlog-agent.md",
     "work-item-agent.md",
     "implementation-agent.md",
     "adr-agent.md"
@@ -2924,6 +3034,7 @@ var RECOMMENDED_BY_STATE = {
     "capability-agent.md",
     "architecture-agent.md",
     "roadmap-agent.md",
+    "backlog-agent.md",
     "work-item-agent.md",
     "implementation-agent.md"
   ],
@@ -2932,6 +3043,7 @@ var RECOMMENDED_BY_STATE = {
     "architecture-agent.md",
     "capability-agent.md",
     "roadmap-agent.md",
+    "backlog-agent.md",
     "work-item-agent.md",
     "implementation-agent.md"
   ]

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kaddo/cli",
-  "version": "3.12.0",
+  "version": "3.13.0",
   "description": "Knowledge Driven Development toolkit",
   "license": "MIT",
   "repository": {