sf-pi Agent Orientation
Auto-generated from manifests and repo layout. Run
npm run generate-catalogto refresh; do not edit by hand.
Start here
AGENTS.md— automatically loaded repository rules and authority order.- Query
catalog/index.jsononly when the owning extension is unknown. - Read
extensions/<id>/manifest.jsonfor declared surfaces and document roles. - For code changes, read the declared
docs.editingRules, then the relevant source and Behavior Proof. - For tool operation, use the active schema first and read
docs.agentGuideonly when deeper ordering or recovery guidance is useful. - Use the extension README for human explanation and a specific ADR/context glossary for rationale or terminology.
Extension map
Use this table to locate the owner. Exact summaries, maturity, defaults, providers, tool names, events, safety notes, state paths, and environment variables remain in catalog/index.json.
| Extension | Category | Commands | Tools | Editing rules | Operating guide | References | Entry point |
|---|---|---|---|---|---|---|---|
| SF Pi Manager | manager | /sf-pi | 0 | none | none | none | extensions/sf-pi-manager/index.ts |
| SF LLM Gateway | provider | /sf-llm-gateway | 0 | rules | none | none | extensions/sf-llm-gateway/index.ts |
| SF Agent Script | agent-tool | /sf-agentscript | 4 | rules | guide | index | extensions/sf-agentscript/index.ts |
| SF Apex | agent-tool | /sf-apex | 1 | none | guide | none | extensions/sf-apex/index.ts |
| SF Browser | agent-tool | /sf-browser | 10 | none | guide | index | extensions/sf-browser/index.ts |
| SF Code Analyzer | agent-tool | /sf-code-analyzer | 1 | none | guide | none | extensions/sf-code-analyzer/index.ts |
| SF Data 360 | agent-tool | /sf-data360 | 11 | rules | guide | index, index | extensions/sf-data360/index.ts |
| SF Docs | agent-tool | /sf-docs | 1 | rules | guide | index | extensions/sf-docs/index.ts |
| SF Herdr | agent-tool | /sf-herdr | 1 | none | guide | none | extensions/sf-herdr/index.ts |
| SF LWC | agent-tool | /sf-lwc | 1 | none | guide | none | extensions/sf-lwc/index.ts |
| SF Slack | agent-tool | /sf-slack | 10 | rules | guide | none | extensions/sf-slack/index.ts |
| SF SOQL | agent-tool | /sf-soql | 1 | none | guide | none | extensions/sf-soql/index.ts |
| SF tldraw | agent-tool | /sf-tldraw | 1 | rules | guide | index | extensions/sf-tldraw/index.ts |
| SF Guardrail | safety | /sf-guardrail | 0 | rules | none | none | extensions/sf-guardrail/index.ts |
| SF Brain | assistive | none | 0 | none | guide | none | extensions/sf-brain/index.ts |
| SF Feedback | assistive | /sf-feedback | 0 | none | none | none | extensions/sf-feedback/index.ts |
| SF LSP | assistive | /sf-lsp | 0 | none | none | none | extensions/sf-lsp/index.ts |
| SF Data Explorer | ui | /sf-data-explorer | 0 | rules | none | none | extensions/sf-data-explorer/index.ts |
| SF DevBar | ui | /sf-devbar, /sf-org | 0 | none | none | none | extensions/sf-devbar/index.ts |
| SF Ohana Spinner | ui | none | 0 | none | none | none | extensions/sf-ohana-spinner/index.ts |
| SF Skills | ui | /sf-skills | 0 | none | none | none | extensions/sf-skills/index.ts |
| SF Welcome | ui | /sf-welcome, /sf-setup-fonts | 0 | none | none | none | extensions/sf-welcome/index.ts |
Manifest doc metadata
Every extension manifest must provide non-empty docs.summary and docs.primaryFiles fields. Extension-local AGENTS.md, AGENT_GUIDE.md, and CONTEXT.md files are declared explicitly as docs.editingRules, docs.agentGuide, and docs.contextGlossary. Tool-owning extensions require an agent guide. docs.referenceRoots routes every Markdown file under extension docs/ and references/ as current, generated-current, or compatibility material. docs.stateFiles, docs.env, and docs.safety remain optional.
Each docs.primaryFiles entry is extension-relative, resolves to an existing unique path, and the read-first set is capped at 8. Reference-root indexes are also extension-relative; generated-current roots name their repository generator.
Runtime surfaces
| Surface | Owners |
|---|---|
| Slash commands | SF Pi Manager, SF LLM Gateway, SF Agent Script, SF Apex, SF Browser, SF Code Analyzer, SF Data 360, SF Docs, SF Herdr, SF LWC, SF Slack, SF SOQL, SF tldraw, SF Guardrail, SF Feedback, SF LSP, SF Data Explorer, SF DevBar, SF Skills, SF Welcome |
| LLM tools | SF Agent Script, SF Apex, SF Browser, SF Code Analyzer, SF Data 360, SF Docs, SF Herdr, SF LWC, SF Slack, SF SOQL, SF tldraw |
| Provider registration | SF LLM Gateway, SF Docs, SF Slack |
| Startup/session hooks | SF Pi Manager, SF LLM Gateway, SF Agent Script, SF Apex, SF Browser, SF Code Analyzer, SF Data 360, SF Docs, SF Herdr, SF LWC, SF Slack, SF SOQL, SF tldraw, SF Guardrail, SF LSP, SF Data Explorer, SF DevBar, SF Ohana Spinner, SF Skills, SF Welcome |
| Tool-call hooks | SF Guardrail, SF Welcome |
| Generated docs/catalog | scripts/generate-catalog.mjs, catalog/index.json, catalog/registry.ts, docs/extensions.md, docs/extensions/*.md, docs/.vitepress/generated-extension-sidebar.ts, docs/commands.md |
Generated files
Do not edit these by hand; edit the source manifest/docs and run npm run generate-catalog.
catalog/index.jsoncatalog/registry.tsdocs/extensions.mddocs/extensions/*.mddocs/.vitepress/generated-extension-sidebar.tsdocs/commands.mddocs/agent-orientation.mddocs/adr/README.md- generated marker blocks in
ARCHITECTURE.md,CONTRIBUTING.md,lib/common/README.md,scripts/e2e/README.md, anddocs/troubleshooting.md - generated file-structure marker blocks in
extensions/*/README.md - normalized
catalog/announcements.jsonrelease entry
Automation shortcuts
npm run docs:health:check— documentation drift and tracked public-artifact lint.npm run check:architecture— source-size advisories and shared state-placement policy.npm run check:manager-first— real-factory no-args Manager routing proof.npm run test:runtime-surface— real-factory manifest registration attestation.npm run validate:ci— local approximation of CI's validation lane.