# Examples and implementation patterns

Learn from maintained source and fixtures, then adapt the smallest pattern that demonstrates the behavior you need.

Source snapshot: bcc79fcc27c4d801c2119bef81ddcce7b4e86498

## Choose by the behavior you need

Begin with a concrete job: define a first operation, inspect an approval boundary, render a data grid, retrieve knowledge safely or compose a feature. The minimal package exposes a user contract, feature, example entry and handler-oriented source. DataGridShowcase is the registry’s canonical table showcase. Other examples cover agent, integration, workflow and domain scenarios. Read the declared surfaces and prerequisites before choosing; a broad registry helps discovery, while a focused walkthrough should explain the important decisions and failure cases.

Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/registry/README.md
Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/minimal/README.md

## Use the catalog without loading every runtime

The examples module provides metadata-only catalog discovery and a separate runtime surface for rich template previews. Apps render specific examples through named host ports rather than directly importing example packages across the layer boundary. Rich UI is loaded only where the package exposes the appropriate surface. This separation makes a catalog card, source link, runtime fixture and interactive preview distinct deliverables. The 91 example-directory workspaces in the package inventory also include registry/shared/test support, so they are not 91 independently qualified product demos.

Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/registry/README.md
Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/minimal/README.md

## Adapt an evidence-bearing pattern

For each selected example, identify the exact contract, handler, adapter, data source and host behavior. List what remains supplied by the surrounding product: identity, persistence, provider credentials, authority, UI shell or background execution. Preserve useful negative cases such as invalid input, denied scope or missing provider. Source presence establishes an inspectable pattern; it does not establish public package installation, an executed fixture, a successful provider call or production readiness. Keep those evidence states visible when publishing an example page.

Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/registry/README.md
Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/minimal/README.md

## Read the smallest complete slice

Open the example’s declared entry and feature, follow one operation into its handler, and identify the selected transport or UI. Compare its manifest to the actual available files before copying a capability claim.

Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/registry/README.md
Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/minimal/README.md

## Reproduce within the declared scope

Use the example package’s actual scripts and prerequisites from its package reference. Record the source/package versions and which checks ran. Keep external-provider and deployment qualification separate from local deterministic behavior.

Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/registry/README.md
Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/minimal/README.md

## Adapt one boundary at a time

Replace the fixture’s store, authority, provider or host with your intended implementation while retaining the contract behavior and relevant negative cases. Link the resulting product guide to the source pattern and state the additional dependencies you introduced.

Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/registry/README.md
Source: https://github.com/lssm-tech/contractspec/blob/bcc79fcc27c4d801c2119bef81ddcce7b4e86498/examples/minimal/README.md

## Packages

