# pi-forge documentation

[Project README](../README.md) · [简体中文](zh-CN/README.md)

Use this page as the documentation map. Each subject has one authoritative home; landing pages summarize and link rather than duplicate the full reference.

## Start here

- [Getting started](getting-started.md) — install pi-forge, create a stack, open the editor, and save a profile.
- [Prompt stacks](concepts/prompt-stacks.md) — the prompt-composition and policy model.
- [Agent profiles](concepts/agent-profiles.md) — one-shot model, thinking, and stack presets.

## Guides

- [Web editor](guides/web-editor.md)
- [Prompt-stack patterns and examples](guides/use-cases.md)
- [Foreground delegation](guides/delegation.md) — experimental; read the security boundary before enabling it.
- [SillyTavern import](guides/sillytavern-import.md)
- [Custom macros and slots](guides/custom-macros-and-slots.md)
- [Prompt and payload debugging](guides/debugging.md)

## Reference

- [Commands](reference/commands.md)
- [Prompt-stack schema and policy](reference/stack-schema.md)
- [Macros and runtime slots](reference/macros-and-slots.md)
- [Configuration](reference/configuration.md)
- [Implemented feature inventory](reference/features.md)
- [Public API policy](reference/public-api.md)
- [Experimental subagent adapter contract](reference/subagent-adapter.md)

## Development

- [Development setup and verification](development/setup.md)
- [Release process](development/release.md)
- [Roadmap](development/roadmap.md)
- [Complexity review](development/complexity-review.md)

## Design archive

[The design archive](design/README.md) records decisions and completed investigations. It is historical context, not current user guidance. Current behavior is documented in the guides and reference pages above.