Pointer Engine

Map repo paths to homes and catch documentation/structure drift with pointer_enforce.

What you will learn

• Define pointer homes
• pointer_diff drift
• pointer_enforce

Prerequisites

• Mount PluginHost and merge MCP tools

Surface

What this feature does

Pointers declare where classes of files live (docs/, .ags/, src/). pointer_enforce fails when docs claim missing paths or governed files lack a home.

Configuration

Add or update the configuration below in your repo. Keep it aligned with what agents and hooks read at runtime.

rules:
  - id: gov-docs
    roots: [docs/, .ags/]
  - id: eng-src
    roots: [packages/agent-governance-system/src/]

How to call it

Call these MCP tools through your AGS / tower-gov host — pointer_scan, pointer_get, pointer_validate, pointer_diff, pointer_enforce.. Prefer scan/get before validate/diff, and enforce only when the change set is ready.

1. pointer_scan
2. pointer_get
3. Fix homes / docs
4. pointer_enforce

{
  /* Example MCP call — fill args from schema_get / docs */
  "tool": "pointer_scan",
  "arguments": {}
}

What success looks like

pointer_enforce ok

pointer_diff empty or planned

Common failure modes

Moved protocol file without updating pointers

Docs link to deleted path

Orphan governed file outside roots

Related reference

• Pointer domains
• Architecture