pi-project-gate

Project orchestration gate for AI agents — structured issues, WIP limits, dependency blocking, and auto-generated release notes.

Packages

Package details

extension

Install pi-project-gate from npm and Pi will load the resources declared by the package manifest.

npm repo home report

$ pi install npm:pi-project-gate

Package: pi-project-gate
Version: 1.1.0
Published: May 14, 2026
Downloads: not available
Author: nandal
License: MIT
Types: extension
Size: 28.7 KB
Dependencies: 0 dependencies · 2 peers

Pi manifest JSON

{
  "extensions": [
    "./src/index.ts"
  ]
}

Security note

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

README

Project Gate for Pi

Project orchestration gate for AI agents — structured issues, WIP limits, dependency blocking, and auto-generated release notes. Agents work from issues, not vibes.

Philosophy

pi-contrib-gate handles the contribution side (branch → commit → PR).
pi-review-gate handles the review side (check → approve → merge).
pi-project-gate handles the project side (issue → plan → release).

Install

pi install npm:pi-project-gate

Tools

Tool	What it does
`project_check(issue_id)`	Validate issue readiness — template, complexity, dependencies
`project_start(issue_id)`	Start work on an issue — checks WIP, dependencies, template
`project_status()`	Project board — active issues, WIP counts, blockers
`project_release_notes(from, to)`	Generate release notes from conventional commits

Gates

Gate	Config	Description
Issue template	`requiredSections`	Block work start if issue is missing required sections
WIP limit	`maxWip`	Max concurrent open PRs per agent (default: 3)
Dependency blocking	`dependencyPattern`	Prevent starting issues with unresolved dependencies
Complexity tracking	`complexityLevels`	Ensure issues are scoped with complexity labels
Release notes	`releaseNoteGroups`	Auto-generate grouped release notes from conventional commits

Configuration

Create .projectrc.yml:

# Max open PRs per agent
maxWip: 3

# Required sections in issue body (comma-separated)
requiredSections: "## Problem,## Proposed Solution,## Acceptance Criteria"

# Complexity levels
complexityLevels: trivial,small,medium,large,epic

# Area labels for categorization
areas: backend,frontend,infra,docs,tooling

# Grouping order for release notes
releaseNoteGroups: feat,fix,perf,refactor,chore,docs,test,ci,build

# Include commit hashes in release notes
releaseNoteIncludeHashes: false

# Regex pattern for issue dependencies
dependencyPattern: "(?:Depends on|Blocked by|Requires)\\s+#(\\d+)"

Workflow

project_check(#42)               ← validate issue readiness
  │
  ▼
project_start(#42)               ← start work (WIP + deps checked)
  │
  ▼
contrib_start_work(#42)          ← create branch
  │
  ▼
[implement]
  │
  ▼
contrib_propose(...)             ← validate + commit
  │
  ▼
contrib_submit(...)              ← push + create PR
  │
  ▼
[CI + review gates pass]
  │
  ▼
MERGED → project_status()        ← WIP freed, blockers resolved

Release Notes

# Generate notes from last tag to HEAD
project_release_notes()

# Generate notes between two tags
project_release_notes(from="v1.0.0", to="v1.1.0")

Example output:

# Release v1.1.0 (2026-05-14)

### 🚀 Features
- **auth**: add OAuth2 support
- **api**: new user endpoint

### 🐛 Bug Fixes
- fix null pointer in login flow
- fix race condition in task queue

### 🔧 Chores
- update dependencies

Integration

Install all three gates for full agent governance:

pi install npm:pi-contrib-gate
pi install npm:pi-review-gate
pi install npm:pi-project-gate