POM 2 Documentation

Wiki Ownership Table

Properties1
descriptionCanonical ownership of every fact category to prevent drift

2 min read

Wiki Ownership Table

Every duplicated fact has exactly one canonical owner. Mirrors must cite the owner and must not introduce independent variants.

Fact categoryCanonical ownerMirrors (must cite owner)
Runtime contracts, stage machine, evidence rulessrc/state.ts, src/persistence.ts, src/domain.tsdocs/ARCHITECTURE.md, POM.yml, skills/pom/references/workflow.md
Package metadata, file allowlist, scriptspackage.jsonREADME.md, docs/INVENTORY.md, RELEASE.json
Release verification evidencescripts/release-manifest.mjs (evidence files in 00_admin/validation/)RELEASE.json, README.md, docs/AUDIT.md
Operator command mapsrc/command.ts (completions, help text)README.md, POM.yml, skills/pom/references/commands.md
Tool actions, approvals, schemassrc/tools.tsdocs/TOOL_MATRIX.md, POM.yml, skills/pom/references/commands.md
Generated project layoutsrc/persistence.ts:226-239 (bootstrapProject)docs/INVENTORY.md, skills/pom/references/artifacts.md
Prompt precedence and compositionsrc/prompts.ts:83-117 (composePromptStack, renderStagePrompt)POM.yml, README.md, skills/pom/references/workflow.md
Resource discovery advertisementsrc/events.ts:19-24 (resources_discover)skills/pom/references/commands.md, docs/ARCHITECTURE.md
Validation scopes and tool ownershipsrc/tools.ts:138-148 (pom_validate), src/state.ts (passStage)docs/TOOL_MATRIX.md, POM.yml, skills/pom/references/qa.md
Theme schema and OMP integration@oh-my-pi/pi-coding-agent (external)scripts/verify.mjs, config/config.yml, themes/*.json
Dependency requirementspackage.json (peerDependencies, engines.bun)README.md, docs/SETTINGS.md, AGENTS.md

Mirror rules

  1. Every mirror page MUST include a “Source: path:line” reference to the canonical owner
  2. A mirror MUST NOT redefine a fact — only summarize, cross-reference, or contextualize
  3. When the canonical owner changes, all mirrors MUST be updated in the same PR
  4. Automated checks in scripts/verify.mjs or dedicated scripts validate mirror freshness
  5. scripts/verify.mjs already enforces: agent frontmatter shape, theme names/keys, prompt counts, command counts, tool counts, stage counts

Adding a new fact category

  1. Identify the single source file in src/, scripts/, or package.json
  2. Add a row to this table
  3. Update all existing mirrors to cite the new owner
  4. Add a verification check if the fact is drift-prone

Graph View

Backlinks