Updated system prompt for full .md file readingPublic

Agent

Model

Claude Opus 4.5 (latest)

Started

Jan 26, 3:43 PM

Messages66

Downloads0

Summary

Closed, Completed

Edit
Clarified reading instructions in system prompt.
Edit
Edit
Reorganized prompt sections for clarity.
Edit
Edit
Merged documentation references in prompt.
Edit
Cleanup
Committed and pushed changes.
Cleanup

@packages/coding-agent/docs/ has a lot of .md files. @packages/coding-agent/src/core/system-prompt.ts references some of them. we need to tell the agent in the sytem prompt to read any .md files related to pi it reads in full (no truncation), and to follow links to other .md files in docs/ if useful, e.g. for tui api details

I can see the "Pi documentation" section already mentions following cross-references but doesn't emphasize reading in full. Let me update that section:

Done. Added a new bullet to the Pi documentation section in packages/coding-agent/src/core/system-prompt.ts:

(no offset/limit) that's not how the read tool works you monkey

You're right, my bad. To read in full you don't pass offset/limit. Let me fix that:

Actually "without truncation" is also misleading since the tool will truncate and you need to continue with offset. Let me make it clearer:

Done. Simpler and correct now.

161 - When asked to create: custom models/providers (README.md), extensions (docs/extensions.md, examples/extensions/), themes (docs/themes.md), skills (docs/skills.md), TUI components (docs/tui.md - has copy-paste patterns)

should mention the other .md files as well if they fit

Updated the line to include:

custom providers (docs/custom-provider.md) - more specific than README.md
keybindings (docs/keybindings.md) - new
prompt templates (docs/prompt-templates.md) - new
SDK integrations (docs/sdk.md) - new

custom providers (docs/custom-provider.md) should be last, models has @packages/coding-agent/docs/models.md, need to also add packages.md (pi packages)

Done. Split into two lines:

"When asked to create:" with custom providers moved to last
"When asked about:" for models and pi packages (informational rather than creation)

prompt templates after skills

Done. Moved prompt templates to come right after skills.

models (docs/models.md), pi packages (docs/packages.md) can go into the first Wehn asked abouat at the end, and models should be "adding models"

Done. Merged into single "When asked about" line with "adding models" and "pi packages" at the end.

commit and push

Done. Committed and pushed to main.