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

34 lines
868 B
Markdown

# 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:
```bash
pi @prompt.md "Answer this"
pi -p @screenshot.png "What's in this image?"
pi @code.ts @test.ts "Review these files"
```
---