Files
ai-artifacts/projects/dotfiles/046-pi-subagents-minimal-tracer-bullet-task.md
2026-08-01 14:05:09 -04:00

2.2 KiB

status, claimed-by, claimed-at, completed-at, parent, blocked-by, tags
status claimed-by claimed-at completed-at parent blocked-by tags
resolved 019fba91-eabf-76ae-b086-a37ac061d6e8 2026-08-01T13:40:33-04:00 2026-08-01T13:55:13-04:00 027-pi-subagents-implementation-spec-task
ticket/task/afk

Create the minimal subagent extension tracer bullet

Question

Build a loadable neutral Pi extension that can start one ad hoc independent subagent non-blockingly, track it through the supervisor, and expose basic list, status, and result surfaces for that child.

What to build

Create the narrowest end-to-end path for the subagent extension. A prompt-only spawn should create an ad hoc worker in independent context, return a child id immediately, track lifecycle state through a supervisor, and let the parent inspect status and retrieve the final result later. This slice should establish the extension skeleton, the child runner boundary, the initial status record shape, and the basic tool/command surfaces needed to prove the loop works.

Acceptance criteria

  • /reload loads the extension from the managed Pi extensions directory.
  • A spawn call with only prompt returns a child id immediately.
  • The child runs in independent mode without parent transcript context.
  • Status transitions are visible from accepted through terminal state.
  • Result retrieval returns still-running before completion and the final answer after completion.

Implementation Notes

Use subprocess RPC for the first runner implementation. Keep exact public tool names consistent with the spec, but they may be finalized while coding.

Resolved in branch pi-subagents-tracer-bullet, commit fdf0f89. Implemented a managed subagents extension skeleton with subagent_spawn, subagent_list, subagent_status, subagent_result, and subagent_cancel tool surfaces plus slash-command smoke surfaces. The tracer bullet intentionally records tools: "pi-default" because actual tool-profile enforcement belongs to 048-pi-subagents-config-agents-tool-profiles-task. Verified managed extension loading through a temporary PI_CODING_AGENT_DIR, live Pi RPC spawn/result behavior, extension derivation build, and nix flake check.