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 detailBronze Level (Starter)
Minimum: 12 core documents
Bronze level establishes your fundamental business foundation.
Required Documents
- VSN - Vision: Where are you going?
- MSN - Mission: Why do you exist?
- STR - Strategy: How will you get there?
- VAL - Values: What principles guide you?
- OBJ - Objectives: What are your goals?
- CUS - Customer: Who do you serve?
- PRD - Product: What do you offer?
- REV - Revenue Model: How do you make money?
- OPS - Operations: How do you deliver?
- ORG - Organization: How are you structured?
- FIN - Financial Plan: What are your numbers?
- 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:
Strategic Foundation (3+)
- VSN, MSN, STR minimum
Market Environment (2+)
- Example: MKT, CMP
Customer Value (2+)
- Example: PER, USE
Product & Service (2+)
- Example: PRD, FEA
Business Model (2+)
- Example: REV, PRI
Operations & Execution (3+)
- Example: OPS, PRO, TEA
Technology & Data (2+)
- Example: ARC, API
Financial & Investment (2+)
- Example: FIN, BUD
Risk & Governance (2+)
- Example: RSK, GOV
Growth & Innovation (2+)
- Example: INN, EXP
Learning & Decisions (1+)
- Example: DEC
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:
# 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)
- Start with Strategic Foundation (VSN, MSN, STR, VAL)
- Add Customer and Product (CUS, PRD)
- Define Business Model (REV)
- Document Operations (OPS, ORG)
- Add Financial and Risk (FIN, RSK)
From Bronze to Silver (Month 1-3)
- Expand each domain to 2+ documents
- Add missing domains (all 12 must be covered)
- Define relationships between documents
- Validate and refine existing documents
- Add stakeholder reviews
From Silver to Gold (Month 3-6)
- Deep dive into each domain
- Add detailed operational documents
- Create comprehensive relationship graphs
- Implement regular review cycles
- Build living documentation culture
Best Practices
- Start Small: Begin with Bronze, expand progressively
- Quality Over Quantity: 12 great documents beat 50 mediocre ones
- Relationships Matter: Connect documents with depends_on/enables
- Keep Current: Set review cycles, update regularly
- Use Templates: Generate from templates for consistency
- Validate Often: Run validation after every change
- Build Incrementally: Add 1-2 documents per week
- Involve Stakeholders: Get input from document owners
Conformance Report Example
{
"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
- View All Document Types
- Learn about Document Structure
- Read the Full Specification
- Get started with the CLI Tool

