@gtheys/pi-planning

Pi extension — typed taskwarrior tools for the create-plan and implement-plan skills

Package details

extension

Install @gtheys/pi-planning from npm and Pi will load the resources declared by the package manifest.

$ pi install npm:@gtheys/pi-planning

Pi manifest JSON

{
  "extensions": [
    "./plan-tools/index.ts",
    "./implement-plan/index.ts"
  ]
}

Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.

Pi extension that provides typed taskwarrior tools for the create-plan, iterate-plan, and implement-plan skills.

Replaces raw bash/jq pipelines with validated, structured tool calls.

Entry	Description
`plan-tools/index.ts`	Tools for creating and managing specs and phase tasks
`implement-plan/index.ts`	Tools for driving implementation from a taskwarrior phase/subtask tree

Typed tools for the create-plan and iterate-plan skills.

Tool	Description
`tw_get_ticket`	Fetch Jira ticket details from taskwarrior by Jira ID
`tw_get_spec_task`	Fetch spec task + extract spec file path from annotation
`tw_get_phases`	Fetch all phase tasks (`+phase` tag) for a Jira ticket
`tw_get_impl_tasks`	Fetch all implementation tasks (`+impl` tag) for a Jira ticket
`resolve_spec_path`	Compute canonical spec file path (respects `$LLM_NOTES_ROOT`)
`tw_create_spec_task`	Create spec task in taskwarrior and annotate it with the spec file path
`tw_create_phase`	Create a phase task; returns UUID for use as `depends_uuid`
`tw_create_impl_task`	Create an implementation subtask under a phase

/plan <JIRA-ID>    — create or iterate on an implementation plan

Typed tools for the implement-plan skill, driving work from the taskwarrior phase/subtask tree.

Tool	Description
`tw_execution_plan`	Fetch full sorted phase + subtask tree; returns `currentPhase`/`currentSubtask` resume pointers
`tw_advance_task`	Transition a task to `todo`, `inprogress`, or `done`
`tw_phase_checkpoint`	Mark phase done and return a ready-made git commit message

/implement <JIRA-ID>    — show execution plan and start implementing

Tools are registered automatically and consumed by the bundled skills. See the create-plan and implement-plan skills for workflows.