> ## Documentation Index
> Fetch the complete documentation index at: https://soulforge.proxysoul.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Modes & the prompt

> Switch personas with Ctrl+D. Load project instructions automatically.

## Modes

Press `Ctrl+D` to cycle, or `/mode <name>`:

| Mode        | What it does                                                           |
| ----------- | ---------------------------------------------------------------------- |
| `default`   | Full agent — investigates then implements                              |
| `architect` | Design only — outlines and tradeoffs, no file edits                    |
| `socratic`  | Asks probing questions before doing anything                           |
| `challenge` | Devil's advocate — challenges every assumption                         |
| `plan`      | Research, plan, confirm, execute (see [plan mode](/recipes/plan-mode)) |
| `auto`      | Autonomous — minimal interruptions                                     |

## Project instructions

SoulForge auto-loads `SOULFORGE.md` from your project root as context. You can also pick up instructions from other tools:

```json theme={null}
{
  "instructionFiles": ["soulforge", "claude", "cursorrules"]
}
```

| File                              | From                      |
| --------------------------------- | ------------------------- |
| `SOULFORGE.md`                    | SoulForge (on by default) |
| `CLAUDE.md`                       | Claude Code               |
| `.cursorrules`                    | Cursor                    |
| `.github/copilot-instructions.md` | GitHub Copilot            |
| `.clinerules`                     | Cline                     |
| `.windsurfrules`                  | Windsurf                  |
| `AGENTS.md`                       | OpenAI Codex              |
| `.opencode/instructions.md`       | OpenCode                  |
| `AMPLIFY.md`                      | Amp                       |

Toggle in the TUI: `/instructions`.

## Per-family tuning

SoulForge tailors the prompt based on the model family (Claude, OpenAI, Gemini) — different models respond better to different phrasings. Gateway providers (LLM Gateway, OpenRouter, Vercel) are detected by the model ID portion, so `llmgateway/claude-sonnet-4` gets the Claude prompt.

This is automatic; there's nothing to configure.