Examples
Examples
Section titled “Examples”Real-world examples of SCS bundles and SCDs from the official repository.
Bundle Examples by Type
Section titled “Bundle Examples by Type”1. Meta Bundle
Section titled “1. Meta Bundle”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
2. Standards Bundles
Section titled “2. Standards Bundles”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
3. Domain Bundle
Section titled “3. Domain Bundle”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
4. Concern Bundles
Section titled “4. Concern Bundles”Functional area standards within a company. Each concern bundle is owned by a specific executive role (Chief Architect, CISO, CMO, etc.).
Available Examples:
- Architecture - System design, tech stack, integrations
- Security - Authentication, data protection, threat model
- Performance & Reliability - Response time, availability, fault tolerance
- Compliance & Governance - Regulatory requirements
- Data & Provenance - Data model, lineage, retention
- Testing & Validation - Test coverage, QA procedures
- Deployment & Operations - Infrastructure, observability
- Usability & Accessibility - UX principles, accessibility
- Safety & Risk - Risk assessment, safety checklists
- Ethics & AI Accountability - AI usage policy, audit trails
- Business Context - Company mission, values, stakeholders
5. Project Bundle
Section titled “5. Project Bundle”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)
Complete Examples
Section titled “Complete Examples”Healthcare: Medication Adherence System
Section titled “Healthcare: Medication Adherence System”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:
How to Use These Examples
Section titled “How to Use These Examples”1. Browse on GitHub
Section titled “1. Browse on GitHub”Explore the examples directly:
# View all bundleshttps://github.com/tim-mccrimmon/structured-context-spec/tree/main/core/examples/bundles
# View all SCDshttps://github.com/tim-mccrimmon/structured-context-spec/tree/main/core/examples2. Clone and Explore Locally
Section titled “2. Clone and Explore Locally”# Clone the repositorygit clone https://github.com/tim-mccrimmon/structured-context-spec.gitcd structured-context-spec/core/examples
# Explore bundle structuretree bundles/
# Validate an example bundlescs validate bundles/project-bundle.yaml3. Use as Templates
Section titled “3. Use as Templates”Copy and customize examples for your own projects:
# Start with an examplecp core/examples/bundles/concerns/architecture.yaml \ my-project/bundles/my-architecture.yaml
# Edit to match your systemvim my-project/bundles/my-architecture.yaml
# Validate your changesscs validate my-project/bundles/my-architecture.yamlIndustry-Specific Examples
Section titled “Industry-Specific Examples”Healthcare
Section titled “Healthcare”- HIPAA Compliance: Privacy rule, security rule, breach notification
- Clinical Context: Patient safety, care protocols
- Use Case: Prior authorization, patient portals, clinical documentation
Financial Services
Section titled “Financial Services”- SOC2 Compliance: Trust Services Criteria
- Regulatory: PCI-DSS, SOX standards
- Use Case: Banking apps, payment systems, financial reporting
SaaS Products
Section titled “SaaS Products”- Compliance: GDPR, SOC2, data privacy
- Architecture: Multi-tenancy, scalability, availability
- Use Case: B2B SaaS platforms, API services
Community Examples
Section titled “Community Examples”Have an example to share? We’d love to see how you’re using SCS!
- 💬 Share on GitHub Discussions
- 📝 Submit a PR to add your example
- 🐛 Report Issues
Next Steps
Section titled “Next Steps”- Create Your Own Bundle - Step-by-step guide
- Validate Context - Ensure correctness
- View Specification - Technical details
- Quick Start - Get up and running