{"_id":"@a-canary/pi-director","name":"@a-canary/pi-director","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@a-canary/pi-director","version":"0.1.0","description":"Autonomous project director for pi. Recommends actions (NEXT.md), clarifies intent (CHOICES.md), and executes TDD development (PLAN.md) through specialized subagents.","keywords":["pi-package"],"author":{"name":"a-canary"},"license":"MIT","type":"module","pi":{"skills":["./skills"],"agents":["./agents"],"extensions":["./extensions"]},"scripts":{"test":"vitest run","test:watch":"vitest"},"peerDependencies":{"@a-canary/pi-choose-wisely":"*","@a-canary/pi-upskill":"*","pi-model-router":"*","@mariozechner/pi-coding-agent":"*","@mariozechner/pi-tui":"*","@sinclair/typebox":"*"},"devDependencies":{"vitest":"^3.2.4"},"gitHead":"dbc6d041e06b99336ffa2a00de1b5325537d2714","_id":"@a-canary/pi-director@0.1.0","_nodeVersion":"25.1.0","_npmVersion":"11.6.1","dist":{"integrity":"sha512-XpXNp4nK6ebadenGR6ovwWXkV4z8MIoLseWGPe46AtI5aYk/zyU5JBseuTF9NBZ0E7zi70vGh4Gk2Og9SdW/8w==","shasum":"016b77f01295250bc12569f8d31445d244bb9150","tarball":"https://registry.npmjs.org/@a-canary/pi-director/-/pi-director-0.1.0.tgz","fileCount":31,"unpackedSize":77992,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCEB/AzP0KIwok9gyCKkCSCNerF9R0V2RZOfIEksKK/rgIgbezB3HnjHT9CX+lsvCdotnEdKx63sq1xovSTKPMSwzU="}]},"_npmUser":{"name":"a-canary","email":"aaron.canary@gmail.com"},"directories":{},"maintainers":[{"name":"a-canary","email":"aaron.canary@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/pi-director_0.1.0_1773767692730_0.45445883869493886"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-17T17:14:52.516Z","0.1.0":"2026-03-17T17:14:52.898Z","modified":"2026-03-17T17:14:53.076Z"},"maintainers":[{"name":"a-canary","email":"aaron.canary@gmail.com"}],"description":"Autonomous project director for pi. Recommends actions (NEXT.md), clarifies intent (CHOICES.md), and executes TDD development (PLAN.md) through specialized subagents.","keywords":["pi-package"],"author":{"name":"a-canary"},"license":"MIT","readme":"# pi-director\n\nAutonomous project director for [pi](https://github.com/mariozechner/pi). Three operations, three artifacts:\n\n| Command | Operation | Artifact | Question |\n|---------|-----------|----------|----------|\n| `/next` | Analyze & Recommend | NEXT.md | What's outside scope? |\n| `/choose` | Clarify Intent | CHOICES.md | Why and what? |\n| `/build` | TDD Development | PLAN.md | How to implement? |\n\n## Autonomy Model\n\n- **CHOICES.md** — user-steered intent. Only the user modifies it (via interviews and feedback).\n- **Within CHOICES.md scope** — director acts autonomously. Bugs, gaps, refactors aligned with existing choices need no approval.\n- **Outside CHOICES.md scope** — surfaces in NEXT.md for user review. Scope changes, contradictions, and new concerns require user acceptance before action.\n\n## Priority Ladder\n\nAll work follows: **UX Quality > Security > Scale > Efficiency**. Each level is a release gate. Higher priorities never regress when pursuing lower ones.\n\n## Install\n\n```bash\nnpm install @a-canary/pi-director @a-canary/pi-choose-wisely @a-canary/pi-upskill\n```\n\n## Architecture\n\n```\n┌──────────────────────────────────────────┐\n│              pi-director                 │\n│  ┌───────┐  ┌────────┐  ┌──────┐        │\n│  │ /next │  │/choose │  │/build│        │\n│  └───┬───┘  └───┬────┘  └──┬───┘        │\n│      │          │          │             │\n│  ┌───▼──────────▼──────────▼──────┐      │\n│  │      Subagent Orchestration    │      │\n│  │  scout  planner  builder       │      │\n│  │  reviewer  writer              │      │\n│  └────────────────────────────────┘      │\n│                                          │\n│  ┌─────────────────────────────────┐     │\n│  │  Nightly Extension (cron)       │     │\n│  │  /nightly-status /nightly-run   │     │\n│  └─────────────────────────────────┘     │\n├──────────────────────────────────────────┤\n│  pi-choose-wisely   │   pi-upskill      │\n│  CHOICES.md mgmt    │   corrections     │\n└──────────────────────────────────────────┘\n```\n\n## Package Structure\n\n```\npi-director/\n├── agents/                 # Subagent definitions\n│   ├── director.md         # strategic — orchestration\n│   ├── planner.md          # strategic — architecture\n│   ├── reviewer.md         # tactical — code review\n│   ├── builder.md          # operational — implementation\n│   ├── scout.md            # scout — fast recon\n│   └── writer.md           # operational — documentation\n├── skills/\n│   ├── next/               # /next — analysis engine\n│   │   ├── SKILL.md\n│   │   └── lib/            # scanner modules + ranker\n│   ├── build/              # /build — TDD phase loop\n│   │   ├── SKILL.md\n│   │   └── lib/            # phase-loop, hard-stops, regression-check\n│   └── choose/             # /choose — wraps pi-choose-wisely\n│       ├── SKILL.md\n│       └── lib/            # pipeline documentation\n├── extensions/\n│   └── nightly-analysis.ts # scheduled /next execution\n├── templates/\n│   └── NEXT.md             # recommendation output format\n├── CHOICES.md              # project intent\n├── PLAN.md                 # implementation phases\n└── package.json\n```\n\n## Commands\n\n| Command | Description |\n|---------|-------------|\n| `/next` | Analyze project data, generate recommendations |\n| `/choose` | Clarify project intent (wraps pi-choose-wisely) |\n| `/build` | Execute PLAN.md phases via TDD loop |\n| `/nightly-status` | Show analysis schedule and last run |\n| `/nightly-run` | Trigger analysis immediately |\n| `/nightly-set <hour>` | Set daily analysis hour (0-23) |\n\n## Dependencies\n\n- `@a-canary/pi-choose-wisely` — CHOICES.md management, replan\n- `@a-canary/pi-upskill` — Correction analysis, session learning\n- `@mariozechner/pi-coding-agent` — Pi runtime\n","readmeFilename":"README.md","_rev":"1-988895639ba37849a6c5bc29064c48ac"}