Integrations & vendor documentation
Purpose: Central place to find docs by vendor or product (HubSpot, Linear, OpenCode, Azure, etc.). It does not replace detailed guides—it routes you to the canonical file.
Where vendor docs live (three layers)
| Layer | Path | What goes here |
|---|---|---|
| Platform integration packs | knowledge/platform/integrations/<vendor>/ | Deep dives owned by Platform: architecture, MCP, troubleshooting, code samples (e.g. HubSpot). Add a folder when we have a multi-file “pack,” not for every one-pager. |
| Engineer & agent setup | knowledge/standards/03-knowledge/engineering/setup/ | Step-by-step setup for humans and Cursor agents: CLI install, OAuth, env vars. Full table → |
| Cross-cutting engineering | knowledge/engineering/ | Policy and cheat sheets that span tools (e.g. Azure model inventory, OpenCode CLI notes). Index → |
Integration packs (integrations/<vendor>/)
| Vendor | Pack | Notes |
|---|---|---|
| HubSpot | README.md | CRM, MCP, Linear enrichment, architecture |
| Linear | README.md | MCP and ticket standards, labels, Linear Agent daily briefing skill |
| OpenCode | README.md | Router only—canonical OpenCode + Azure docs live under knowledge/engineering/ and repo root opencode.jsonc |
Adding a pack: create integrations/<service>/, add README.md (overview, auth, links into engineering/setup if setup steps live there).
Quick vendor → setup guide
All *-setup.md guides and the big setup table live here:
knowledge/standards/03-knowledge/engineering/setup/README.md — includes MCP vs API columns, legacy/migration section, and Cursor agent notes.
Use that directory’s search or table when you know the tool name (e.g. figma-setup.md, granola-mcp-setup.md).
Cross-cutting (not one vendor folder)
| Topic | Canonical doc |
|---|---|
| Azure OpenAI (resources, deployments, env, retirements) | knowledge/engineering/azure-models-for-devs.md |
| Azure deployment options (Platform app) | apps/platform/docs/azure-openai-deployment-options.md |
| OpenCode (CLI, MCP, user config starter) | README.md |
Last updated: 2026-04-22