@yishan-io/pi-dev-flow
Pi skills for design discussion, planning, debugging, testing, code review, subagent work, and Excalidraw editing.
Package details
Install @yishan-io/pi-dev-flow from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:@yishan-io/pi-dev-flow- Package
@yishan-io/pi-dev-flow- Version
0.2.4- Published
- Nov 15, 2026
- Downloads
- 473/mo · 229/wk
- Author
- zhex
- License
- MIT
- Types
- skill
- Size
- 37.5 KB
- Dependencies
- 0 dependencies · 0 peers
Pi manifest JSON
{
"skills": [
"./skills"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
@yishan-io/pi-dev-flow
Pi skills for design discussion, planning, debugging, testing, code review, subagent work, and Excalidraw editing.
Default Workflow
Inspect the relevant code, make the scoped change, and run focused verification. Skills are methods to use when needed, not stages to run in sequence. Multiple steps or files alone do not require a formal plan, tracked task, or subagents.
The hard rules (align before editing, heartbeat every 10 tool calls, scope gate, stop rule, closing diff check, closing report, and the Task record moments) live in one place: the "Working agreement" section of apps/cli/internal/agent/setup/assets/pi-agent/APPEND_SYSTEM.md. The skills below add method-specific limits and refer to those rules. Edit the rules there, not in each skill.
Concrete limits used by the skills:
- Debugging: stop after 3 tested hypotheses, 20 tool calls, or 3 identical failures.
- Delegation: every handoff has Goal, Done when, Out of scope, Files, Stop rule, and Report format. The coordinating agent checks
git diff --statafter every return. Dispatch the same scope at most twice. - Review: at most 2 independent rounds per change. The reviewer lists UNPLANNED files.
- Plans: a plan with a
NEEDS APPROVALdecision, an architecture or data-format change, or a migration waits for the user.
Skills
| Skill | When to use it |
|---|---|
brainstorm |
Resolve unclear goals or meaningful design choices. |
writing-plans |
Plan architecture choices, complex dependencies, migrations, or a user-requested plan. |
systematic-debugging |
Investigate failures whose causes are unclear. |
test-driven-development |
Guide testable behavior changes with a failing test. |
code-review |
Review substantial changes and evaluate review feedback. |
subagent-driven-development |
Delegate useful independent scopes, including safe parallel work. |
editing-whiteboards |
Create or edit Excalidraw scenes. |
Skill Consolidation
code-review replaces requesting-code-review and receiving-code-review. Parallel delegation guidance now lives in subagent-driven-development instead of dispatching-parallel-agents.
Update saved prompts or explicit /skill: commands that use the retired names. The package skill directory is discovered automatically.
The managed default instructions live in apps/cli/internal/agent/setup/assets/pi-agent/APPEND_SYSTEM.md. Local Task guidance lives in packages/pi-task/skills/. These sources use the same lightweight defaults.
Source edits do not automatically update an installed package or an existing session. Update the installed package and managed instructions through the normal setup flow, then reload skills or start a new session as appropriate.