Three critical gaps break the Pi harness experience:
-
Module installer not Pi-aware: .opencode/modules/install.mjs only copies to .opencode/ paths. Pi reads from .agents/ directly via ocgs-core extension. Pi users get nothing from module installation.
-
pi.json phantom reference: README.md and AGENTS.md reference pi.json as Pi's config file. This file doesn't exist. Actual Pi config is .pi/settings.json.
-
ocgs-drift-detector REQUIRED_SECTIONS bug: Checks agents for ["name", "description"] by searching for **name**, ## name markdown patterns. But agent files have these as YAML frontmatter fields (name: creative-director), NOT markdown headings. Produces false positives on every agent file.
Tasks
Affected Files
.opencode/modules/install.mjs
README.md
AGENTS.md
.pi/extensions/ocgs-drift-detector/index.ts
Identified during comprehensive framework review on 2026-07-21
Three critical gaps break the Pi harness experience:
Module installer not Pi-aware:
.opencode/modules/install.mjsonly copies to.opencode/paths. Pi reads from.agents/directly viaocgs-coreextension. Pi users get nothing from module installation.pi.jsonphantom reference:README.mdandAGENTS.mdreferencepi.jsonas Pi's config file. This file doesn't exist. Actual Pi config is.pi/settings.json.ocgs-drift-detectorREQUIRED_SECTIONS bug: Checks agents for["name", "description"]by searching for**name**,## namemarkdown patterns. But agent files have these as YAML frontmatter fields (name: creative-director), NOT markdown headings. Produces false positives on every agent file.Tasks
--piflag toinstall.mjsthat targets.agents/instead of.opencode/, or make.agents/the default targetpi.jsonwith appropriate content or remove all references to it in README.md and AGENTS.mdocgs-drift-detectorREQUIRED_SECTIONS to parse YAML frontmatter instead of searching for markdown headingsinstalled.jsonlocation mismatch (canonical at.agents/modules/but script writes to.opencode/modules/)Affected Files
.opencode/modules/install.mjsREADME.mdAGENTS.md.pi/extensions/ocgs-drift-detector/index.tsIdentified during comprehensive framework review on 2026-07-21