Skip to content

Examples

Real-world examples of SCS bundles and SCDs from the official repository.


The foundational SCS specification language itself.

Example: meta-bundle.yaml

  • Contains foundational META SCDs that define the SCS specification language
  • All SCS projects import this bundle for consistent understanding
  • Includes: scd:meta:scd-meta, scd:meta:bundle-meta, scd:meta:domain-meta, scd:meta:validator-meta

External compliance and regulatory requirements.

Example: standards-bundle.yaml

  • Healthcare compliance example (HIPAA + SOC2)
  • Shows how to import external standard bundles
  • Includes HIPAA-specific SCDs for privacy, security, and breach notification

Company-wide knowledge aggregator that imports all concerns.

Example: software-development.yaml

  • Software Development domain bundle
  • Imports all 11 concern bundles (architecture, security, performance, etc.)
  • Shows the “build once, use everywhere” pattern

Functional area standards within a company. Each concern bundle is owned by a specific executive role (Chief Architect, CISO, CMO, etc.).

Available Examples:

Complete context for a specific project or initiative.

Example: project-bundle.yaml

  • Medication Adherence System example
  • Imports meta, standards, and domain bundles
  • Shows recursive import resolution (gets all context from imports)

A complete example showing all bundle types working together:

Medication Adherence System
├── Project Bundle (medication-adherence)
│ ├── imports: Meta Bundle
│ ├── imports: Standards Bundle (HIPAA + SOC2)
│ └── imports: Software Development Domain
│ └── imports: 11 Concern Bundles
│ ├── Architecture (system-context, tech-stack, integrations)
│ ├── Security (authn-authz, data-protection, threat-model)
│ ├── Performance & Reliability
│ ├── Compliance & Governance
│ └── ... (7 more concerns)

View the complete example:


Explore the examples directly:

Terminal window
# View all bundles
https://github.com/tim-mccrimmon/structured-context-spec/tree/main/core/examples/bundles
# View all SCDs
https://github.com/tim-mccrimmon/structured-context-spec/tree/main/core/examples
Terminal window
# Clone the repository
git clone https://github.com/tim-mccrimmon/structured-context-spec.git
cd structured-context-spec/core/examples
# Explore bundle structure
tree bundles/
# Validate an example bundle
scs validate bundles/project-bundle.yaml

Copy and customize examples for your own projects:

Terminal window
# Start with an example
cp core/examples/bundles/concerns/architecture.yaml \
my-project/bundles/my-architecture.yaml
# Edit to match your system
vim my-project/bundles/my-architecture.yaml
# Validate your changes
scs validate my-project/bundles/my-architecture.yaml

  • HIPAA Compliance: Privacy rule, security rule, breach notification
  • Clinical Context: Patient safety, care protocols
  • Use Case: Prior authorization, patient portals, clinical documentation
  • SOC2 Compliance: Trust Services Criteria
  • Regulatory: PCI-DSS, SOX standards
  • Use Case: Banking apps, payment systems, financial reporting
  • Compliance: GDPR, SOC2, data privacy
  • Architecture: Multi-tenancy, scalability, availability
  • Use Case: B2B SaaS platforms, API services

Have an example to share? We’d love to see how you’re using SCS!