Skip to content
Documentation menu

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

  1. Call the relevant read or status tool first.
  2. Review the target and required arguments.
  3. Run one intended action, with explicit human confirmation where required.
  4. 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.

MCP home · Recovery workflow · Costs