Description
The Claude Code User Documentation Review (2026-08-26) flagged two small but concrete doc gaps under "Minor Confusion": (1) Pi's model: prefix routing (copilot/, anthropic/, openai/) has no documented fallback behavior for a missing or unrecognized prefix (how-they-work.mdx:36, quick-start.mdx:157); (2) docs say Codex web-search is disabled by default and must be declared, but never state what changes once it's enabled (tools.md:67).
Task
Add a short clarifying note to how-they-work.mdx/quick-start.mdx describing what happens when a Pi model: value has no recognized provider prefix (falls back to a default provider? errors? — describe actual current behavior after checking the Pi engine implementation). Add a one-line note to tools.md:67 describing the concrete difference in Codex's tool behavior once web-search is enabled.
Acceptance Criteria
Expected Impact
Closes two small, concrete Priority-3 documentation gaps identified in an area users hit during initial engine setup.
Suggested Agent
Claude Code User Documentation Review agent, or a general coding agent (docs-only change)
Estimated Effort
Quick (< 1 hour)
Data Source
DeepReport analysis, 2026-08-26 cycle — Claude Code User Documentation Review (discussion #56036, Priority 3 recommendations)
Generated by 🔬 Deep Report · claude · agent · 151 AIC · ⌖ 9.14 AIC · ⊞ 12.4K · ◷
Description
The Claude Code User Documentation Review (2026-08-26) flagged two small but concrete doc gaps under "Minor Confusion": (1) Pi's
model:prefix routing (copilot/,anthropic/,openai/) has no documented fallback behavior for a missing or unrecognized prefix (how-they-work.mdx:36,quick-start.mdx:157); (2) docs say Codex web-search is disabled by default and must be declared, but never state what changes once it's enabled (tools.md:67).Task
Add a short clarifying note to
how-they-work.mdx/quick-start.mdxdescribing what happens when a Pimodel:value has no recognized provider prefix (falls back to a default provider? errors? — describe actual current behavior after checking the Pi engine implementation). Add a one-line note totools.md:67describing the concrete difference in Codex's tool behavior once web-search is enabled.Acceptance Criteria
how-they-work.mdxorquick-start.mdxdocuments Pi's missing/unrecognizedmodel:prefix behavior, verified against the actual Pi engine code pathtools.md:67documents what changes once Codex web-search is enabledExpected Impact
Closes two small, concrete Priority-3 documentation gaps identified in an area users hit during initial engine setup.
Suggested Agent
Claude Code User Documentation Review agent, or a general coding agent (docs-only change)
Estimated Effort
Quick (< 1 hour)
Data Source
DeepReport analysis, 2026-08-26 cycle — Claude Code User Documentation Review (discussion #56036, Priority 3 recommendations)