Task Decomposition
Stories describe what to build from the user's perspective. Tasks describe how to build it from the developer's perspective. Decomposition bridges that gap — with AI exploring the actual codebase, not a hypothetical version of it.
The Flow
SDM assigns decomposition
From the story detail view, the SDM assigns a developer to decompose the story. The developer receives a notification (in-app and via Teams if configured).
Developer runs /decompose in their IDE
The assigned developer opens their IDE (Claude Code or Amazon Q) and runs the /decompose skill. The CLI plugin loads the story context from Konductro — description, acceptance criteria, architectural notes, and repository information.
# In Claude Code
/decomposeAI explores the codebase
The AI explores the real codebase on the developer's machine — reading files, understanding existing patterns, tracing dependencies. It breaks the story into scoped technical tasks, one per unit of work.
Tasks submitted back to Konductro
Each task is submitted individually as it is produced. When all tasks are ready, the developer finalises the decomposition. Tasks appear under the story in the backlog, ready for sprint planning.
What a Task Includes
Each decomposed task is scoped to a specific repository and carries:
| Field | Description |
|---|---|
| Title | Concise description of the work |
| Repository | Which repo this task modifies |
| Implementation steps | Ordered steps the developer will follow |
| Files to modify | Specific files to create or change |
| Architectural notes | Relevant decisions from the approved architecture |
| Dependencies | Other tasks that must complete first |
Why Decomposition Runs Locally
Decomposition requires access to the actual codebase — file structures, existing patterns, dependency graphs. This runs on the developer's machine via the CLI plugin, not in Konductro's cloud. The AI reads real code, not abstractions.
CLI Tools Used
| Tool | Purpose |
|---|---|
list_decomposition_tasks | List assigned decomposition tasks |
get_decomposition_context | Load story and repository context |
submit_decomposition_task | Submit a single decomposed task |
complete_decomposition | Finalise after all tasks are submitted |
See the Tools Reference for full details.