@agimon-ai/doompi-model-guidance

Per-model system prompt guidance for Pi agents, layered across global and repository scope.

A new model release often needs prompt adjustments that older models do not. This package keeps those adjustments in one place, keyed by model id, instead of spreading them through every package's prompt.

Configuration

Listing the package in modes.yaml activates its built-in default preset. The preset currently supplies guidance for gpt-6-astra to continue agreed plans and scoped tasks without pausing for minor decisions.

Custom guidance lives in model-guidance.yaml, read from two scopes:

Scope	Path
Global	~/.pi/.doom/model-guidance.yaml
Repository	<repository>/.doom/model-guidance.yaml

modelGuidance:
  claude-opus-5: |
    Keep the task focused. Never go off rails.
  gpt-6-astra: |
    Prefer fewer, larger tool batches.

Matching

Model ids match exactly, against the id Pi reports for the active model. Use the value shown by /model. A model with no custom entry uses its built-in preset entry when one exists; otherwise it gets no guidance.

Exact matching is deliberate: it keeps the file honest about which model a piece of text was written for. The cost is that a provider shipping a new versioned id needs a new entry.

Merge rule

The built-in preset applies first. Global guidance overrides the preset one model id at a time, then repository guidance overrides global guidance the same way.

Model id	Global	Repository	Result
claude-opus-5	"Stay focused."	"Cordis rules apply."	"Cordis rules apply."
gpt-6-astra	"Batch tools."	absent	"Batch tools."
local-qwen-3	absent	"Short answers only."	"Short answers only."

A malformed or unreadable guidance file warns on stderr and falls back to the built-in preset rather than ending the session.

Activation

The package ships in the llm layer and is optional.

Mode-scoped, in .doom/modes.yaml:

layers:
  llm:
    packages:
      - '@agimon-ai/doompi-model-guidance'

majorMode:
  copilot:
    layers: [team, ask-user, task, sandbox, llm]

Always on, by listing it in the default package list instead:

default:
  packages:
    - '@agimon-ai/doompi-model-guidance'

A bare package entry automatically uses the built-in default preset. A layer only activates when the selected major mode lists it, so add llm to every major mode that should carry guidance. The top-level default route enables it for all modes.

Behaviour

Guidance is appended to the system prompt at the start of each turn, after the default packages have contributed and before the profile persona. The file is read per turn, so an edit takes effect on the next message with no restart.

Development

pnpm nx run @agimon-ai/doompi-model-guidance:lint
pnpm nx run @agimon-ai/doompi-model-guidance:typecheck
pnpm nx run @agimon-ai/doompi-model-guidance:build
pnpm nx run @agimon-ai/doompi-model-guidance:test

Pi entrypoint: ./dist/extensions/pi.mjs.

The Pi and server declarations live in src/extensions and build directly to /extensions/pi and /extensions/server. Controllers handle host events and call the named guidance services. Flat root exports expose guidance loading, merging, and types. The shared helpers own registration and cleanup; this stateless plugin needs no lifecycle hooks.