feat(pi): implement milestone M5 - package surface

docs/PI.md

@@ -42,6 +42,13 @@ V1 uses one repo-level pi package rather than per-skill packages. The package su
 
 The package metadata and allowlist live at repo root so `pi install -l /absolute/path/to/ai-coding-skills` works without extra wrapping.
 
+Current manifest shape:
+
+- package name: `ai-coding-skills-pi`
+- discovery keyword: `pi-package`
+- `pi.skills`: the five `skills/<family>/pi` directories
+- `files`: allowlisted to pi skill variants, pi docs, pi reviewer runtime helpers, and `scripts/verify-pi-resources.sh`
+
 ## Install Options
 
 ### Local Skill Copy
@@ -61,7 +68,12 @@ pi install -l /absolute/path/to/ai-coding-skills
 pi list
 ```
 
-Package details are finalized by the packaging milestone and verified by `scripts/verify-pi-resources.sh` once that script is added in M5.
+Verify the package surface before packaging or publishing:
+
+```bash
+./scripts/verify-pi-resources.sh
+npm pack --dry-run --json
+```
 
 ## Extension Decision