singularity/singularity-forge
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions 1
singularity-forge/docs/dev/what-is-pi/13-context-files-project-instructions.md
ace-pm b29c12d5e5 refactor(native): rename gsd_parser.rs to forge_parser.rs 
Final rebrand: rename remaining Rust source file to complete the gsd → forge
transition. All parser references already use forge_parser after earlier commits.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-15 14:58:21 +02:00

868 B
Raw Permalink 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. ~/.sf/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:

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

Append to it instead:

  • .sf/APPEND_SYSTEM.md (project)
  • ~/.sf/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"