pi-framework
A Pi package for canonical Gherkin specs, non-negotiable TDD, spec synchronization, AI harness readiness, and senior-quality software delivery.
Package details
Install pi-framework from npm and Pi will load the resources declared by the package manifest.
$ pi install npm:pi-framework- Package
pi-framework- Version
0.1.0- Published
- Jun 5, 2026
- Downloads
- not available
- Author
- alereyleyva
- License
- MIT
- Types
- skill, prompt
- Size
- 60.8 KB
- Dependencies
- 0 dependencies · 0 peers
Pi manifest JSON
{
"skills": [
"./skills"
],
"prompts": [
"./prompts"
]
}Security note
Pi packages can execute code and influence agent behavior. Review the source before installing third-party packages.
README
Pi Framework
A Pi package for software delivery where canonical Gherkin specs are the source of truth, tests are executable truth, production code is replaceable, and engineering quality is non-negotiable.
Core thesis
Specs are durable. Tests are executable truth. Code is disposable.
The framework is designed around:
- canonical behavior persisted as Gherkin specs;
- non-negotiable TDD for production behavior;
- mandatory synchronization between specs, tests, and code;
- rebuildable modules that can be discarded and recreated from durable project knowledge;
- incremental work with Conventional Commits.
Installation
pi install npm:pi-framework
For project-local installation:
pi install -l npm:pi-framework
Package contents
agents/ # Pi subagent role definitions, when pi-subagents is installed
skills/ # On-demand framework workflows and instructions
prompts/ # Reusable Pi prompt workflows
rules/ # Framework policies and operating rules
templates/ # Project/spec/ADR templates
Usage
Use the readiness workflow to audit a project:
/assess-project
Or load the skill directly:
/skill:project-readiness
When pi-subagents is installed, the package also provides:
pi-framework.project-evaluator
Status
Initial architecture and policy drafting in progress.