BSpec v1.0.0 Specification
The Business Specification Standard (BSpec) v1.0.0 provides a universal language for describing any business as a structured, machine-readable knowledge graph.
Overview
BSpec defines 112 standardized document types across 12 comprehensive business domains. Each document type has a specific purpose, structure, and set of relationships that together form a complete picture of your business.
Core Principles
- Atomic Documents: Each document covers exactly one business concern
- Rich Relationships: Documents declare dependencies, enablements, and conflicts
- Machine-Readable: YAML frontmatter + Markdown content
- Human-Friendly: Clear structure and readable format
- AI-Ready: Structured for AI agents to understand and work with
12 Business Domains
1. Strategic Foundation
Fundamental strategic direction and purpose
- Vision (VSN), Strategy (STR), Mission (MSN)
- Values (VAL), Objectives (OBJ), Purpose (PUR)
- Theory of Change (THY), Motivation (MOT)
View all Strategic Foundation types →
2. Market Environment
External market dynamics and positioning
- Market Analysis (MKT), Segmentation (SEG), Competition (CMP)
- Economics (ECO), Trends (TRN), Regulation (REG)
- Opportunities (OPP), Positioning (POS), Threats (THR)
View all Market Environment types →
3. Customer Value
Customer understanding and value creation
- Customer Profiles (CUS), Personas (PER), Use Cases (USE)
- Customer Stories (STO), Pain Points (PAI), Fees & Pricing (FEE)
- Journey Maps (CJM), Surveys (SUR), Jobs to Be Done (JTB)
View all Customer Value types →
4. Product & Service
Product definitions and service offerings
- Product Requirements (PRD), Features (FEA), Services (SVC)
- Requirements (REQ), Quality Standards (QUA), UX Design (UXD)
- Roadmap (ROD), Integrations (INT), Support (SUP)
View all Product & Service types →
5. Business Model
Revenue model and value exchange
- Revenue Model (REV), Pricing (PRI), Cost Structure (CST)
- Value Stream (VST), Channels (CHN), Key Partners (KPT)
- Key Resources (KRS), Key Activities (KAC), Customer Segments (CUS)
View all Business Model types →
6. Operations & Execution
Operational processes and execution
- Operations Plan (OPS), Processes (PRO), Workflows (WFL)
- Organization (ORG), Team Structure (TEA), Roles (ROL)
- Policies (POL), Vendors (VND), Skills (SKI)
View all Operations & Execution types →
7. Technology & Data
Technology infrastructure and data management
- System Architecture (SYS), API Documentation (API), Data Model (DAT)
- Architecture (ARC), Development Plan (DEV), Infrastructure (INF)
- Security (SEC), Analytics (ANA)
View all Technology & Data types →
8. Financial & Investment
Financial planning and investment
- Financial Plan (FIN), Budget (BUD), Forecast (FOR)
- Funding (FND), Investment (INV), Valuation (VLU)
- Metrics (MET), Reports (REP), Tax (TAX), Audit (AUD)
View all Financial & Investment types →
9. Risk & Governance
Risk management and governance
- Risk Assessment (RSK), Governance (GOV), Compliance (COM)
- Insurance (INS), Incidents (INC), Controls (CTL)
- Legal (LEG), Ethics (ETH)
View all Risk & Governance types →
10. Growth & Innovation
Growth strategy and innovation
- Innovation (INN), Experimentation (EXP), R&D (RND)
- Future Vision (FUT), Leadership (LEA), Adaptation (ADT)
- Ignition Plan (IGN)
View all Growth & Innovation types →
11. Learning & Decisions
Learning and decision-making
- Decisions (DEC), Knowledge (KNO), Learning (LRN)
- Hypotheses (HYP), Retrospectives (RET), Wisdom (WIS)
View all Learning & Decisions types →
12. Brand & Marketing
Brand identity and marketing
- Brand (BRD), Messaging (MSG), Content (CNT)
- Campaigns (CAM), Social Media (SOC), SEO (SEO)
- Merchandising (MCH), Brand Positioning (BPO), Influence (IFL)
View all Brand & Marketing types →
Document Structure
Every BSpec document follows this standard structure:
---
# CORE IDENTITY
id: {TYPE}-{kebab-case-identifier}
type: {TYPE}
status: Draft|Review|Accepted|Deprecated
version: 1.0.0
# RELATIONSHIPS
depends_on: [document-ids]
enables: [document-ids]
conflicts_with: [document-ids]
# BUSINESS CONTEXT
domain: {domain-name}
priority: critical|high|medium|low
success_criteria: ["Measurable criteria"]
---
# Document Title
Content in Markdown format...Learn more about Document Structure →
Conformance Levels
BSpec defines three conformance levels:
- Bronze (Starter): 12+ core documents
- Silver (Professional): 25+ documents across all domains
- Gold (Comprehensive): 45+ documents with deep coverage
Learn more about Conformance Levels →
Getting Started
- Choose Your Documents: Start with Strategic Foundation (VSN, MSN, STR)
- Use Templates: Generate documents from templates using the CLI
- Define Relationships: Connect documents with depends_on, enables
- Validate: Use the SDKs to validate your documents
- Iterate: Build your specification incrementally
Tools & SDKs
- CLI Tool - Command-line interface
- TypeScript SDK - Type-safe JavaScript/TypeScript
- Python SDK - Pythonic with Pydantic models
- Go SDK - High-performance Go
- MCP Server - AI agent integration
Specification Files
The complete specification is available on GitHub:
- Full Specification: GitHub Repository
- Document Types: Browse all types
License
BSpec v1.0.0 is released under the MIT License.
Support
- Documentation: https://bspec.dev/docs
- GitHub: a3tai/bspec
- Issues: Report bugs
- Discussions: Ask questions