docs: add Mintlify documentation site and move internal docs

Add a proper public-facing documentation site using Mintlify with 19 MDX pages covering getting started, auto mode, commands, configuration, and all user-facing features. Move internal/SDK documentation (Pi SDK, TUI, context & hooks, research notes, ADRs) to docs-internal/ since they should not be part of the public documentation. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-03-25 09:54:41 -06:00 · 2026-03-25 09:54:41 -06:00 · d20d5e8fb5
commit d20d5e8fb5
parent e21526496e
179 changed files with 2520 additions and 0 deletions
--- a/docs-internal/ADR-001-branchless-worktree-architecture.md
+++ b/docs-internal/ADR-001-branchless-worktree-architecture.md
--- a/docs-internal/ADR-003-pipeline-simplification.md
+++ b/docs-internal/ADR-003-pipeline-simplification.md
--- a/docs-internal/FILE-SYSTEM-MAP.md
+++ b/docs-internal/FILE-SYSTEM-MAP.md
--- a/docs-internal/PRD-branchless-worktree-architecture.md
+++ b/docs-internal/PRD-branchless-worktree-architecture.md
--- a/docs-internal/README.md
+++ b/docs-internal/README.md
--- a/docs-internal/agent-knowledge-index.md
+++ b/docs-internal/agent-knowledge-index.md
--- a/docs-internal/architecture.md
+++ b/docs-internal/architecture.md
--- a/docs-internal/auto-mode.md
+++ b/docs-internal/auto-mode.md
--- a/docs-internal/building-coding-agents/01-work-decomposition.md
+++ b/docs-internal/building-coding-agents/01-work-decomposition.md
--- a/docs-internal/building-coding-agents/02-what-to-keep-discard-from-human-engineering.md
+++ b/docs-internal/building-coding-agents/02-what-to-keep-discard-from-human-engineering.md
--- a/docs-internal/building-coding-agents/03-state-machine-context-management.md
+++ b/docs-internal/building-coding-agents/03-state-machine-context-management.md
--- a/docs-internal/building-coding-agents/04-optimal-storage-for-project-context.md
+++ b/docs-internal/building-coding-agents/04-optimal-storage-for-project-context.md
--- a/docs-internal/building-coding-agents/05-parallelization-strategy.md
+++ b/docs-internal/building-coding-agents/05-parallelization-strategy.md
--- a/docs-internal/building-coding-agents/06-maximizing-agent-autonomy-superpowers.md
+++ b/docs-internal/building-coding-agents/06-maximizing-agent-autonomy-superpowers.md
--- a/docs-internal/building-coding-agents/07-system-prompt-llm-vs-deterministic-split.md
+++ b/docs-internal/building-coding-agents/07-system-prompt-llm-vs-deterministic-split.md
--- a/docs-internal/building-coding-agents/08-speed-optimization.md
+++ b/docs-internal/building-coding-agents/08-speed-optimization.md
--- a/docs-internal/building-coding-agents/09-top-10-tips-for-a-world-class-agent.md
+++ b/docs-internal/building-coding-agents/09-top-10-tips-for-a-world-class-agent.md
--- a/docs-internal/building-coding-agents/10-top-10-pitfalls-to-avoid.md
+++ b/docs-internal/building-coding-agents/10-top-10-pitfalls-to-avoid.md
--- a/docs-internal/building-coding-agents/11-god-tier-context-engineering.md
+++ b/docs-internal/building-coding-agents/11-god-tier-context-engineering.md
--- a/docs-internal/building-coding-agents/12-handling-ambiguity-contradiction.md
+++ b/docs-internal/building-coding-agents/12-handling-ambiguity-contradiction.md
--- a/docs-internal/building-coding-agents/13-long-running-memory-fidelity.md
+++ b/docs-internal/building-coding-agents/13-long-running-memory-fidelity.md
--- a/docs-internal/building-coding-agents/14-multi-agent-semantic-conflict-resolution.md
+++ b/docs-internal/building-coding-agents/14-multi-agent-semantic-conflict-resolution.md
--- a/docs-internal/building-coding-agents/15-legacy-code-brownfield-onboarding.md
+++ b/docs-internal/building-coding-agents/15-legacy-code-brownfield-onboarding.md
--- a/docs-internal/building-coding-agents/16-encoding-taste-aesthetics.md
+++ b/docs-internal/building-coding-agents/16-encoding-taste-aesthetics.md
--- a/docs-internal/building-coding-agents/17-irreversible-operations-safety-architecture.md
+++ b/docs-internal/building-coding-agents/17-irreversible-operations-safety-architecture.md
--- a/docs-internal/building-coding-agents/18-the-handoff-problem-agent-human-maintainability.md
+++ b/docs-internal/building-coding-agents/18-the-handoff-problem-agent-human-maintainability.md
--- a/docs-internal/building-coding-agents/19-when-to-scrap-and-start-over.md
+++ b/docs-internal/building-coding-agents/19-when-to-scrap-and-start-over.md
--- a/docs-internal/building-coding-agents/20-error-taxonomy-routing.md
+++ b/docs-internal/building-coding-agents/20-error-taxonomy-routing.md
--- a/docs-internal/building-coding-agents/21-cost-quality-tradeoff-model-routing.md
+++ b/docs-internal/building-coding-agents/21-cost-quality-tradeoff-model-routing.md
--- a/docs-internal/building-coding-agents/22-cross-project-learning-reusable-intelligence.md
+++ b/docs-internal/building-coding-agents/22-cross-project-learning-reusable-intelligence.md
--- a/docs-internal/building-coding-agents/23-evolution-across-project-scale.md
+++ b/docs-internal/building-coding-agents/23-evolution-across-project-scale.md
--- a/docs-internal/building-coding-agents/24-security-trust-boundaries.md
+++ b/docs-internal/building-coding-agents/24-security-trust-boundaries.md
--- a/docs-internal/building-coding-agents/25-designing-for-non-technical-users-vibe-coders.md
+++ b/docs-internal/building-coding-agents/25-designing-for-non-technical-users-vibe-coders.md
--- a/docs-internal/building-coding-agents/26-cross-cutting-themes-where-all-4-models-converge.md
+++ b/docs-internal/building-coding-agents/26-cross-cutting-themes-where-all-4-models-converge.md
--- a/docs-internal/building-coding-agents/README.md
+++ b/docs-internal/building-coding-agents/README.md
--- a/docs-internal/captures-triage.md
+++ b/docs-internal/captures-triage.md
--- a/docs-internal/ci-cd-pipeline.md
+++ b/docs-internal/ci-cd-pipeline.md
--- a/docs-internal/commands.md
+++ b/docs-internal/commands.md
--- a/docs-internal/configuration.md
+++ b/docs-internal/configuration.md
--- a/docs-internal/context-and-hooks/01-the-context-pipeline.md
+++ b/docs-internal/context-and-hooks/01-the-context-pipeline.md
--- a/docs-internal/context-and-hooks/02-hook-reference.md
+++ b/docs-internal/context-and-hooks/02-hook-reference.md
--- a/docs-internal/context-and-hooks/03-context-injection-patterns.md
+++ b/docs-internal/context-and-hooks/03-context-injection-patterns.md
--- a/docs-internal/context-and-hooks/04-message-types-and-llm-visibility.md
+++ b/docs-internal/context-and-hooks/04-message-types-and-llm-visibility.md
--- a/docs-internal/context-and-hooks/05-inter-extension-communication.md
+++ b/docs-internal/context-and-hooks/05-inter-extension-communication.md
--- a/docs-internal/context-and-hooks/06-advanced-patterns-from-source.md
+++ b/docs-internal/context-and-hooks/06-advanced-patterns-from-source.md
--- a/docs-internal/context-and-hooks/07-the-system-prompt-anatomy.md
+++ b/docs-internal/context-and-hooks/07-the-system-prompt-anatomy.md
--- a/docs-internal/context-and-hooks/README.md
+++ b/docs-internal/context-and-hooks/README.md
--- a/docs-internal/cost-management.md
+++ b/docs-internal/cost-management.md
--- a/docs-internal/custom-models.md
+++ b/docs-internal/custom-models.md
--- a/docs-internal/dynamic-model-routing.md
+++ b/docs-internal/dynamic-model-routing.md
--- a/docs-internal/extending-pi/01-what-are-extensions.md
+++ b/docs-internal/extending-pi/01-what-are-extensions.md
--- a/docs-internal/extending-pi/02-architecture-mental-model.md
+++ b/docs-internal/extending-pi/02-architecture-mental-model.md
--- a/docs-internal/extending-pi/03-getting-started.md
+++ b/docs-internal/extending-pi/03-getting-started.md
--- a/docs-internal/extending-pi/04-extension-locations-discovery.md
+++ b/docs-internal/extending-pi/04-extension-locations-discovery.md
--- a/docs-internal/extending-pi/05-extension-structure-styles.md
+++ b/docs-internal/extending-pi/05-extension-structure-styles.md
--- a/docs-internal/extending-pi/06-the-extension-lifecycle.md
+++ b/docs-internal/extending-pi/06-the-extension-lifecycle.md
--- a/docs-internal/extending-pi/07-events-the-nervous-system.md
+++ b/docs-internal/extending-pi/07-events-the-nervous-system.md
--- a/docs-internal/extending-pi/08-extensioncontext-what-you-can-access.md
+++ b/docs-internal/extending-pi/08-extensioncontext-what-you-can-access.md
--- a/docs-internal/extending-pi/09-extensionapi-what-you-can-do.md
+++ b/docs-internal/extending-pi/09-extensionapi-what-you-can-do.md
--- a/docs-internal/extending-pi/10-custom-tools-giving-the-llm-new-abilities.md
+++ b/docs-internal/extending-pi/10-custom-tools-giving-the-llm-new-abilities.md
--- a/docs-internal/extending-pi/11-custom-commands-user-facing-actions.md
+++ b/docs-internal/extending-pi/11-custom-commands-user-facing-actions.md
--- a/docs-internal/extending-pi/12-custom-ui-visual-components.md
+++ b/docs-internal/extending-pi/12-custom-ui-visual-components.md
--- a/docs-internal/extending-pi/13-state-management-persistence.md
+++ b/docs-internal/extending-pi/13-state-management-persistence.md
--- a/docs-internal/extending-pi/14-custom-rendering-controlling-what-the-user-sees.md
+++ b/docs-internal/extending-pi/14-custom-rendering-controlling-what-the-user-sees.md
--- a/docs-internal/extending-pi/15-system-prompt-modification.md
+++ b/docs-internal/extending-pi/15-system-prompt-modification.md
--- a/docs-internal/extending-pi/16-compaction-session-control.md
+++ b/docs-internal/extending-pi/16-compaction-session-control.md
--- a/docs-internal/extending-pi/17-model-provider-management.md
+++ b/docs-internal/extending-pi/17-model-provider-management.md
--- a/docs-internal/extending-pi/18-remote-execution-tool-overrides.md
+++ b/docs-internal/extending-pi/18-remote-execution-tool-overrides.md
--- a/docs-internal/extending-pi/19-packaging-distribution.md
+++ b/docs-internal/extending-pi/19-packaging-distribution.md
--- a/docs-internal/extending-pi/20-mode-behavior.md
+++ b/docs-internal/extending-pi/20-mode-behavior.md
--- a/docs-internal/extending-pi/21-error-handling.md
+++ b/docs-internal/extending-pi/21-error-handling.md
--- a/docs-internal/extending-pi/22-key-rules-gotchas.md
+++ b/docs-internal/extending-pi/22-key-rules-gotchas.md
--- a/docs-internal/extending-pi/23-file-reference-documentation.md
+++ b/docs-internal/extending-pi/23-file-reference-documentation.md
--- a/docs-internal/extending-pi/24-file-reference-example-extensions.md
+++ b/docs-internal/extending-pi/24-file-reference-example-extensions.md
--- a/docs-internal/extending-pi/25-slash-command-subcommand-patterns.md
+++ b/docs-internal/extending-pi/25-slash-command-subcommand-patterns.md
--- a/docs-internal/extending-pi/README.md
+++ b/docs-internal/extending-pi/README.md
--- a/docs-internal/getting-started.md
+++ b/docs-internal/getting-started.md
--- a/docs-internal/git-strategy.md
+++ b/docs-internal/git-strategy.md
--- a/docs-internal/migration.md
+++ b/docs-internal/migration.md
--- a/docs-internal/node-lts-macos.md
+++ b/docs-internal/node-lts-macos.md
--- a/docs-internal/parallel-orchestration.md
+++ b/docs-internal/parallel-orchestration.md
--- a/docs-internal/pi-ui-tui/01-the-ui-architecture.md
+++ b/docs-internal/pi-ui-tui/01-the-ui-architecture.md
--- a/docs-internal/pi-ui-tui/02-the-component-interface-foundation-of-everything.md
+++ b/docs-internal/pi-ui-tui/02-the-component-interface-foundation-of-everything.md
--- a/docs-internal/pi-ui-tui/03-entry-points-how-ui-gets-on-screen.md
+++ b/docs-internal/pi-ui-tui/03-entry-points-how-ui-gets-on-screen.md
--- a/docs-internal/pi-ui-tui/04-built-in-dialog-methods.md
+++ b/docs-internal/pi-ui-tui/04-built-in-dialog-methods.md
--- a/docs-internal/pi-ui-tui/05-persistent-ui-elements.md
+++ b/docs-internal/pi-ui-tui/05-persistent-ui-elements.md
--- a/docs-internal/pi-ui-tui/06-ctx-ui-custom-full-custom-components.md
+++ b/docs-internal/pi-ui-tui/06-ctx-ui-custom-full-custom-components.md
--- a/docs-internal/pi-ui-tui/07-built-in-components-the-building-blocks.md
+++ b/docs-internal/pi-ui-tui/07-built-in-components-the-building-blocks.md
--- a/docs-internal/pi-ui-tui/08-high-level-components-from-pi-coding-agent.md
+++ b/docs-internal/pi-ui-tui/08-high-level-components-from-pi-coding-agent.md
--- a/docs-internal/pi-ui-tui/09-keyboard-input-how-to-handle-keys.md
+++ b/docs-internal/pi-ui-tui/09-keyboard-input-how-to-handle-keys.md
--- a/docs-internal/pi-ui-tui/10-line-width-the-cardinal-rule.md
+++ b/docs-internal/pi-ui-tui/10-line-width-the-cardinal-rule.md
--- a/docs-internal/pi-ui-tui/11-theming-colors-and-styles.md
+++ b/docs-internal/pi-ui-tui/11-theming-colors-and-styles.md
--- a/docs-internal/pi-ui-tui/12-overlays-floating-modals-and-panels.md
+++ b/docs-internal/pi-ui-tui/12-overlays-floating-modals-and-panels.md
--- a/docs-internal/pi-ui-tui/13-custom-editors-replacing-the-input.md
+++ b/docs-internal/pi-ui-tui/13-custom-editors-replacing-the-input.md
--- a/docs-internal/pi-ui-tui/14-tool-rendering-custom-tool-display.md
+++ b/docs-internal/pi-ui-tui/14-tool-rendering-custom-tool-display.md
--- a/docs-internal/pi-ui-tui/15-message-rendering-custom-message-display.md
+++ b/docs-internal/pi-ui-tui/15-message-rendering-custom-message-display.md
--- a/docs-internal/pi-ui-tui/16-performance-caching-and-invalidation.md
+++ b/docs-internal/pi-ui-tui/16-performance-caching-and-invalidation.md
--- a/docs-internal/pi-ui-tui/17-theme-changes-and-invalidation.md
+++ b/docs-internal/pi-ui-tui/17-theme-changes-and-invalidation.md
--- a/docs-internal/pi-ui-tui/18-ime-support-the-focusable-interface.md
+++ b/docs-internal/pi-ui-tui/18-ime-support-the-focusable-interface.md
--- a/docs-internal/pi-ui-tui/19-building-a-complete-component-step-by-step.md
+++ b/docs-internal/pi-ui-tui/19-building-a-complete-component-step-by-step.md
--- a/Show more
+++ b/Show more