{ "catalog_name": "BuildWithHQ Knowledge Catalog", "catalog_version": "0.1.0", "generated_at": "2026-08-27T02:04:00-07:00", "canonical_format": "Markdown knowledge units with JSON-as-YAML front matter", "machine_format": "catalog.jsonl", "truth_statuses": [ "current", "specified", "planned", "concept", "deprecated", "uncertain" ], "item_count": 70, "knowledge_items": [ { "id": "BWHQ-AI-001", "title": "Dedicated AI data plane and vector lifecycle", "summary": "AI sources, chunks, embeddings, retrieval metadata, jobs, and telemetry live in a dedicated AI data plane rather than the main transactional database.", "status": "current", "authority": "high", "domain": "ai", "path": "knowledge/ai/bwhq-ai-001-dedicated-ai-data-plane-and-vector-lifecycle.md", "tags": [ "ai", "vectors", "rag", "embeddings" ], "related": [ "BWHQ-AI-002", "BWHQ-AI-003" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/ai/bwhq-ai-001-dedicated-ai-data-plane-and-vector-lifecycle.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/ai/bwhq-ai-001-dedicated-ai-data-plane-and-vector-lifecycle.md" }, { "id": "BWHQ-AI-002", "title": "Permission-aware RAG", "summary": "BuildWithHQ resolves the caller’s allowed data envelope before semantic retrieval returns context to the model; prompt text is not treated as the security boundary.", "status": "current", "authority": "highest", "domain": "ai", "path": "knowledge/ai/bwhq-ai-002-permission-aware-rag.md", "tags": [ "rag", "security", "retrieval", "permissions" ], "related": [ "BWHQ-SEC-001", "BWHQ-SEC-002" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/ai/bwhq-ai-002-permission-aware-rag.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/ai/bwhq-ai-002-permission-aware-rag.md" }, { "id": "BWHQ-AI-003", "title": "AI orchestration and model routing", "summary": "AI jobs and live inference can be routed through an orchestration plane that tracks endpoint capabilities, health, workers, and workload placement independent of a single model provider.", "status": "current", "authority": "high", "domain": "ai", "path": "knowledge/ai/bwhq-ai-003-ai-orchestration-and-model-routing.md", "tags": [ "ai", "orchestration", "workers", "routing" ], "related": [ "BWHQ-AI-001", "BWHQ-AI-004" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/ai/bwhq-ai-003-ai-orchestration-and-model-routing.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/ai/bwhq-ai-003-ai-orchestration-and-model-routing.md" }, { "id": "BWHQ-AI-004", "title": "AI harness packs", "summary": "AI behavior can be packaged, versioned, evaluated, gated, and distributed like software rather than treated as an untracked prompt string.", "status": "current", "authority": "medium-high", "domain": "ai", "path": "knowledge/ai/bwhq-ai-004-ai-harness-packs.md", "tags": [ "ai", "harness", "evaluation", "marketplace" ], "related": [ "BWHQ-MKT-001" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/ai/bwhq-ai-004-ai-harness-packs.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/ai/bwhq-ai-004-ai-harness-packs.md" }, { "id": "BWHQ-ARCH-001", "title": "Platform planes and database boundaries", "summary": "BuildWithHQ separates central control/catalog/orchestration concerns from each SaaS application’s runtime, AI, logging, and custom-code execution boundaries.", "status": "current", "authority": "high", "domain": "architecture", "path": "knowledge/architecture/bwhq-arch-001-platform-planes-and-database-boundaries.md", "tags": [ "architecture", "database", "control-plane", "runtime" ], "related": [ "BWHQ-BUILDER-001", "BWHQ-DATA-001", "BWHQ-AI-001" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/architecture/bwhq-arch-001-platform-planes-and-database-boundaries.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/architecture/bwhq-arch-001-platform-planes-and-database-boundaries.md" }, { "id": "BWHQ-ARCH-002", "title": "Managed and self-hosted deployment", "summary": "BuildWithHQ supports a managed runtime and a self-hosted BuildWithHQ Appliance while retaining a centrally governed software catalog and release supply chain.", "status": "current", "authority": "high", "domain": "architecture", "path": "knowledge/architecture/bwhq-arch-002-managed-and-self-hosted-deployment.md", "tags": [ "deployment", "appliance", "self-hosted", "managed" ], "related": [ "BWHQ-MKT-001", "BWHQ-ARCH-004" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/architecture/bwhq-arch-002-managed-and-self-hosted-deployment.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/architecture/bwhq-arch-002-managed-and-self-hosted-deployment.md" }, { "id": "BWHQ-ARCH-003", "title": "Server-driven JSON presentation", "summary": "BuildWithHQ represents pages and much application behavior as versioned JSON/schema interpreted by a shared runtime, enabling many application variations from a common codebase.", "status": "current", "authority": "high", "domain": "architecture", "path": "knowledge/architecture/bwhq-arch-003-server-driven-json-presentation.md", "tags": [ "json", "presentation", "renderer", "metadata-driven" ], "related": [ "BWHQ-SEC-001", "BWHQ-EXT-001" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/architecture/bwhq-arch-003-server-driven-json-presentation.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/architecture/bwhq-arch-003-server-driven-json-presentation.md" }, { "id": "BWHQ-ARCH-004", "title": "Template snapshot isolation and explicit upgrades", "summary": "Published template versions are installed as private application state pinned to a known version; upstream changes do not silently mutate running customer applications.", "status": "current", "authority": "high", "domain": "architecture", "path": "knowledge/architecture/bwhq-arch-004-template-snapshot-isolation-and-explicit-upgrades.md", "tags": [ "templates", "versions", "snapshot", "upgrades" ], "related": [ "BWHQ-MKT-001" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/architecture/bwhq-arch-004-template-snapshot-isolation-and-explicit-upgrades.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/architecture/bwhq-arch-004-template-snapshot-isolation-and-explicit-upgrades.md" }, { "id": "BWHQ-BUILD-001", "title": "Build This: ActiveWorkplace", "summary": "Pin a customer, claim, opportunity, invoice, project, case, contract, or any other record. ActiveWorkplace brings its permitted recursive relationships into one live work surface where people, GoClaws, workflows, and automation can work the full context together.", "status": "specified", "authority": "medium", "domain": "build-it-idea", "path": "knowledge/build-it-ideas/activeworkplace.md", "tags": [ "build-this", "example-product", "activeworkplace" ], "related": [ "BWHQ-PROD-001", "BWHQ-DATA-001", "BWHQ-GOCLAW-001" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/activeworkplace.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/activeworkplace.md" }, { "id": "BWHQ-BUILD-002", "title": "Build This: AssetOps", "summary": "Build field-service, facilities, fleet, property, equipment, inspection, or maintenance software that connects customers and locations to assets, inspections, work orders, technicians, parts, photos, documents, invoices, and complete service history.", "status": "specified", "authority": "medium", "domain": "build-it-idea", "path": "knowledge/build-it-ideas/assetops.md", "tags": [ "build-this", "example-product", "assetops" ], "related": [], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/assetops.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/assetops.md" }, { "id": "BWHQ-BUILD-003", "title": "Build This: CaseFlow", "summary": "Build software for claims, applications, investigations, compliance reviews, onboarding, service requests, permits, underwriting, HR matters, or any process where a record moves through stages while accumulating people, documents, conversations, tasks, decisions, and approvals.", "status": "specified", "authority": "medium", "domain": "build-it-idea", "path": "knowledge/build-it-ideas/caseflow.md", "tags": [ "build-this", "example-product", "caseflow" ], "related": [], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/caseflow.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/caseflow.md" }, { "id": "BWHQ-BUILD-004", "title": "Build This: CompanyIQ", "summary": "Ingest company documents, chunk and embed them for permission-aware search, then combine that knowledge with customers, past sales, pending deals, activity, support history, and other records. Scheduled AI analysis can surface new opportunities, risks, and next actions—especially inside the customer relationships you already have.", "status": "specified", "authority": "medium", "domain": "build-it-idea", "path": "knowledge/build-it-ideas/companyiq.md", "tags": [ "build-this", "example-product", "companyiq" ], "related": [ "BWHQ-PROD-002", "BWHQ-AI-002" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/companyiq.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/companyiq.md" }, { "id": "BWHQ-BUILD-005", "title": "Build This: CrewOS", "summary": "A coordinated workforce of specialized AI operators — each with its own role, context, tools, authority, and approval rules.", "status": "specified", "authority": "medium", "domain": "build-it-idea", "path": "knowledge/build-it-ideas/crewos.md", "tags": [ "build-this", "example-product", "crewos" ], "related": [ "BWHQ-GOCLAW-001", "BWHQ-GOCLAW-005" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/crewos.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/crewos.md" }, { "id": "BWHQ-BUILD-006", "title": "Build This: CustomerPortal", "summary": "Build a customer-facing portal that sits beside your internal application—sharing selected conversations, files, requests, approvals, milestones, and updates while your team keeps private notes, workflows, and operational detail on the inside.", "status": "specified", "authority": "medium", "domain": "build-it-idea", "path": "knowledge/build-it-ideas/customerportal.md", "tags": [ "build-this", "example-product", "customerportal" ], "related": [], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/customerportal.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/customerportal.md" }, { "id": "BWHQ-BUILD-007", "title": "Build This: FieldService", "summary": "Build field-service SaaS for HVAC, plumbing, electrical, appliance repair, facilities, inspections, maintenance, or any service business that needs customers, service areas, teams, schedules, jobs, approvals, files, conversations, AI assistance, estimates, and follow-up in one product.", "status": "specified", "authority": "medium", "domain": "build-it-idea", "path": "knowledge/build-it-ideas/fieldservice.md", "tags": [ "build-this", "example-product", "fieldservice" ], "related": [ "BWHQ-MOD-001", "BWHQ-MOD-002", "BWHQ-MOD-003", "BWHQ-MOD-004" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/fieldservice.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/fieldservice.md" }, { "id": "BWHQ-BUILD-008", "title": "Build This: Headless SaaS DB", "summary": "Build your customer experience in React, Vue, Next.js, mobile, a native desktop app, or an existing codebase. Use BuildWithHQ as the managed SaaS backend and expose the platform’s records, relationships, permissions, workflows, AI, files, webhooks, audit trail, and custom services through APIs.", "status": "specified", "authority": "medium", "domain": "build-it-idea", "path": "knowledge/build-it-ideas/headless-saas-db.md", "tags": [ "build-this", "example-product", "headless-saas-db" ], "related": [ "BWHQ-EXT-002", "BWHQ-SEC-001" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/headless-saas-db.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/headless-saas-db.md" }, { "id": "BWHQ-BUILD-009", "title": "Build This: LaunchPilot", "summary": "A marketing operations cockpit that assembles audiences, generates assets, routes approvals, activates channels, measures experiments, and optimizes inside defined authority.", "status": "specified", "authority": "medium", "domain": "build-it-idea", "path": "knowledge/build-it-ideas/launchpilot.md", "tags": [ "build-this", "example-product", "launchpilot" ], "related": [], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/launchpilot.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/launchpilot.md" }, { "id": "BWHQ-BUILD-010", "title": "Build This: Northstar", "summary": "An executive decision layer that compresses company-wide operating changes into a small number of material signals, forecasts, risks, opportunities, and evidence-backed decisions.", "status": "specified", "authority": "medium", "domain": "build-it-idea", "path": "knowledge/build-it-ideas/northstar.md", "tags": [ "build-this", "example-product", "northstar" ], "related": [], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/northstar.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/northstar.md" }, { "id": "BWHQ-BUILD-011", "title": "Build This: OpsAtlas", "summary": "Turn SOPs, policies, manuals, training, internal documentation, system guides, and hard-won tribal knowledge into a permission-aware operating memory. Employees can ask how work gets done, AI agents can retrieve trusted instructions before acting, and every answer can point back to its evidence.", "status": "specified", "authority": "medium", "domain": "build-it-idea", "path": "knowledge/build-it-ideas/opsatlas.md", "tags": [ "build-this", "example-product", "opsatlas" ], "related": [ "BWHQ-AI-002", "BWHQ-DATA-001" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/opsatlas.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/opsatlas.md" }, { "id": "BWHQ-BUILD-012", "title": "Build This: RelateEverything", "summary": "Build a CRM where contacts, companies, files, documents, calendar events, tasks, projects, conversations, and custom records can relate to one another—so every item reveals the full context around it.", "status": "specified", "authority": "medium", "domain": "build-it-idea", "path": "knowledge/build-it-ideas/relateeverything.md", "tags": [ "build-this", "example-product", "relateeverything" ], "related": [ "BWHQ-DATA-001" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/relateeverything.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/relateeverything.md" }, { "id": "BWHQ-BUILD-013", "title": "Build This: Reservations", "summary": "Build an authenticated reservations product for service businesses that need configurable offerings, booking duration and buffers, contacts, calendar placement, staff or resource assignment, capacity controls, payment state, and pre/post-service communications in one secured workflow.", "status": "specified", "authority": "medium", "domain": "build-it-idea", "path": "knowledge/build-it-ideas/reservations.md", "tags": [ "build-this", "example-product", "reservations" ], "related": [ "BWHQ-MOD-001", "BWHQ-MOD-002" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/reservations.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/reservations.md" }, { "id": "BWHQ-BUILD-014", "title": "Build This: Resolve", "summary": "An AI support operation that identifies the customer, understands the request, checks records and policy, executes permitted resolutions, and escalates exceptions.", "status": "specified", "authority": "medium", "domain": "build-it-idea", "path": "knowledge/build-it-ideas/resolve.md", "tags": [ "build-this", "example-product", "resolve" ], "related": [], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/resolve.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/resolve.md" }, { "id": "BWHQ-BUILD-015", "title": "Build This: SignalIQ", "summary": "A revenue intelligence system that turns CRM history, usage, intent, engagement, and account movement into a ranked action queue.", "status": "specified", "authority": "medium", "domain": "build-it-idea", "path": "knowledge/build-it-ideas/signaliq.md", "tags": [ "build-this", "example-product", "signaliq" ], "related": [], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/signaliq.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/signaliq.md" }, { "id": "BWHQ-BUILD-016", "title": "Build This: TeamBox", "summary": "Bring email, web forms, SMS, and other inbound communications into one team inbox where AI can classify, connect, prioritize, suggest actions, and queue work for people to approve or complete.", "status": "specified", "authority": "medium", "domain": "build-it-idea", "path": "knowledge/build-it-ideas/teambox.md", "tags": [ "build-this", "example-product", "teambox" ], "related": [ "BWHQ-GOCLAW-002", "BWHQ-GOCLAW-005" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/teambox.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/build-it-ideas/teambox.md" }, { "id": "BWHQ-BUILDER-001", "title": "Builder account control plane", "summary": "The builder portal manages the BuildWithHQ customer account, team, platform billing, portfolio, resource allocation, domains, API clients, backups, integrations, sessions, and audit—not the SaaS end-customer data plane.", "status": "current", "authority": "highest", "domain": "builder", "path": "knowledge/builder/bwhq-builder-001-builder-account-control-plane.md", "tags": [ "builder", "control-plane", "billing", "portfolio" ], "related": [ "BWHQ-ARCH-001", "BWHQ-BUILDER-002" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/builder/bwhq-builder-001-builder-account-control-plane.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/builder/bwhq-builder-001-builder-account-control-plane.md" }, { "id": "BWHQ-BUILDER-002", "title": "Wholesale resource pools and per-app allocation", "summary": "Builder accounts manage separate shared capacity pools for primary DB, log DB, AI DB, and container storage and allocate those resources across their SaaS portfolio.", "status": "current", "authority": "high", "domain": "builder", "path": "knowledge/builder/bwhq-builder-002-wholesale-resource-pools-and-per-app-allocation.md", "tags": [ "resources", "storage", "quota", "portfolio" ], "related": [ "BWHQ-BUILDER-001" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/builder/bwhq-builder-002-wholesale-resource-pools-and-per-app-allocation.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/builder/bwhq-builder-002-wholesale-resource-pools-and-per-app-allocation.md" }, { "id": "BWHQ-BIZ-001", "title": "Commercial model and operational leverage", "summary": "BuildWithHQ’s model can combine builder subscriptions, portfolio resource expansion, marketplace economics, builder-to-customer monetization, and self-hosted licensing/support.", "status": "specified", "authority": "medium-high", "domain": "business", "path": "knowledge/business/bwhq-biz-001-commercial-model-and-operational-leverage.md", "tags": [ "business", "pricing", "marketplace", "ndr" ], "related": [], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/business/bwhq-biz-001-commercial-model-and-operational-leverage.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/business/bwhq-biz-001-commercial-model-and-operational-leverage.md" }, { "id": "BWHQ-DATA-001", "title": "Universal Record model", "summary": "Important application objects share a universal RecordId so records, relations, security, search, AI, audit, favorites, and workflows can operate across modules.", "status": "current", "authority": "high", "domain": "data", "path": "knowledge/data/bwhq-data-001-universal-record-model.md", "tags": [ "records", "recordid", "graph", "relations" ], "related": [ "BWHQ-DATA-002", "BWHQ-PROD-001", "BWHQ-SEC-001" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/data/bwhq-data-001-universal-record-model.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/data/bwhq-data-001-universal-record-model.md" }, { "id": "BWHQ-DATA-002", "title": "AppAccount multi-tenancy boundary", "summary": "Inside a generated SaaS database, AppAccountId is the primary tenant isolation boundary and must be derived/validated server-side for record and AI operations.", "status": "current", "authority": "high", "domain": "data", "path": "knowledge/data/bwhq-data-002-appaccount-multi-tenancy-boundary.md", "tags": [ "tenancy", "appaccount", "isolation", "security" ], "related": [ "BWHQ-ARCH-001", "BWHQ-AI-002" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/data/bwhq-data-002-appaccount-multi-tenancy-boundary.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/data/bwhq-data-002-appaccount-multi-tenancy-boundary.md" }, { "id": "BWHQ-DATA-003", "title": "Dynamic fields, views, menus, modules, and user experiences", "summary": "BuildWithHQ uses metadata-driven fields, views, menus, modules, workflows, and user types to customize a SaaS without hard-coding every variation.", "status": "current", "authority": "medium-high", "domain": "data", "path": "knowledge/data/bwhq-data-003-dynamic-fields-views-menus-modules-and-user-experiences.md", "tags": [ "modules", "fields", "views", "menus", "user-types" ], "related": [ "BWHQ-ARCH-003", "BWHQ-DEV-002" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/data/bwhq-data-003-dynamic-fields-views-menus-modules-and-user-experiences.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/data/bwhq-data-003-dynamic-fields-views-menus-modules-and-user-experiences.md" }, { "id": "BWHQ-DEV-001", "title": "Isolated Developer VM", "summary": "Each developer can work in an isolated no-unrestricted-internet VM with a local PostgreSQL instance; BuildWithHQ-controlled gateways mediate external AI, packages, MCP, integrations, artifacts, and deployment.", "status": "specified", "authority": "medium-high", "domain": "developer", "path": "knowledge/developer/bwhq-dev-001-isolated-developer-vm.md", "tags": [ "developer-vm", "postgresql", "isolation", "gateways" ], "related": [ "BWHQ-EXT-003", "BWHQ-EXT-001" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/developer/bwhq-dev-001-isolated-developer-vm.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/developer/bwhq-dev-001-isolated-developer-vm.md" }, { "id": "BWHQ-DEV-002", "title": "Role-aware in-context developer mode", "summary": "BuildWithHQ can let developers edit a SaaS page in context, persist JSON layout changes, and simulate different user roles while keeping backend authorization authoritative.", "status": "concept", "authority": "medium", "domain": "developer", "path": "knowledge/developer/bwhq-dev-002-role-aware-in-context-developer-mode.md", "tags": [ "developer-mode", "roles", "visual-builder", "json" ], "related": [ "BWHQ-ARCH-003", "BWHQ-SEC-001" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/developer/bwhq-dev-002-role-aware-in-context-developer-mode.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/developer/bwhq-dev-002-role-aware-in-context-developer-mode.md" }, { "id": "BWHQ-EXT-001", "title": "API-first custom service boundary", "summary": "Developer custom code runs behind declared, schema-validated API endpoints so BuildWithHQ can bind custom logic into pages, workflows, AI, and external APIs without exposing platform core IP or direct unrestricted SQL.", "status": "current", "authority": "high", "domain": "extensibility", "path": "knowledge/extensibility/bwhq-ext-001-api-first-custom-service-boundary.md", "tags": [ "api", "custom-services", "containers", "extensibility" ], "related": [ "BWHQ-ARCH-003", "BWHQ-EXT-002", "BWHQ-SEC-001" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/extensibility/bwhq-ext-001-api-first-custom-service-boundary.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/extensibility/bwhq-ext-001-api-first-custom-service-boundary.md" }, { "id": "BWHQ-EXT-002", "title": "Headless SaaS and scoped API clients", "summary": "BuildWithHQ can act as a secured headless backend for external frontends, legacy systems, mobile apps, dashboards, and scripts through scoped API clients.", "status": "specified", "authority": "high", "domain": "extensibility", "path": "knowledge/extensibility/bwhq-ext-002-headless-saas-and-scoped-api-clients.md", "tags": [ "api", "headless", "legacy", "integration" ], "related": [ "BWHQ-EXT-001", "BWHQ-EXT-003" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/extensibility/bwhq-ext-002-headless-saas-and-scoped-api-clients.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/extensibility/bwhq-ext-002-headless-saas-and-scoped-api-clients.md" }, { "id": "BWHQ-EXT-003", "title": "Four MCP surfaces", "summary": "BuildWithHQ’s MCP strategy separates Builder Account, Developer VM, SaaS Application, and End-Customer MCP surfaces while reusing common capability, permission, and audit primitives.", "status": "specified", "authority": "medium-high", "domain": "extensibility", "path": "knowledge/extensibility/bwhq-ext-003-four-mcp-surfaces.md", "tags": [ "mcp", "ai-tools", "permissions", "control-surfaces" ], "related": [ "BWHQ-SEC-001", "BWHQ-DEV-001", "BWHQ-EXT-001" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/extensibility/bwhq-ext-003-four-mcp-surfaces.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/extensibility/bwhq-ext-003-four-mcp-surfaces.md" }, { "id": "BWHQ-MOD-002", "title": "Calendar first-class module", "summary": "Reusable secured calendar/event records that can participate in relationships, activity, favorites, dynamic fields, and location/role-aware views.", "status": "current", "authority": "high", "domain": "first-class-module", "path": "knowledge/first-class-modules/calendar/bwhq-mod-002-calendar-first-class-module.md", "tags": [ "first-class-module", "calendar", "records", "security" ], "related": [ "BWHQ-DATA-001", "BWHQ-SEC-001", "BWHQ-EXT-003" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/calendar/bwhq-mod-002-calendar-first-class-module.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/calendar/bwhq-mod-002-calendar-first-class-module.md" }, { "id": "BWHQ-MOD-008", "title": "Chat rooms first-class module", "summary": "Reusable chat-room and chat-message records that remain part of the universal record graph.", "status": "current", "authority": "high", "domain": "first-class-module", "path": "knowledge/first-class-modules/chat-rooms/bwhq-mod-008-chat-rooms-first-class-module.md", "tags": [ "first-class-module", "chat-rooms", "records", "security" ], "related": [ "BWHQ-DATA-001", "BWHQ-SEC-001", "BWHQ-EXT-003" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/chat-rooms/bwhq-mod-008-chat-rooms-first-class-module.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/chat-rooms/bwhq-mod-008-chat-rooms-first-class-module.md" }, { "id": "BWHQ-MOD-005", "title": "Company news first-class module", "summary": "Reusable company announcement/news records built on the shared record and security model.", "status": "current", "authority": "high", "domain": "first-class-module", "path": "knowledge/first-class-modules/company-news/bwhq-mod-005-company-news-first-class-module.md", "tags": [ "first-class-module", "company-news", "records", "security" ], "related": [ "BWHQ-DATA-001", "BWHQ-SEC-001", "BWHQ-EXT-003" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/company-news/bwhq-mod-005-company-news-first-class-module.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/company-news/bwhq-mod-005-company-news-first-class-module.md" }, { "id": "BWHQ-MOD-001", "title": "Contacts first-class module", "summary": "Reusable secured people/contact records for customers, vendors, employees, contractors, prospects, and other business identities.", "status": "current", "authority": "high", "domain": "first-class-module", "path": "knowledge/first-class-modules/contacts/bwhq-mod-001-contacts-first-class-module.md", "tags": [ "first-class-module", "contacts", "records", "security" ], "related": [ "BWHQ-DATA-001", "BWHQ-SEC-001", "BWHQ-EXT-003" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/contacts/bwhq-mod-001-contacts-first-class-module.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/contacts/bwhq-mod-001-contacts-first-class-module.md" }, { "id": "BWHQ-MOD-004", "title": "Conversations/messages first-class module", "summary": "Reusable secured conversation threads and messages that can link communication directly to other business records.", "status": "current", "authority": "high", "domain": "first-class-module", "path": "knowledge/first-class-modules/conversations-messages/bwhq-mod-004-conversations-messages-first-class-module.md", "tags": [ "first-class-module", "conversations-messages", "records", "security" ], "related": [ "BWHQ-DATA-001", "BWHQ-SEC-001", "BWHQ-EXT-003" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/conversations-messages/bwhq-mod-004-conversations-messages-first-class-module.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/conversations-messages/bwhq-mod-004-conversations-messages-first-class-module.md" }, { "id": "BWHQ-MOD-009", "title": "Discussion boards first-class module", "summary": "Reusable boards, topics, and threaded discussion records with universal relation and security behavior.", "status": "current", "authority": "high", "domain": "first-class-module", "path": "knowledge/first-class-modules/discussion-boards/bwhq-mod-009-discussion-boards-first-class-module.md", "tags": [ "first-class-module", "discussion-boards", "records", "security" ], "related": [ "BWHQ-DATA-001", "BWHQ-SEC-001", "BWHQ-EXT-003" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/discussion-boards/bwhq-mod-009-discussion-boards-first-class-module.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/discussion-boards/bwhq-mod-009-discussion-boards-first-class-module.md" }, { "id": "BWHQ-MOD-013", "title": "Dynamic/custom modules first-class module", "summary": "Tenant-owned schema-driven modules that use typed fields and the universal RecordId/security conventions rather than bespoke tables/UI behavior.", "status": "current", "authority": "high", "domain": "first-class-module", "path": "knowledge/first-class-modules/dynamic-custom-modules/bwhq-mod-013-dynamic-custom-modules-first-class-module.md", "tags": [ "first-class-module", "dynamic-custom-modules", "records", "security" ], "related": [ "BWHQ-DATA-001", "BWHQ-SEC-001", "BWHQ-EXT-003" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/dynamic-custom-modules/bwhq-mod-013-dynamic-custom-modules-first-class-module.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/dynamic-custom-modules/bwhq-mod-013-dynamic-custom-modules-first-class-module.md" }, { "id": "BWHQ-MOD-011", "title": "Favorites first-class module", "summary": "Reusable per-user favorites/pinning/tracking over universal records and other supported targets.", "status": "current", "authority": "high", "domain": "first-class-module", "path": "knowledge/first-class-modules/favorites/bwhq-mod-011-favorites-first-class-module.md", "tags": [ "first-class-module", "favorites", "records", "security" ], "related": [ "BWHQ-DATA-001", "BWHQ-SEC-001", "BWHQ-EXT-003" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/favorites/bwhq-mod-011-favorites-first-class-module.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/favorites/bwhq-mod-011-favorites-first-class-module.md" }, { "id": "BWHQ-MOD-003", "title": "Files and attachments first-class module", "summary": "Reusable secured files/attachments with universal RecordId links, backend-mediated file handling, and relation support.", "status": "current", "authority": "high", "domain": "first-class-module", "path": "knowledge/first-class-modules/files-and-attachments/bwhq-mod-003-files-and-attachments-first-class-module.md", "tags": [ "first-class-module", "files-and-attachments", "records", "security" ], "related": [ "BWHQ-DATA-001", "BWHQ-SEC-001", "BWHQ-EXT-003" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/files-and-attachments/bwhq-mod-003-files-and-attachments-first-class-module.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/files-and-attachments/bwhq-mod-003-files-and-attachments-first-class-module.md" }, { "id": "BWHQ-MOD-016", "title": "Global secured search first-class module", "summary": "Reusable cross-module search that returns only records permitted by the active SaaS, tenant, role, location, and other security constraints.", "status": "current", "authority": "high", "domain": "first-class-module", "path": "knowledge/first-class-modules/global-secured-search/bwhq-mod-016-global-secured-search-first-class-module.md", "tags": [ "first-class-module", "global-secured-search", "records", "security" ], "related": [ "BWHQ-DATA-001", "BWHQ-SEC-001", "BWHQ-EXT-003" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/global-secured-search/bwhq-mod-016-global-secured-search-first-class-module.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/global-secured-search/bwhq-mod-016-global-secured-search-first-class-module.md" }, { "id": "BWHQ-MOD-006", "title": "Knowledge articles first-class module", "summary": "Reusable knowledge-base articles that can be secured, related, searched, indexed, and exposed to permitted AI workflows.", "status": "current", "authority": "high", "domain": "first-class-module", "path": "knowledge/first-class-modules/knowledge-articles/bwhq-mod-006-knowledge-articles-first-class-module.md", "tags": [ "first-class-module", "knowledge-articles", "records", "security" ], "related": [ "BWHQ-DATA-001", "BWHQ-SEC-001", "BWHQ-EXT-003" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/knowledge-articles/bwhq-mod-006-knowledge-articles-first-class-module.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/knowledge-articles/bwhq-mod-006-knowledge-articles-first-class-module.md" }, { "id": "BWHQ-MOD-010", "title": "Mail reader first-class module", "summary": "Reusable imported/read email records that can be securely related to contacts, jobs, events, files, and other records.", "status": "current", "authority": "high", "domain": "first-class-module", "path": "knowledge/first-class-modules/mail-reader/bwhq-mod-010-mail-reader-first-class-module.md", "tags": [ "first-class-module", "mail-reader", "records", "security" ], "related": [ "BWHQ-DATA-001", "BWHQ-SEC-001", "BWHQ-EXT-003" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/mail-reader/bwhq-mod-010-mail-reader-first-class-module.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/mail-reader/bwhq-mod-010-mail-reader-first-class-module.md" }, { "id": "BWHQ-MOD-012", "title": "Notifications first-class module", "summary": "Reusable user-targeted notifications with secured source-record context and read/dismiss state.", "status": "current", "authority": "high", "domain": "first-class-module", "path": "knowledge/first-class-modules/notifications/bwhq-mod-012-notifications-first-class-module.md", "tags": [ "first-class-module", "notifications", "records", "security" ], "related": [ "BWHQ-DATA-001", "BWHQ-SEC-001", "BWHQ-EXT-003" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/notifications/bwhq-mod-012-notifications-first-class-module.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/notifications/bwhq-mod-012-notifications-first-class-module.md" }, { "id": "BWHQ-MOD-015", "title": "Record activity/history first-class module", "summary": "Reusable secured activity/history projection over universal records.", "status": "current", "authority": "high", "domain": "first-class-module", "path": "knowledge/first-class-modules/record-activity-history/bwhq-mod-015-record-activity-history-first-class-module.md", "tags": [ "first-class-module", "record-activity-history", "records", "security" ], "related": [ "BWHQ-DATA-001", "BWHQ-SEC-001", "BWHQ-EXT-003" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/record-activity-history/bwhq-mod-015-record-activity-history-first-class-module.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/record-activity-history/bwhq-mod-015-record-activity-history-first-class-module.md" }, { "id": "BWHQ-MOD-014", "title": "Record relations/graph UI first-class module", "summary": "Reusable UI/API surface for secured record search, bounded graph retrieval, and authorized relation creation/removal.", "status": "current", "authority": "high", "domain": "first-class-module", "path": "knowledge/first-class-modules/record-relations-graph-ui/bwhq-mod-014-record-relations-graph-ui-first-class-module.md", "tags": [ "first-class-module", "record-relations-graph-ui", "records", "security" ], "related": [ "BWHQ-DATA-001", "BWHQ-SEC-001", "BWHQ-EXT-003" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/record-relations-graph-ui/bwhq-mod-014-record-relations-graph-ui-first-class-module.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/record-relations-graph-ui/bwhq-mod-014-record-relations-graph-ui-first-class-module.md" }, { "id": "BWHQ-MOD-007", "title": "Web links first-class module", "summary": "Reusable shared web-resource/bookmark records participating in the same record, relation, and security system.", "status": "current", "authority": "high", "domain": "first-class-module", "path": "knowledge/first-class-modules/web-links/bwhq-mod-007-web-links-first-class-module.md", "tags": [ "first-class-module", "web-links", "records", "security" ], "related": [ "BWHQ-DATA-001", "BWHQ-SEC-001", "BWHQ-EXT-003" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/web-links/bwhq-mod-007-web-links-first-class-module.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/first-class-modules/web-links/bwhq-mod-007-web-links-first-class-module.md" }, { "id": "BWHQ-FOUND-001", "title": "BuildWithHQ platform overview", "summary": "BuildWithHQ is a visual SaaS operating foundation that combines reusable SaaS infrastructure, server-driven presentation, dedicated per-app data planes, AI, extensibility, marketplace distribution, and managed or self-hosted deployment.", "status": "current", "authority": "high", "domain": "foundation", "path": "knowledge/foundation/bwhq-found-001-buildwithhq-platform-overview.md", "tags": [ "platform", "overview", "saas", "architecture" ], "related": [ "BWHQ-ARCH-001", "BWHQ-ARCH-003", "BWHQ-MKT-001" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/foundation/bwhq-found-001-buildwithhq-platform-overview.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/foundation/bwhq-found-001-buildwithhq-platform-overview.md" }, { "id": "BWHQ-FOUND-002", "title": "Knowledge truth status and source priority", "summary": "Rules for how AI should decide whether a BuildWithHQ statement is implemented, specified, planned, conceptual, deprecated, or uncertain.", "status": "current", "authority": "highest", "domain": "foundation", "path": "knowledge/foundation/bwhq-found-002-knowledge-truth-status-and-source-priority.md", "tags": [ "knowledge", "governance", "status", "sources" ], "related": [], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/foundation/bwhq-found-002-knowledge-truth-status-and-source-priority.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/foundation/bwhq-found-002-knowledge-truth-status-and-source-priority.md" }, { "id": "BWHQ-GOCLAW-005", "title": "GoClaw suggestion batches and human approval", "summary": "GoClaw groups proposed AI actions into a suggestion batch tied to one Inbox item and its activity version, allowing BuildWithHQ to validate, review, approve, reject, or escalate the work before execution.", "status": "specified", "authority": "high", "domain": "goclaw", "path": "knowledge/goclaw/actions-and-approvals/bwhq-goclaw-005-goclaw-suggestion-batches-and-human-approval.md", "tags": [ "goclaw", "actions", "approval", "suggestion-batch", "human-in-the-loop" ], "related": [ "BWHQ-GOCLAW-004", "BWHQ-SEC-001" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/goclaw/actions-and-approvals/bwhq-goclaw-005-goclaw-suggestion-batches-and-human-approval.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/goclaw/actions-and-approvals/bwhq-goclaw-005-goclaw-suggestion-batches-and-human-approval.md" }, { "id": "BWHQ-GOCLAW-006", "title": "GoClaw governed action execution and stale-context fence", "summary": "Approved GoClaw suggestions execute through the BuildWithHQ AI action/runtime bridge with Inbox, batch, execution, and activity-version linkage; stale context blocks finalization or execution when the underlying Inbox activity has changed.", "status": "specified", "authority": "high", "domain": "goclaw", "path": "knowledge/goclaw/execution/bwhq-goclaw-006-goclaw-governed-action-execution-and-stale-context-fence.md", "tags": [ "goclaw", "execution", "actions", "stale-context", "activity-version" ], "related": [ "BWHQ-GOCLAW-005", "BWHQ-OPS-001" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/goclaw/execution/bwhq-goclaw-006-goclaw-governed-action-execution-and-stale-context-fence.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/goclaw/execution/bwhq-goclaw-006-goclaw-governed-action-execution-and-stale-context-fence.md" }, { "id": "BWHQ-GOCLAW-001", "title": "GoClaw governed AI operator model", "summary": "GoClaw is BuildWithHQ’s governed AI operator pattern: it works from permitted Inbox/context, prepares actions, uses approval and freshness controls, and executes through canonical action services rather than mutating data directly.", "status": "specified", "authority": "high", "domain": "goclaw", "path": "knowledge/goclaw/overview/bwhq-goclaw-001-goclaw-governed-ai-operator-model.md", "tags": [ "goclaw", "ai-operator", "agent", "governance" ], "related": [ "BWHQ-SEC-001", "BWHQ-AI-003", "BWHQ-EXT-003" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/goclaw/overview/bwhq-goclaw-001-goclaw-governed-ai-operator-model.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/goclaw/overview/bwhq-goclaw-001-goclaw-governed-ai-operator-model.md" }, { "id": "BWHQ-GOCLAW-004", "title": "GoClaw planning and model call", "summary": "GoClaw planning uses routed AI models to classify the work, estimate risk/confidence, draft a response, and propose structured actions without performing application mutations during the planning step.", "status": "specified", "authority": "high", "domain": "goclaw", "path": "knowledge/goclaw/planning/bwhq-goclaw-004-goclaw-planning-and-model-call.md", "tags": [ "goclaw", "planning", "model-routing", "risk", "confidence" ], "related": [ "BWHQ-GOCLAW-003", "BWHQ-AI-003" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/goclaw/planning/bwhq-goclaw-004-goclaw-planning-and-model-call.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/goclaw/planning/bwhq-goclaw-004-goclaw-planning-and-model-call.md" }, { "id": "BWHQ-GOCLAW-003", "title": "GoClaw secure context assembly", "summary": "Before planning, GoClaw assembles a bounded context package from the Inbox source and permitted records, relationships, activity, conversations, files, calendar, knowledge, and secured RAG under one authorization envelope.", "status": "specified", "authority": "high", "domain": "goclaw", "path": "knowledge/goclaw/secure-context/bwhq-goclaw-003-goclaw-secure-context-assembly.md", "tags": [ "goclaw", "context", "rag", "record-graph", "permissions" ], "related": [ "BWHQ-GOCLAW-002", "BWHQ-AI-002", "BWHQ-DATA-001" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/goclaw/secure-context/bwhq-goclaw-003-goclaw-secure-context-assembly.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/goclaw/secure-context/bwhq-goclaw-003-goclaw-secure-context-assembly.md" }, { "id": "BWHQ-GOCLAW-008", "title": "GoClaw security and guardrails", "summary": "GoClaw inherits BuildWithHQ’s server-derived identity, tenant/location/DataRole permissions, AI-specific retrieval permissions, approval controls, secret boundaries, and audit requirements; it is never a privileged bypass.", "status": "specified", "authority": "high", "domain": "goclaw", "path": "knowledge/goclaw/security-and-guardrails/bwhq-goclaw-008-goclaw-security-and-guardrails.md", "tags": [ "goclaw", "security", "guardrails", "permissions", "audit" ], "related": [ "BWHQ-GOCLAW-001", "BWHQ-SEC-001", "BWHQ-AI-002" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/goclaw/security-and-guardrails/bwhq-goclaw-008-goclaw-security-and-guardrails.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/goclaw/security-and-guardrails/bwhq-goclaw-008-goclaw-security-and-guardrails.md" }, { "id": "BWHQ-GOCLAW-007", "title": "GoClaw team identity and supervision", "summary": "GoClaw workers can be represented as supervised team participants with explicit owning users, role membership, assignment rules, and operational state instead of anonymous system-wide bots.", "status": "specified", "authority": "high", "domain": "goclaw", "path": "knowledge/goclaw/team-supervision/bwhq-goclaw-007-goclaw-team-identity-and-supervision.md", "tags": [ "goclaw", "team", "identity", "supervision", "datarole" ], "related": [ "BWHQ-GOCLAW-001", "BWHQ-SEC-001" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/goclaw/team-supervision/bwhq-goclaw-007-goclaw-team-identity-and-supervision.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/goclaw/team-supervision/bwhq-goclaw-007-goclaw-team-identity-and-supervision.md" }, { "id": "BWHQ-GOCLAW-002", "title": "GoClaw Universal Inbox claim loop", "summary": "GoClaw work is intended to enter through the Universal Inbox, where eligible items are claimed, leased, heartbeated, and released under user/role permissions instead of being handled through a direct ungoverned inbound shortcut.", "status": "specified", "authority": "high", "domain": "goclaw", "path": "knowledge/goclaw/universal-inbox/bwhq-goclaw-002-goclaw-universal-inbox-claim-loop.md", "tags": [ "goclaw", "universal-inbox", "claim", "lease" ], "related": [ "BWHQ-GOCLAW-001", "BWHQ-SEC-001" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/goclaw/universal-inbox/bwhq-goclaw-002-goclaw-universal-inbox-claim-loop.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/goclaw/universal-inbox/bwhq-goclaw-002-goclaw-universal-inbox-claim-loop.md" }, { "id": "BWHQ-MKT-001", "title": "Template Library and marketplace", "summary": "The BuildWithHQ Template Library is a versioned software catalog for SaaS blueprints, feature templates, custom services, and AI harnesses with entitlements and exact-version installation.", "status": "current", "authority": "high", "domain": "marketplace", "path": "knowledge/marketplace/bwhq-mkt-001-template-library-and-marketplace.md", "tags": [ "templates", "marketplace", "versions", "entitlements" ], "related": [ "BWHQ-ARCH-004", "BWHQ-AI-004", "BWHQ-EXT-001" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/marketplace/bwhq-mkt-001-template-library-and-marketplace.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/marketplace/bwhq-mkt-001-template-library-and-marketplace.md" }, { "id": "BWHQ-OPS-001", "title": "Dedicated logging, audit, and evidence plane", "summary": "Each SaaS can maintain a separate logging/compliance database for append-oriented record changes, AI retrieval evidence, authorization context, custom-service events, and integrity-chain data.", "status": "current", "authority": "high", "domain": "operations", "path": "knowledge/operations/bwhq-ops-001-dedicated-logging-audit-and-evidence-plane.md", "tags": [ "logging", "audit", "compliance", "evidence" ], "related": [ "BWHQ-SEC-002", "BWHQ-SEC-003" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/operations/bwhq-ops-001-dedicated-logging-audit-and-evidence-plane.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/operations/bwhq-ops-001-dedicated-logging-audit-and-evidence-plane.md" }, { "id": "BWHQ-OPS-002", "title": "Domains, API clients, backups, integrations, and asynchronous operations", "summary": "Builder-facing domain, credential, backup, and integration changes use scoped stored procedures/services; long-running verification and execution work is asynchronous.", "status": "current", "authority": "high", "domain": "operations", "path": "knowledge/operations/bwhq-ops-002-domains-api-clients-backups-integrations-and-asynchronous-operations.md", "tags": [ "domains", "api-clients", "backups", "integrations" ], "related": [ "BWHQ-BUILDER-001", "BWHQ-SEC-003" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/operations/bwhq-ops-002-domains-api-clients-backups-integrations-and-asynchronous-operations.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/operations/bwhq-ops-002-domains-api-clients-backups-integrations-and-asynchronous-operations.md" }, { "id": "BWHQ-OPS-003", "title": "Stripe and billing source-of-truth boundaries", "summary": "BuildWithHQ reconciles Stripe payment/subscription state into SQL for entitlements and display while treating Stripe as authoritative for external payment objects and keeping end-SaaS billing separate from platform billing.", "status": "current", "authority": "high", "domain": "operations", "path": "knowledge/operations/bwhq-ops-003-stripe-and-billing-source-of-truth-boundaries.md", "tags": [ "stripe", "billing", "webhooks", "idempotency" ], "related": [ "BWHQ-BUILDER-001" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/operations/bwhq-ops-003-stripe-and-billing-source-of-truth-boundaries.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/operations/bwhq-ops-003-stripe-and-billing-source-of-truth-boundaries.md" }, { "id": "BWHQ-PROD-001", "title": "ActiveWorkplace", "summary": "ActiveWorkplace is a proposed workspace that pins a record and projects its permitted recursive relationship graph, participants, activity, work state, and AI collaborators into one active operational view.", "status": "specified", "authority": "medium", "domain": "product", "path": "knowledge/product/bwhq-prod-001-activeworkplace.md", "tags": [ "activeworkplace", "records", "graph", "collaboration" ], "related": [ "BWHQ-DATA-001", "BWHQ-SEC-001" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/product/bwhq-prod-001-activeworkplace.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/product/bwhq-prod-001-activeworkplace.md" }, { "id": "BWHQ-PROD-002", "title": "CompanyIQ", "summary": "CompanyIQ is a proposed permission-aware company intelligence layer that combines embedded company knowledge with operational data to surface answers, opportunities, and recurring insights.", "status": "concept", "authority": "medium", "domain": "product", "path": "knowledge/product/bwhq-prod-002-companyiq.md", "tags": [ "companyiq", "rag", "insights", "knowledge" ], "related": [ "BWHQ-AI-002", "BWHQ-AI-001" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/product/bwhq-prod-002-companyiq.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/product/bwhq-prod-002-companyiq.md" }, { "id": "BWHQ-SEC-001", "title": "Security invariants", "summary": "Security is designed as a shared structural layer: server-derived identity, one authorization path, explicit tenant/application/location scope, and separate permissions for read, AI, export, and sensitive disclosure.", "status": "current", "authority": "highest", "domain": "security", "path": "knowledge/security/bwhq-sec-001-security-invariants.md", "tags": [ "security", "authorization", "identity", "permissions" ], "related": [ "BWHQ-SEC-002", "BWHQ-SEC-003", "BWHQ-AI-002", "BWHQ-EXT-003" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/security/bwhq-sec-001-security-invariants.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/security/bwhq-sec-001-security-invariants.md" }, { "id": "BWHQ-SEC-002", "title": "Replayable authorization and tamper-evident evidence", "summary": "BuildWithHQ’s security design aims to preserve enough historical authorization state and logged evidence to reconstruct whether past sensitive access was valid.", "status": "current", "authority": "high", "domain": "security", "path": "knowledge/security/bwhq-sec-002-replayable-authorization-and-tamper-evident-evidence.md", "tags": [ "audit", "replay", "temporal", "evidence" ], "related": [ "BWHQ-OPS-001", "BWHQ-AI-002" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/security/bwhq-sec-002-replayable-authorization-and-tamper-evident-evidence.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/security/bwhq-sec-002-replayable-authorization-and-tamper-evident-evidence.md" }, { "id": "BWHQ-SEC-003", "title": "Secure fields, secrets, and disclosure", "summary": "Sensitive values can be structurally excluded from normal search/AI paths, with decryption or disclosure treated as a separate privileged and auditable operation.", "status": "current", "authority": "high", "domain": "security", "path": "knowledge/security/bwhq-sec-003-secure-fields-secrets-and-disclosure.md", "tags": [ "encryption", "secrets", "disclosure", "ai-exclusion" ], "related": [ "BWHQ-SEC-001", "BWHQ-OPS-001" ], "html_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/security/bwhq-sec-003-secure-fields-secrets-and-disclosure.html", "markdown_url": "https://buildwithhq.com/BuildWithHQ_Knowledge_Catalog_v0.1/knowledge/security/bwhq-sec-003-secure-fields-secrets-and-disclosure.md" } ] }