Repository navigation
Description
Documentation Gap
docs/src/automation.md says the pi role runs npm install from roles/pi/files/package.json on every machine. The repository has no roles/pi task entrypoint or playbook task that installs that manifest. roles/omp/tasks/main.yml copies roles/pi/files/skills/ into the OMP skill directory and installs the Kiro provider separately; repository-wide search found no npm install or npm ci use of roles/pi/files/package.json.
The OMP role page describes skill deployment but does not explain the relationship between roles/pi/files/skills/ and the Renovate/CI-managed package manifest, leaving contributors with an incorrect runtime model.
Recommendation
Update one documentation cluster:
- Correct the
roles/pi/files/package.jsonstatement indocs/src/automation.md. - Add a short section to
docs/src/roles/omp.mddocumenting that the playbook copies the personal skills tree and separately installs OMP plugins, while the package manifest is tracked by repository automation rather than installed by the playbook.
Completion criteria:
-
docs/src/automation.mdno longer claims a nonexistentpirole installation path. -
docs/src/roles/omp.mdaccurately describes skill deployment and package-manifest ownership.
Evidence checked on master at 52c32732ae82953628b6be67fb057bc53b01eb00: roles/omp/tasks/main.yml, roles/pi/files/package.json, .github/workflows/ci.yml, .github/CODEOWNERS, docs/src/roles/omp.md, and repository-wide references to the manifest. Supplied held dotfiles PRs #278, #285, #295, and #297 do not touch either target documentation file.
Filed by guide agent (ACMM L5 — hold-gated mode)
— hive: agent=guide backend=omp model=openai-codex/gpt-5.6-luna:max omp=18.11.0
Activity
hanthor-hive-agent commentedon Oct 18, 2026
🛠️ Hive agent
guide(hive hive-slim-hare) started work on this issue at 2026-10-18T04:43:02Z. A pull request referencing this issue supersedes this mark; it lapses on its own at 2026-10-18T06:43:02Z if none appears.hanthor-hive-agent commentedon Oct 18, 2026
task-list sweep: 0 of 2 items ticked. Not closing yet — outstanding boxes remain.
Outstanding items:
docs/src/automation.mdno longer claims a nonexistentpirole installation path.docs/src/roles/omp.mdaccurately describes skill deployment and package-manifest ownership.Merged PRs referencing this issue so far:
This comment is edited in place by the task-list sweep on every cycle; it is not duplicated.