singularity/singularity-forge
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 2
singularity-forge/docs/dev/what-is-pi/13-context-files-project-instructions.md
Jeremy 872b0adb48 docs: reorganize into user-docs/ and dev/ subdirectories 
Split flat docs/ into user-docs/ (guides, config, troubleshooting) and
dev/ (ADRs, architecture, extension guides, proposals). Updated
docs/README.md index to reflect new paths.
2026-04-10 09:25:31 -05:00

873 B
Raw Blame History

Context Files — Project Instructions

Pi loads instruction files automatically at startup:

AGENTS.md (or CLAUDE.md)

Pi looks for AGENTS.md or CLAUDE.md in:

  1. ~/.gsd/agent/AGENTS.md (global)
  2. Every parent directory from cwd up to filesystem root
  3. Current directory

All matching files are concatenated and included in the system prompt. Use these for project conventions, common commands, architectural notes.

System Prompt Override

Replace the default system prompt entirely:

  • .gsd/SYSTEM.md (project)
  • ~/.gsd/agent/SYSTEM.md (global)

Append to it instead:

  • .gsd/APPEND_SYSTEM.md (project)
  • ~/.gsd/agent/APPEND_SYSTEM.md (global)

File Arguments

Include files directly in prompts from the CLI:

pi @prompt.md "Answer this"
pi -p @screenshot.png "What's in this image?"
pi @code.ts @test.ts "Review these files"