# 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 Preset, open the editor, and save a Profile.
- [Presets and Stacks](concepts/prompt-stacks.md) — complete Presets and their ordered Block/Slot composition.
- [Agent profiles](concepts/agent-profiles.md) — one-shot model, thinking, and Preset bundles.

## Guides

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

## Reference

- [Commands](reference/commands.md)
- [Preset 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 host port contract](reference/subagent-host-port.md)
- [Experimental UI contribution port contract](reference/ui-contribution-port.md)

## Development

- [Development setup and verification](development/setup.md)
- [Architecture and development rules](development/architecture-rules.md)
- [0.5 architecture plan](design/architecture-0.5.md)
- [Release process](development/release.md)
- [Roadmap](development/roadmap.md)
- [Complexity review](development/complexity-review.md)

## Architecture and design

[Architecture and design](design/README.md) contains the active 0.5 plan plus historical decisions and investigations. Current released behavior remains documented in the guides and reference pages above.