Skip to Content

business-as-code

npm version License: MIT

Define, launch, experiment, iterate, and grow your business entirely in code

Overview

business-as-code enables organizations to represent their businesses and processes in code for human-AI collaboration. Unlike ai-business which focuses on AI-only businesses, this package provides interfaces for integrating human roles, AI agents, and defining collaboration points between them.

Installation

npm install business-as-code
# or
yarn add business-as-code
# or
pnpm add business-as-code

Usage

Creating a Business with Human-AI Collaboration

import { Business } from 'business-as-code'
import { Human } from 'humans.do'
import { Agent } from 'agents.do'
import { Workflow } from 'workflows.do'
 
// Create human roles
class CEO extends Human {}
class CTO extends Human {}
class MarketingManager extends Human {}
 
// Create AI agents
class DataAnalyst extends Agent {}
class CustomerSupportAgent extends Agent {}
 
// Create business processes
class CustomerOnboarding extends Workflow {}
class ProductDevelopment extends Workflow {}
 
// Define your business
const myCompany = Business({
  name: 'Acme Corporation',
  url: 'https://acme.com',
  vision: 'To revolutionize industry X with innovative solutions',
  goals: [
    {
      objective: 'Increase market share by 20%',
      keyResults: ['Launch 3 new products', 'Expand to 2 new geographical markets', 'Increase customer retention by 15%'],
    },
  ],
  // Human roles
  roles: {
    ceo: CEO,
    cto: CTO,
    marketingManager: MarketingManager,
  },
  // AI agents
  agents: {
    dataAnalyst: DataAnalyst,
    customerSupport: CustomerSupportAgent,
  },
  // Organizational structure
  departments: {
    engineering: {
      name: 'Engineering Department',
      lead: CTO,
      members: [DataAnalyst],
    },
    marketing: {
      name: 'Marketing Department',
      lead: MarketingManager,
      members: [],
    },
  },
  // Business processes
  processes: {
    customerOnboarding: CustomerOnboarding,
    productDevelopment: ProductDevelopment,
  },
})
 
// Event handling
myCompany.on('new_customer', (data) => {
  // Trigger customer onboarding workflow
  console.log(`New customer: ${data.name}`)
})
 
// Scheduled operations
myCompany.every('day', () => {
  // Daily operations
  console.log('Performing daily operations')
})
 
// Task assignment
myCompany.assign('Analyze quarterly sales data', myCompany.agents.dataAnalyst)
myCompany.assign('Review marketing strategy', myCompany.roles.marketingManager)
 
// Track business metrics
myCompany.track('customer_satisfaction', 4.8)
myCompany.track('monthly_revenue', 125000)

Differences from ai-business

While ai-business focuses on AI-driven business functions, business-as-code is designed specifically for representing existing organizations with both human employees and AI agents:

Featurebusiness-as-codeai-business
Primary focusHuman-AI collaborationAI-driven business functions
Organizational modelComprehensive (roles, departments)Limited (focused on functions)
Human rolesExplicit role definitionsNot specifically modeled
Decision approvalBuilt-in approval workflowsAutomated decision making
Task assignmentSupports both humans and AIPrimarily AI-focused
IntegrationDesigned for existing org systemsStandalone AI capabilities

Key Design Considerations

1. Organizational hierarchy

// Define departments with reporting lines
const company = Business({
  departments: {
    engineering: {
      name: 'Engineering',
      lead: CTO,
      members: [SeniorEngineer, JuniorEngineer, AICodeReviewer],
    },
  },
})

2. Human-AI collaboration points

// AI can suggest changes that require human approval
company.on('content_suggestion', (suggestion, approver) => {
  // Request approval from human
  approver.requestApproval(suggestion)
})

3. Task assignment

// Assign tasks based on nature and complexity
function assignTask(task) {
  if (task.requiresCreativity) {
    company.assign(task, company.roles.humanCreative)
  } else if (task.isRepetitive) {
    company.assign(task, company.agents.automationAgent)
  }
}

4. Event handling differences

// Human events may require notifications
company.on('urgent_issue', (issue) => {
  if (issue.assignee instanceof Human) {
    sendNotification(issue.assignee)
  } else {
    // AI can handle immediately
    issue.assignee.handle(issue)
  }
})

5. Permission workflows

// AI can draft but needs human approval for publishing
company.agents.contentWriter.setPermission('content.publish', 'suggest')
company.roles.contentManager.setPermission('content.publish', 'approve')

6. System integration

// Connect with existing organizational systems
company.integrate('crm', {
  endpoint: 'https://crm.company.com/api',
  handlers: {
    // Map events between systems
    'crm:new_customer': (data) => company.trigger('new_customer', data),
  },
})

7. Role guidelines

// Define when to use humans vs AI
const roleGuidelines = {
  customer_complaints: {
    simple: company.agents.customerSupport,
    complex: company.roles.customerSuccessManager,
    criteria: (complaint) => (complaint.sentiment < -0.8 ? 'complex' : 'simple'),
  },
}

API Reference

Functions

  • Business(config) - Creates a new business representation

Types

  • BusinessConfig - Configuration for creating a business
  • BusinessInstance - Instance returned by the Business function
  • PermissionLevel - Enum for permission levels (VIEW, SUGGEST, EXECUTE, APPROVE, ADMIN)
  • Task - Interface for task assignments
  • BusinessEvent - Interface for business events

Business Instance Methods

  • on(event, handler) - Register event handler
  • every(schedule, operation) - Register scheduled operation
  • assign(task, to) - Assign a task to a human or AI
  • track(metric, value) - Track business metrics

Dependencies

Business-as-Code