{"id":50619364,"url":"https://github.com/TheWayWithin/BOS-AI","last_synced_at":"2026-06-23T05:00:29.131Z","repository":{"id":310292006,"uuid":"1038816926","full_name":"TheWayWithin/BOS-AI","owner":"TheWayWithin","description":"The Business Operating System AI (BOS-AI) Framework","archived":false,"fork":false,"pushed_at":"2026-05-10T14:16:57.000Z","size":8580,"stargazers_count":4,"open_issues_count":1,"forks_count":1,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-10T16:19:03.269Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/TheWayWithin.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"docs/contributing/repository-structure.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-08-15T21:50:45.000Z","updated_at":"2026-05-10T14:17:01.000Z","dependencies_parsed_at":"2025-09-02T12:32:33.810Z","dependency_job_id":null,"html_url":"https://github.com/TheWayWithin/BOS-AI","commit_stats":null,"previous_names":["thewaywithin/bos-ai"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/TheWayWithin/BOS-AI","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheWayWithin%2FBOS-AI","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheWayWithin%2FBOS-AI/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheWayWithin%2FBOS-AI/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheWayWithin%2FBOS-AI/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/TheWayWithin","download_url":"https://codeload.github.com/TheWayWithin/BOS-AI/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/TheWayWithin%2FBOS-AI/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34675970,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-23T02:00:07.161Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-06-06T10:00:20.063Z","updated_at":"2026-06-23T05:00:29.110Z","avatar_url":"https://github.com/TheWayWithin.png","language":"Shell","funding_links":[],"categories":["Business Operating Systems"],"sub_categories":[],"readme":"# BOS-AI: Your AI-Powered Business Operating System\n\n![BOS-AI Banner](https://img.shields.io/badge/BOS--AI-v2.0-blue?style=for-the-badge)\n![Agents](https://img.shields.io/badge/Agents-30-orange?style=for-the-badge)\n![Status](https://img.shields.io/badge/Status-Production-success?style=for-the-badge)\n\n**BOS-AI runs your business. You focus on vision.**\n\nTransform your business through the Business Chassis multiplication effect. 30 specialized AI agents handle strategy, marketing, sales, customer service, and finance—so you can focus on what matters.\n\n---\n\n## Quick Start\n\n```bash\nmkdir ~/my-business \u0026\u0026 cd ~/my-business \u0026\u0026 git init\ncurl -fsSL https://raw.githubusercontent.com/TheWayWithin/BOS-AI/main/deployment/scripts/install.sh | bash -s full\nclaude code .\n/coord optimize\n```\n\nThat's it. BOS-AI analyzes your business and identifies your biggest opportunity.\n\n---\n\n## Choose Your Path\n\n### Running a Business?\n\nYou don't need technical skills. BOS-AI helps you with strategy, marketing, sales, and operations.\n\n**Start here:** [Business Operations Guide](docs/getting-started/business-guide.md)\n\n### Building a Product?\n\nCreate your requirements in BOS-AI, then build with AGENT-11.\n\n**Start here:** [Product Developer Guide](docs/getting-started/developer-guide.md)\n\n**NEW: Enhanced PRD Template** - Machine-parsable PRDs with System Skeleton (data model, UI sitemap, business rules) for seamless AGENT-11 handoff. See [PRD Template](docs/Document%20Library/Foundation/Product%20Requirements%20Document%20(PRD).md).\n\n---\n\n## The Business Chassis\n\nEvery business runs on six multipliers:\n\n```\nProfit = Prospects × Lead Conversion × Client Conversion × Average Spend × Transaction Frequency × Margin\n```\n\n**The Multiplication Effect:**\n- 10% improvement in each = **77% more profit**\n- 20% improvement in each = **299% more profit**\n\nBOS-AI optimizes all six multipliers systematically.\n\n**Learn more:** [Business Chassis Explained](docs/concepts/business-chassis.md)\n\n---\n\n## Essential Commands\n\n| Command | What It Does |\n|---------|--------------|\n| `/coord optimize` | Find your biggest business opportunity |\n| `/coord foundation-quick-start` | Build strategic foundation (3-4 hours) |\n| `/coord marketing-system-setup` | Create complete marketing framework |\n| `/coord sales-system-setup` | Create complete sales framework |\n| `/meeting @agent \"topic\"` | Consult with specific specialist |\n| `/report` | Generate progress report |\n| `/dailyreport` | Turn `progress.md` into a daily report plus voice-aligned blog and social posts |\n| `/blog \u003ctopic\u003e` | Draft a voice-aligned blog post plus Twitter/X and LinkedIn versions on any topic |\n\n`/dailyreport` and `/blog` are Claude-native — no API keys, no per-report cost. Both\ncommands share a single voice guide at `.claude/data/voice-guide-default.md`. Drop a\n`voice-guide.md` in your project root to override with your own voice, or set\n`DAILYREPORT_VOICE_GUIDE` to point anywhere.\n\n---\n\n## The Four Operations Systems\n\nBuild a complete business operating system in 13-17 hours:\n\n| System | Time | What You Get | Command |\n|--------|------|--------------|---------|\n| **Marketing** | 4-5 hours | Bible, Plan, Calendar | `/coord marketing-system-setup` |\n| **Sales** | 3-4 hours | Bible, Plan | `/coord sales-system-setup` |\n| **Customer Service** | 3-4 hours | Bible, Plan | `/coord customer-service-system-setup` |\n| **Finance** | 3-4 hours | Bible, Plan | `/coord finance-system-setup` |\n\nEach system multiplies specific Business Chassis components for exponential growth.\n\n---\n\n## 30 Specialized Agents\n\nBOS-AI includes 30 business intelligence agents organized by function:\n\n| Category | Agents | Focus |\n|----------|--------|-------|\n| **Coordination** | 3 | Business orchestration, optimization |\n| **Discovery** | 3 | Market research, opportunity validation |\n| **Creation** | 3 | Solution design, value optimization |\n| **Delivery** | 3 | Customer success, quality assurance |\n| **Growth** | 3 | Scaling, market expansion, revenue |\n| **Marketing** | 3 | Brand, campaigns, content |\n| **Sales** | 3 | Pipeline, conversion, revenue ops |\n| **Customer Service** | 3 | Support, satisfaction, retention |\n| **Finance** | 3 | Budget, performance, investment |\n| **Legal** | 3 | Compliance, risk, contracts |\n\n**Full catalog:** [Agent Directory](docs/agents/README.md)\n\n---\n\n## The BOS-AI Lifecycle\n\n```\n┌──────────────┐    ┌──────────────┐    ┌──────────────┐    ┌──────────────┐\n│   STAGE 1    │    │   STAGE 2    │    │   STAGE 3    │    │   STAGE 4    │\n│  Foundation  │───▶│   Creation   │───▶│   Delivery   │───▶│    Growth    │\n│              │    │              │    │              │    │              │\n│ • Vision     │    │ • Solution   │    │ • Marketing  │    │ • Scale      │\n│ • Research   │    │ • Design     │    │ • Sales      │    │ • Expand     │\n│ • Strategy   │    │ • Build      │    │ • Service    │    │ • Optimize   │\n└──────────────┘    └──────────────┘    └──────────────┘    └──────────────┘\n        │                                                           │\n        └────────────────── CONTINUOUS IMPROVEMENT ─────────────────┘\n```\n\n**Learn more:** [BOS-AI Lifecycle](docs/concepts/lifecycle.md)\n\n---\n\n## BOS-AI vs AGENT-11\n\n| BOS-AI | AGENT-11 |\n|--------|----------|\n| Business operations | Software development |\n| 30 business agents | 11 technical agents |\n| Creates PRDs and strategy | Writes code and deploys |\n| Defines WHAT to build | Implements HOW to build |\n\n**They work together but are separate projects.**\n\nWhen you need software built:\n1. Create PRD in BOS-AI\n2. Hand off to AGENT-11 project\n3. Return to BOS-AI for operations\n\n---\n\n## Installation Options\n\n### Standard Install\n\nOne command — downloads and runs the installer:\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/TheWayWithin/BOS-AI/main/deployment/scripts/install.sh | bash -s full\n```\n\nYou'll see progress output as it installs. When it finishes, all 30 agents are ready.\n\n### Inspect Before Running (Optional, More Secure)\n\nIf you want to review the install script before executing it, do this in three steps:\n\n```bash\n# 1. Download the script (this command prints nothing — that's normal)\ncurl -fsSL https://raw.githubusercontent.com/TheWayWithin/BOS-AI/main/deployment/scripts/install.sh -o /tmp/bos-ai-install.sh\n\n# 2. Review it (press q to exit the viewer)\nless /tmp/bos-ai-install.sh\n\n# 3. Run it\nbash /tmp/bos-ai-install.sh full\n```\n\n### Pin to a Specific Version\n\nLock the install to a tagged release:\n\n```bash\nBOS_AI_VERSION=v1.0.0 curl -fsSL https://raw.githubusercontent.com/TheWayWithin/BOS-AI/main/deployment/scripts/install.sh | bash -s full\n```\n\nSet `BOS_AI_VERSION` to any git tag (e.g. `v1.0.0`) to install that exact release.\n\n### MCP-Enhanced Install\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/TheWayWithin/BOS-AI/main/deployment/scripts/install-with-mcp.sh | bash -s full\n```\n\nAdds direct API connections for 40-60% faster operations. Requires API key configuration.\n\n**Troubleshooting:** [Installation Issues](docs/troubleshooting/installation.md)\n\n---\n\n## Security\n\nReport vulnerabilities privately via [GitHub Security Advisories](https://github.com/TheWayWithin/BOS-AI/security/advisories/new).\n\n- No API keys or secrets in the repo — all credentials load from `.env.mcp` (gitignored)\n- Install scripts use `set -euo pipefail`, validate paths, and refuse system directories\n- `.env.mcp` parsed as key=value pairs, never `source`d as shell code\n- Pin installs to a tagged release with `BOS_AI_VERSION=v1.0.0`\n- Recommended install pattern downloads the script for inspection before running\n\n---\n\n## Documentation\n\n### Getting Started\n- [Business Operations Guide](docs/getting-started/business-guide.md) - For business operators\n- [Product Developer Guide](docs/getting-started/developer-guide.md) - For product builders\n- [Your First Mission](docs/getting-started/first-mission.md) - Guided walkthrough\n\n### Core Concepts\n- [Business Chassis](docs/concepts/business-chassis.md) - The multiplication framework\n- [BOS-AI Lifecycle](docs/concepts/lifecycle.md) - The four stages\n- [Philosophy](docs/concepts/philosophy.md) - Design principles\n\n### Reference\n- [Quick Reference Card](docs/reference/quick-reference.md) - Command cheat sheet\n- [Directory Structure](docs/reference/directory-structure.md) - Project organization\n- [Agent Directory](docs/agents/README.md) - All 30 agents\n- [Mission Catalog](docs/missions/README.md) - All available missions\n\n### Operations\n- [Operations Library](docs/OPERATIONS-LIBRARY.md) - Complete frameworks\n- [Foundation Workflows](docs/workflows/foundation/) - Setup guides\n\n### PRD System\n- [PRD Template](docs/Document%20Library/Foundation/Product%20Requirements%20Document%20(PRD).md) - Enhanced machine-parsable template (v3.1)\n- [PRD Creation SOP](docs/Document%20Library/Foundation/PRD%20Creation%20SOP.md) - Creation process with Auto/Engaged modes\n- [Design Playbook Template](docs/Document%20Library/Foundation/Design%20Playbook%20Template.md) - Technical preferences\n- [Migration Guide](docs/reference/prd/PRD%20v3.1%20Migration%20Guide.md) - Upgrade from legacy PRDs\n\n### Troubleshooting\n- [Installation Issues](docs/troubleshooting/installation.md) - Setup problems\n- [FAQ](docs/troubleshooting/faq.md) - Common questions\n\n---\n\n## Quick Reference\n\n### Most Common Workflows\n\n**Starting a new business:**\n```bash\n/coord foundation-quick-start    # 3-4 hours\n/coord marketing-system-setup    # 4-5 hours\n/coord sales-system-setup        # 3-4 hours\n```\n\n**Optimizing existing business:**\n```bash\n/coord optimize                  # 15 minutes - find opportunity\n/meeting @agent \"specific topic\" # Deep dive with specialist\n```\n\n**Building a product:**\n```bash\n/coord solution-design \"idea\"    # Create PRD\n# Then hand off to AGENT-11 project for development\n```\n\n### The Formula\n\n```\nProfit = Prospects × Lead Conversion × Client Conversion × Average Spend × Transaction Frequency × Margin\n```\n\n10% improvement in each = **77% more profit**\n\n### Quick Commands\n\n| Command | Purpose |\n|---------|---------|\n| `/coord optimize` | Find biggest opportunity |\n| `/coord daily` | Daily business review |\n| `/coord weekly` | Weekly performance analysis |\n| `/meeting @agent \"topic\"` | Specialist consultation |\n| `/report` | Progress report |\n| `/pmd \"issue\"` | Root cause analysis |\n\n---\n\n## Need Help?\n\n- **Quick diagnostic:** `/pmd \"describe your issue\"`\n- **Installation problems:** [Troubleshooting Guide](docs/troubleshooting/installation.md)\n- **Common questions:** [FAQ](docs/troubleshooting/faq.md)\n- **Full documentation:** [CLAUDE.md](CLAUDE.md)\n\n---\n\n## Success Path\n\n| Milestone | Time | What You Achieve |\n|-----------|------|------------------|\n| First `/coord optimize` | 15 min | Identify biggest opportunity |\n| Foundation documents | 3-4 hours | Strategic clarity |\n| One operations system | 3-5 hours | Execution framework |\n| All four systems | 13-17 hours | Complete business OS |\n| **90 days** | Ongoing | **77%+ profit potential** |\n\n---\n\n**Ready to transform your business?**\n\n```bash\n/coord optimize\n```\n\n---\n\n[Business Guide](docs/getting-started/business-guide.md) | [Developer Guide](docs/getting-started/developer-guide.md) | [Full Documentation](CLAUDE.md)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTheWayWithin%2FBOS-AI","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FTheWayWithin%2FBOS-AI","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FTheWayWithin%2FBOS-AI/lists"}