Pi Subagents Guide

This guide describes the Pi-native /posttrain workflow for the NanoChat post-training project. It is separate from the pre-training /autolab flow.

Checked-In Pi Assets

• .pi/settings.json Project Pi settings. It declares pi-subagents and keeps Pi session files under .runtime/.
• .pi/APPEND_SYSTEM.md Parent-session coordinator guidance appended to Pi's default prompt.
• .pi/agents/ Project agents: planner, reviewer, researcher, reporter, memory-keeper, and experiment-worker.
• .pi/prompts/posttrain.md The reusable /posttrain parent-session kickoff prompt.
• scripts/print_pi_kickoff.py Prints a copy-paste parent-session prompt.

Setup

Install Pi once if it is not already available:

npm install -g @mariozechner/pi-coding-agent

From the post-training project root, start Pi:

cd /Users/ben/code/multiautoresearch/post-training
pi

The project .pi/settings.json declares npm:pi-subagents@0.22.0. Pi should install missing project packages on startup. If needed:

pi install npm:pi-subagents@0.22.0 -l

For managed Hugging Face Jobs runs:

hf auth whoami