Skip to content

Conformance Levels

BSpec defines three conformance levels that help organizations progressively build comprehensive business specifications.

Overview

Bronze (Starter)     → 12+ documents  → Core foundation
Silver (Professional) → 25+ documents  → Full coverage
Gold (Comprehensive)  → 45+ documents  → Deep detail

Bronze Level (Starter)

Minimum: 12 core documents

Bronze level establishes your fundamental business foundation.

Required Documents

  1. VSN - Vision: Where are you going?
  2. MSN - Mission: Why do you exist?
  3. STR - Strategy: How will you get there?
  4. VAL - Values: What principles guide you?
  5. OBJ - Objectives: What are your goals?
  6. CUS - Customer: Who do you serve?
  7. PRD - Product: What do you offer?
  8. REV - Revenue Model: How do you make money?
  9. OPS - Operations: How do you deliver?
  10. ORG - Organization: How are you structured?
  11. FIN - Financial Plan: What are your numbers?
  12. RSK - Risk Assessment: What could go wrong?

Benefits

  • Clear strategic direction
  • Basic business model understanding
  • Foundation for growth
  • Investor/stakeholder clarity

Typical For

  • Startups
  • Small businesses
  • New initiatives
  • MVP documentation

Silver Level (Professional)

Minimum: 25 documents across all domains

Silver level provides comprehensive coverage of your business.

Required Coverage

Must include documents from all 12 domains:

  1. Strategic Foundation (3+)

    • VSN, MSN, STR minimum
  2. Market Environment (2+)

    • Example: MKT, CMP
  3. Customer Value (2+)

    • Example: PER, USE
  4. Product & Service (2+)

    • Example: PRD, FEA
  5. Business Model (2+)

    • Example: REV, PRI
  6. Operations & Execution (3+)

    • Example: OPS, PRO, TEA
  7. Technology & Data (2+)

    • Example: ARC, API
  8. Financial & Investment (2+)

    • Example: FIN, BUD
  9. Risk & Governance (2+)

    • Example: RSK, GOV
  10. Growth & Innovation (2+)

    • Example: INN, EXP
  11. Learning & Decisions (1+)

    • Example: DEC
  12. Brand & Marketing (2+)

    • Example: BRD, MSG

Benefits

  • Complete business view
  • All critical areas covered
  • Ready for scale
  • Professional documentation

Typical For

  • Growing companies
  • Series A+ startups
  • SMB with structure
  • Organizations seeking investment

Gold Level (Comprehensive)

Minimum: 45+ documents with deep coverage

Gold level provides detailed documentation across all business areas.

Required Coverage

Expanded Coverage Across All Domains:

  • Strategic Foundation: 5+ documents
  • Market Environment: 5+ documents
  • Customer Value: 5+ documents
  • Product & Service: 5+ documents
  • Business Model: 4+ documents
  • Operations & Execution: 5+ documents
  • Technology & Data: 3+ documents
  • Financial & Investment: 4+ documents
  • Risk & Governance: 3+ documents
  • Growth & Innovation: 3+ documents
  • Learning & Decisions: 2+ documents
  • Brand & Marketing: 4+ documents

Benefits

  • Deep operational detail
  • Complete knowledge graph
  • Full audit trail
  • Enterprise-grade documentation
  • AI-ready knowledge base

Typical For

  • Enterprise organizations
  • Public companies
  • Regulated industries
  • Complex operations
  • Organizations with compliance requirements

Industry Profiles

BSpec provides industry-specific profiles with recommended documents:

Software/SaaS Profile

Priority Documents:

  • VSN, MSN, STR, VAL, OBJ (Strategic)
  • PRD, FEA, API, UXD (Product)
  • REV, PRI, CST (Business Model)
  • ARC, SYS, SEC (Technology)
  • BRD, MSG, SEO (Marketing)

Physical Products Profile

Priority Documents:

  • VSN, MSN, STR, PUR (Strategic)
  • PRD, QUA, SUP (Product)
  • CHN, VND, FAC (Operations)
  • INV, FOR, CST (Financial)
  • MKT, SEG, CMP (Market)

Service Business Profile

Priority Documents:

  • VSN, MSN, VAL (Strategic)
  • SVC, SLA, SUP (Service)
  • CUS, PER, CJM (Customer)
  • PRO, WFL, TEA (Operations)
  • BRD, MSG, CAM (Marketing)

Nonprofit Profile

Priority Documents:

  • MSN, VAL, PUR, THY (Purpose)
  • STO, PAI, CIN (Impact)
  • FND, BUD, REP (Financial)
  • GOV, ETH, COM (Governance)
  • CAM, SOC, CNT (Communications)

Conformance Calculator

Check your conformance level:

bash
# Using CLI
bspec analyze docs/

# Using TypeScript SDK
import { analyzeConformance } from '@bspec/sdk'
const analysis = analyzeConformance(documents)
console.log(`Level: ${analysis.level}`)
console.log(`Coverage: ${analysis.coverage}%`)

Progression Strategy

From Zero to Bronze (Week 1-2)

  1. Start with Strategic Foundation (VSN, MSN, STR, VAL)
  2. Add Customer and Product (CUS, PRD)
  3. Define Business Model (REV)
  4. Document Operations (OPS, ORG)
  5. Add Financial and Risk (FIN, RSK)

From Bronze to Silver (Month 1-3)

  1. Expand each domain to 2+ documents
  2. Add missing domains (all 12 must be covered)
  3. Define relationships between documents
  4. Validate and refine existing documents
  5. Add stakeholder reviews

From Silver to Gold (Month 3-6)

  1. Deep dive into each domain
  2. Add detailed operational documents
  3. Create comprehensive relationship graphs
  4. Implement regular review cycles
  5. Build living documentation culture

Best Practices

  1. Start Small: Begin with Bronze, expand progressively
  2. Quality Over Quantity: 12 great documents beat 50 mediocre ones
  3. Relationships Matter: Connect documents with depends_on/enables
  4. Keep Current: Set review cycles, update regularly
  5. Use Templates: Generate from templates for consistency
  6. Validate Often: Run validation after every change
  7. Build Incrementally: Add 1-2 documents per week
  8. Involve Stakeholders: Get input from document owners

Conformance Report Example

json
{
  "level": "Silver",
  "documentCount": 28,
  "coverage": 34.1,
  "domainCoverage": {
    "strategic-foundation": 4,
    "market-environment": 3,
    "customer-value": 3,
    "product-service": 4,
    "business-model": 3,
    "operations-execution": 4,
    "technology-data": 2,
    "financial-investment": 2,
    "risk-governance": 1,
    "growth-innovation": 1,
    "learning-decisions": 1,
    "brand-marketing": 0
  },
  "missingForNextLevel": [
    "brand-marketing domain needs 2+ documents"
  ],
  "recommendations": [
    "Add BRD and MSG to reach Gold level",
    "Expand risk-governance to 2+ documents"
  ]
}

Next Steps

Released under the MIT License.