User stories and planning kits
On this page
Use a focused story for behavior you can try and a planning kit when it fits the project.
Use these tools
- Call the relevant read or status tool first.
- Review the target and required arguments.
- Run one intended action, with explicit human confirmation where required.
- Inspect status or re-read the affected resource afterward.
Inputs below describe the public contract. Your connected server’s current tool list is authoritative. Some tools require a particular host, target, inference mode or plan. Identifiers are values returned by earlier tools; do not invent them.
describe_planning_kits
The planning kits a project can take.
Read the returned resource and use its current values when planning the next action.
| Argument | Required | Type or accepted values |
|---|
| projectId | No | string |
Operation: read-only.
Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.
The machine-readable tool contracts include nested argument schemas.
apply_planning_kit
Write a planning kit into the project.
Read describe_planning_kits first and choose a supported kit and type set. Review the stories written afterward.
| Argument | Required | Type or accepted values |
|---|
| projectId | No | string |
| kit | Yes | string; minLength 1 |
| types | No | array of string |
Operation: can change state or start work.
Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.
The machine-readable tool contracts include nested argument schemas.
list_stories
The user stories of a project.
Read the returned resource and use its current values when planning the next action.
| Argument | Required | Type or accepted values |
|---|
| projectId | No | string |
| page | No | integer; minimum 0; maximum 9007199254740991 |
| size | No | integer; minimum 1; maximum 100 |
| status | No | string |
| area | No | string |
Operation: read-only.
Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.
The machine-readable tool contracts include nested argument schemas.
search_stories
Find a story.
Read the returned resource and use its current values when planning the next action.
| Argument | Required | Type or accepted values |
|---|
| q | Yes | string; minLength 1 |
| projectId | No | string |
Operation: read-only.
Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.
The machine-readable tool contracts include nested argument schemas.
create_story
Add a user story.
Read the returned resource and use its current values when planning the next action.
| Argument | Required | Type or accepted values |
|---|
| story | Yes | string; minLength 1 |
| projectId | No | string |
Operation: can change state or start work.
Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.
The machine-readable tool contracts include nested argument schemas.
update_story
Reword a user story.
Read the returned resource and use its current values when planning the next action.
| Argument | Required | Type or accepted values |
|---|
| storyId | Yes | string |
| story | Yes | string; minLength 1 |
| projectId | No | string |
Operation: can change state or start work.
Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.
The machine-readable tool contracts include nested argument schemas.
delete_story
Remove a user story.
Removes the planning story. Review the card before deletion; removing a story is not a promise to reverse existing application code.
| Argument | Required | Type or accepted values |
|---|
| storyId | Yes | string |
| projectId | No | string |
Operation: can change state or start work; destructive effects are possible.
Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.
The machine-readable tool contracts include nested argument schemas.
develop_story
Implement a user story.
Starts development once for the chosen story. Follow story_status and check the preview result.
| Argument | Required | Type or accepted values |
|---|
| storyId | Yes | string |
| projectId | No | string |
Operation: can change state or start work.
Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.
The machine-readable tool contracts include nested argument schemas.
reset_story
Put a story back to planned.
Changes the story back to planned. Review the current app before starting it again.
| Argument | Required | Type or accepted values |
|---|
| storyId | Yes | string |
| projectId | No | string |
Operation: can change state or start work.
Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.
The machine-readable tool contracts include nested argument schemas.
complete_story
Mark a story as completed.
Updates the planning state. Verify the implemented behavior; this action itself does not implement missing code.
| Argument | Required | Type or accepted values |
|---|
| storyId | Yes | string |
| projectId | No | string |
Operation: can change state or start work.
Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.
The machine-readable tool contracts include nested argument schemas.
story_status
What happened to a story.
Read the returned resource and use its current values when planning the next action.
| Argument | Required | Type or accepted values |
|---|
| storyId | Yes | string |
| projectId | No | string |
Operation: read-only.
Available setups: stdio, cloud project, cloud inference; stdio, cloud project, delegated inference; stdio, local project, cloud inference; stdio, local project, delegated inference; hosted HTTP.
The machine-readable tool contracts include nested argument schemas.