- [@lssm-tech/example.shim-delete-ci](https://lssm.co/docs/packages/example.shim-delete-ci/): CI test that verifies promoted symbols are importable from canonical locations (B2/B3). When this test passes it is safe to delete the example shims.
- [@lssm-tech/example.agent-application-foundation](https://lssm.co/docs/packages/example.agent-application-foundation/): Reference applications showing how to compose durable ContractSpec agents.
- [@lssm-tech/example.agent-console](https://lssm.co/docs/packages/example.agent-console/): Agent Console example - AI agent orchestration with tools, runs, and logs
- [@lssm-tech/example.agent-workflow-command-center](https://lssm.co/docs/packages/example.agent-workflow-command-center/): Agent Workflow Command Center - All-in-one operator cockpit for supervised AI agents in business workflows
- [@lssm-tech/example.ai-chat-assistant](https://lssm.co/docs/packages/example.ai-chat-assistant/): Focused AI chat assistant template with MCP tools, reasoning, chain of thought, sources, and suggestions.
- [@lssm-tech/example.ai-support-bot](https://lssm.co/docs/packages/example.ai-support-bot/): AI support bot example: classify and resolve a support ticket using @lssm-tech/lib.support-bot.
- [@lssm-tech/example.analytics-dashboard](https://lssm.co/docs/packages/example.analytics-dashboard/): Analytics Dashboard example with widgets and query engine for ContractSpec
- [@lssm-tech/example.app-submission-readiness-mobile-proof](https://lssm.co/docs/packages/example.app-submission-readiness-mobile-proof/): Deterministic ReviewReady proof that audits the real brownfield Expo app packages/apps/mobile-monolith.
- [@lssm-tech/example.authos-command-center](https://lssm.co/docs/packages/example.authos-command-center/): Rich AuthOS command center template for identity, MFA, organizations, Better Auth bridge planning, and Connect with LSSM.
- [@lssm-tech/example.authos-user-relation-graph](https://lssm.co/docs/packages/example.authos-user-relation-graph/): Entity-relation graph example built on Layer-2 defineContractEntity + defineContractEdge — RBAC structure (User ↔ Role ↔ Resource)
- [@lssm-tech/example.billingos-france-sme](https://lssm.co/docs/packages/example.billingos-france-sme/): Smallest BillingOS French SME quote-to-cash replay proof without providers or production PA submission.
- [@lssm-tech/example.calendar-google](https://lssm.co/docs/packages/example.calendar-google/): Google Calendar integration example: list and create events.
- [@lssm-tech/example.communication-os](https://lssm.co/docs/packages/example.communication-os/): Standalone CommunicationOS examples, fixtures, and replay proof for external adopter flows.
- [@lssm-tech/example.companyos-ai-os-proofs](https://lssm.co/docs/packages/example.companyos-ai-os-proofs/): CompanyOS AI OS deterministic sandbox proofs for generic, EngineeringOS, support-to-product, and Incident Brain scenarios.
- [@lssm-tech/example.companyos-ai-solutions-engineer-poc](https://lssm.co/docs/packages/example.companyos-ai-solutions-engineer-poc/): Deterministic provider-free CompanyOS request-to-verified-proof example with explicit approvals and loopback-only evidence.
- [@lssm-tech/example.companyos-communicationos-operating-cockpit](https://lssm.co/docs/packages/example.companyos-communicationos-operating-cockpit/): Deterministic combined CompanyOS and CommunicationOS operating cockpit example for governed conversation-to-work loops.
- [@lssm-tech/example.companyos-gtm-learning-loop-conformance](https://lssm.co/docs/packages/example.companyos-gtm-learning-loop-conformance/): Vertical-neutral, no-network composed conformance fixture for the GTM Learning Loop, plus two fake research-provider adapters for Harness scenario execution.
- [@lssm-tech/example.companyos-knowledge-graph](https://lssm.co/docs/packages/example.companyos-knowledge-graph/): Runtime managed-graph example consuming CompanyOS ManagedGraphNode/Edge via DataViewGraphSpec
- [@lssm-tech/example.companyos-product-engineering-loop](https://lssm.co/docs/packages/example.companyos-product-engineering-loop/): Deterministic CompanyOS V1 operating review replay using public spec and pure runtime APIs.
- [@lssm-tech/example.companyos-voiceops-workbench](https://lssm.co/docs/packages/example.companyos-voiceops-workbench/): Deterministic CompanyOS VoiceOps workbench example adapted from the Hackathon Voice AI UI/UX ingest lane.
- [@lssm-tech/example.content-generation](https://lssm.co/docs/packages/example.content-generation/): Content generation example using @lssm-tech/lib.content-gen.
- [@lssm-tech/example.contract-graph](https://lssm.co/docs/packages/example.contract-graph/): Static build-time graph example for ContractSpec: contracts → events → presentations, reusing graph-artifacts link kinds
- [@lssm-tech/example.creator-platform-ai-native](https://lssm.co/docs/packages/example.creator-platform-ai-native/): Inspect the package guide, declared imports and source relationships.
- [@lssm-tech/example.creator-platform-foundation](https://lssm.co/docs/packages/example.creator-platform-foundation/): Credential-free reference composition for the creator-platform bundle.
- [@lssm-tech/example.crm-pipeline](https://lssm.co/docs/packages/example.crm-pipeline/): CRM Pipeline - Contacts, Companies, Deals, Tasks
- [@lssm-tech/example.data-fetching-ecosystem](https://lssm.co/docs/packages/example.data-fetching-ecosystem/): UX wiring proof: useContractQuery → QueryState → design-system components, all lifecycle states.
- [@lssm-tech/example.data-grid-showcase](https://lssm.co/docs/packages/example.data-grid-showcase/): Focused data-grid example for ContractSpec table capabilities
- [@lssm-tech/example.draft-and-send-agent](https://lssm.co/docs/packages/example.draft-and-send-agent/): CommunicationOS-shaped draft-and-send reference agent: draft a message, wait for approval, then send it through an approval-gated ContractSpec operation.
- [@lssm-tech/example.email-gmail](https://lssm.co/docs/packages/example.email-gmail/): Gmail integration example: inbound threads and outbound messages.
- [@lssm-tech/example.feature-hub-composition](https://lssm.co/docs/packages/example.feature-hub-composition/): Deterministic all-nine Feature Hub composition reference for web and React Native hosts.
- [@lssm-tech/example.finance-ops-ai-workflows](https://lssm.co/docs/packages/example.finance-ops-ai-workflows/): Deterministic finance operations AI workflow example with human review, fixed rules, and synthetic data only.
- [@lssm-tech/example.form-showcase](https://lssm.co/docs/packages/example.form-showcase/): Focused ContractSpec form example and template covering field kinds, conditional rules, and layout flows.
- [@lssm-tech/example.gamification-campaign](https://lssm.co/docs/packages/example.gamification-campaign/): Cross-vertical finance campaign using ContractSpec gamification primitives.
- [@lssm-tech/example.graph-showcase](https://lssm.co/docs/packages/example.graph-showcase/): Interactive graph-richness showcase for ContractSpec P6 primitives: mini-map, focus-mode, custom renderers, edge labels, animations, and drilldown.
- [@lssm-tech/example.gtm-provider-recipes](https://lssm.co/docs/packages/example.gtm-provider-recipes/): Inspect the package guide, declared imports and source relationships.
- [@lssm-tech/example.harness-lab](https://lssm.co/docs/packages/example.harness-lab/): Focused harness example for ContractSpec scenarios, suites, orchestration, and runtime adapters.
- [@lssm-tech/example.in-app-docs](https://lssm.co/docs/packages/example.in-app-docs/): Example showing how to use DocBlock for in-app documentation for non-technical users
- [@lssm-tech/example.integration-hub](https://lssm.co/docs/packages/example.integration-hub/): Integration Hub example with sync engine and field mappings for ContractSpec
- [@lssm-tech/example.integration-paypal](https://lssm.co/docs/packages/example.integration-paypal/): Credential-free PayPal commerce integration example with deterministic policy handoffs.
- [@lssm-tech/example.integration-posthog](https://lssm.co/docs/packages/example.integration-posthog/): PostHog analytics integration example: capture events, run HogQL, and manage feature flags.
- [@lssm-tech/example.integration-stripe](https://lssm.co/docs/packages/example.integration-stripe/): Integration example – Stripe Payments (blueprint + workflow + tenant config).
- [@lssm-tech/example.integration-supabase](https://lssm.co/docs/packages/example.integration-supabase/): Integration example - Supabase vector store + Postgres database wiring.
- [@lssm-tech/example.kb-update-pipeline](https://lssm.co/docs/packages/example.kb-update-pipeline/): Example: KB update automation pipeline with HITL review and auditability.
- [@lssm-tech/example.knowledge-canon](https://lssm.co/docs/packages/example.knowledge-canon/): Knowledge example – Product Canon space (blueprint + tenant config + source sample + runtime helper).
- [@lssm-tech/example.learning-journey-ambient-coach](https://lssm.co/docs/packages/example.learning-journey-ambient-coach/): Ambient coach learning journey example with contextual tips and follow-up actions.
- [@lssm-tech/example.learning-journey-crm-onboarding](https://lssm.co/docs/packages/example.learning-journey-crm-onboarding/): Learning journey track that onboards users to the CRM pipeline example.
- [@lssm-tech/example.learning-journey-duo-drills](https://lssm.co/docs/packages/example.learning-journey-duo-drills/): Drill-based learning journey example with SRS, XP, and streak hooks.
- [@lssm-tech/example.learning-journey-managed-onboarding](https://lssm.co/docs/packages/example.learning-journey-managed-onboarding/): Standalone managed onboarding reference proof for Learning Journey scenarios.
- [@lssm-tech/example.learning-journey-platform-tour](https://lssm.co/docs/packages/example.learning-journey-platform-tour/): Learning journey track covering ContractSpec platform primitives.
- [@lssm-tech/example.learning-journey-quest-challenges](https://lssm.co/docs/packages/example.learning-journey-quest-challenges/): Time-bound quest/challenge learning journey example.
- [@lssm-tech/example.learning-journey-registry](https://lssm.co/docs/packages/example.learning-journey-registry/): Registry that aggregates learning journey example tracks.
- [@lssm-tech/example.learning-journey-studio-onboarding](https://lssm.co/docs/packages/example.learning-journey-studio-onboarding/): Learning journey track for first 30 minutes in ContractSpec Studio.
- [@lssm-tech/example.learning-journey-ui-coaching](https://lssm.co/docs/packages/example.learning-journey-ui-coaching/): Contextual coaching UI with tip cards and engagement tracking.
- [@lssm-tech/example.learning-journey-ui-gamified](https://lssm.co/docs/packages/example.learning-journey-ui-gamified/): Duolingo-style gamified learning UI for drills and quests.
- [@lssm-tech/example.learning-journey-ui-onboarding](https://lssm.co/docs/packages/example.learning-journey-ui-onboarding/): Developer onboarding UI with checklists and journey maps.
- [@lssm-tech/example.learning-journey-ui-shared](https://lssm.co/docs/packages/example.learning-journey-ui-shared/): Shared UI components and hooks for learning journey mini-apps.
- [@lssm-tech/example.learning-patterns](https://lssm.co/docs/packages/example.learning-patterns/): Example: drills + ambient coach + quests learning patterns, powered by Learning Journey (event-driven, deterministic).
- [@lssm-tech/example.lifecycle-cli](https://lssm.co/docs/packages/example.lifecycle-cli/): Lifecycle CLI demo (example): run lifecycle assessment without an HTTP server.
- [@lssm-tech/example.lifecycle-dashboard](https://lssm.co/docs/packages/example.lifecycle-dashboard/): Lifecycle dashboard example (snippet): how to call lifecycle-managed APIs and render a status card.
- [@lssm-tech/example.locale-jurisdiction-gate](https://lssm.co/docs/packages/example.locale-jurisdiction-gate/): Example: enforce locale + jurisdiction + kbSnapshotId + allowed scope for assistant calls (fail-closed).
- [@lssm-tech/example.managed-companyos-contract-editions](https://lssm.co/docs/packages/example.managed-companyos-contract-editions/): Managed CompanyOS contract edition lifecycle proof across specs, storage, runtime wiring, integrations, and examples.
- [@lssm-tech/example.marketplace](https://lssm.co/docs/packages/example.marketplace/): Marketplace example with orders, payouts, and reviews for ContractSpec
- [@lssm-tech/example.meeting-recorder-providers](https://lssm.co/docs/packages/example.meeting-recorder-providers/): Meeting recorder provider example: list meetings, transcripts, and webhooks.
- [@lssm-tech/example.messaging-agent-actions](https://lssm.co/docs/packages/example.messaging-agent-actions/): Safe messaging agent actions example with fixed intents, allowlisted actions, workflow dispatch, and deterministic replies.
- [@lssm-tech/example.messaging-app](https://lssm.co/docs/packages/example.messaging-app/): Thin messaging app example that composes reusable CommunicationOS messaging UI with deterministic fixture data.
- [@lssm-tech/example.minimal](https://lssm.co/docs/packages/example.minimal/): Minimal reference project demonstrating a complete ContractSpec workflow.
- [@lssm-tech/example.openbanking-powens](https://lssm.co/docs/packages/example.openbanking-powens/): OpenBanking Powens example: OAuth callback + webhook handler patterns (provider + workflows).
- [@lssm-tech/example.opencode-cli](https://lssm.co/docs/packages/example.opencode-cli/): Reference integration for using ContractSpec with the OpenCode CLI.
- [@lssm-tech/example.organization-planning-agenda](https://lssm.co/docs/packages/example.organization-planning-agenda/): Reference agenda workflow for ContractSpec organization-planning contracts.
- [@lssm-tech/example.osint-proof](https://lssm.co/docs/packages/example.osint-proof/): Inspect the package guide, declared imports and source relationships.
- [@lssm-tech/example.personalization](https://lssm.co/docs/packages/example.personalization/): Personalization examples: behavior tracking, overlay customization, workflow extension.
- [@lssm-tech/example.pipeline-reality-router-reference](https://lssm.co/docs/packages/example.pipeline-reality-router-reference/): Deterministic neutral Layer 1 reference harness over public CompanyOS Layer 0 exports.
- [@lssm-tech/example.pocket-family-office](https://lssm.co/docs/packages/example.pocket-family-office/): Pocket Family Office example - personal finance automation with open banking
- [@lssm-tech/example.policy-safe-knowledge-assistant](https://lssm.co/docs/packages/example.policy-safe-knowledge-assistant/): All-in-one template example: policy-safe knowledge assistant with locale/jurisdiction gating, versioned KB snapshots, HITL update pipeline, and learning hub.
- [@lssm-tech/example.product-intent](https://lssm.co/docs/packages/example.product-intent/): Product intent example: evidence ingestion and prompt-ready outputs.
- [@lssm-tech/example.project-management-sync](https://lssm.co/docs/packages/example.project-management-sync/): Project management sync example: Linear, Jira, and Notion work item creation.
- [@lssm-tech/module.examples](https://lssm.co/docs/packages/module.examples/): Example contract specifications collection
- [@lssm-tech/example.saas-boilerplate](https://lssm.co/docs/packages/example.saas-boilerplate/): SaaS Boilerplate - Users, Orgs, Projects, Billing, Settings
- [@lssm-tech/example.service-business-os](https://lssm.co/docs/packages/example.service-business-os/): Service Business OS example (clients, quotes, jobs, invoices) for ContractSpec
- [@lssm-tech/lib.example-shared-ui](https://lssm.co/docs/packages/lib.example-shared-ui/): Shared UI examples demonstrating reusable ContractSpec component composition.
- [@lssm-tech/example.special-ops-cockpit](https://lssm.co/docs/packages/example.special-ops-cockpit/): French fake-data Special Ops Cockpit template for mission dashboards, private daily journals, review workflows, playbooks, weekly reporting, AI governance, and roadmap planning.
- [@lssm-tech/example.team-hub](https://lssm.co/docs/packages/example.team-hub/): Team Hub example with spaces, tasks, rituals, and announcements
- [@lssm-tech/example.versioned-knowledge-base](https://lssm.co/docs/packages/example.versioned-knowledge-base/): Example: curated, versioned knowledge base with immutable sources, rule versions, and published snapshots.
- [@lssm-tech/example.video-api-showcase](https://lssm.co/docs/packages/example.video-api-showcase/): Generate API documentation videos from contract spec definitions using the ApiOverview composition.
- [@lssm-tech/example.video-docs-terminal](https://lssm.co/docs/packages/example.video-docs-terminal/): Generate terminal demo videos from CLI walkthroughs using the TerminalDemo composition and ScriptGenerator.
- [@lssm-tech/example.video-marketing-clip](https://lssm.co/docs/packages/example.video-marketing-clip/): Generate short-form marketing videos from content briefs using the video-gen pipeline.
- [@lssm-tech/example.visualization-showcase](https://lssm.co/docs/packages/example.visualization-showcase/): Focused visualization showcase for ContractSpec primitives and design-system wrappers
- [@lssm-tech/example.voice-providers](https://lssm.co/docs/packages/example.voice-providers/): Voice provider example: Gradium and Fal text-to-speech integration patterns.
- [@lssm-tech/example.voiceops-operating-graph](https://lssm.co/docs/packages/example.voiceops-operating-graph/): VoiceOps operating graph example: conversation → governed operating graph (DataViewGraphSpec canary replacing hackathon GraphCanvas)
- [@lssm-tech/example.wealth-snapshot](https://lssm.co/docs/packages/example.wealth-snapshot/): Wealth Snapshot mini-app for accounts, assets, liabilities, and goals
- [@lssm-tech/example.workflow-system](https://lssm.co/docs/packages/example.workflow-system/): Workflow and approval system example for ContractSpec - State machine with role-based transitions