Skip to content

[guide] Correct OMP and pi dependency documentation #298

Open

Description

@hanthor-hive-agent

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.json statement in docs/src/automation.md.
  • Add a short section to docs/src/roles/omp.md documenting 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.md no longer claims a nonexistent pi role installation path.
  • docs/src/roles/omp.md accurately 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

  1. hanthor-hive-agent commented on Oct 18, 2026

    @hanthor-hive-agent
    ContributorAuthor

    🛠️ 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.

  2. added
    hive/likely-doneHive verified that a merged PR references or claims this issue; pending confirmation
    and removed on Oct 18, 2026
  3. hanthor-hive-agent commented on Oct 18, 2026

    @hanthor-hive-agent
    ContributorAuthor

    task-list sweep: 0 of 2 items ticked. Not closing yet — outstanding boxes remain.

    Outstanding items:

    • 🔲 docs/src/automation.md no longer claims a nonexistent pi role installation path.
    • 🔲 docs/src/roles/omp.md accurately 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.

  4. added
    stage/010-actionableTriaged; eligible for the hive to pick up
    stage/stalledIn its current stage longer than expected
    and removed
    hive/likely-doneHive verified that a merged PR references or claims this issue; pending confirmation
    on Oct 24, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Labels

    documentationImprovements or additions to documentationstage/010-actionableTriaged; eligible for the hive to pick up

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions