oneie/README.md

🤝 ONE Personal Collaborative Intelligence - Creates personalized AI workspace from your me.md profile. Simple: npx oneie → edit me.md → generate personalized agents, workflows & missions. From students to enterprises, ONE adapts to your context.

# 🤯 ONE - MySpace with AI Agents

> **Remember MySpace? Now imagine it with AI agents.**

**ONE is your fully customizable space where you live with your AI agents, brand everything as yours, and express your digital identity through AI collaboration.**

[![npm version](https://img.shields.io/npm/v/oneie.svg)](https://www.npmjs.com/package/oneie)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![Deploy](https://img.shields.io/badge/Deploy-Cloudflare%20%2B%20Convex-orange.svg)](https://cloudflare.com)

## 🎯 Your Space. Your Agents. Your Rules.

```
MySpace (2003): Your Space on the Internet
ONE (2025): Your Space with AI Agents

MySpace had: Top 8 Friends        →  ONE has: Top 8 Agents
MySpace had: Custom HTML/CSS      →  ONE has: Custom Agent Personalities
MySpace had: Profile Songs        →  ONE has: AI Conversations
MySpace had: Tom as first friend  →  ONE has:
Personal Assistant as first agent
```

## ⚡ Dead Simple Setup (Mission-1 Implementation)

```bash
# Single command creates your complete AI space
npx oneie

# Edit ONE file to regenerate everything
/me/me.md    # Your single source of truth

# Then use with Claude Code:
/one:generate    # Regenerates your entire space from me.md
/one:publish     # Deploy globally to Cloudflare + Convex
/one             # Your beautiful MySpace-style dashboard
```

**That's literally it.** From your `/me/me.md` file, you get:

- 🏗️ **Complete Scaffold**: Full `.one/` ontology structure created
- 🎨 **Brand Application**: Your theme, colors, voice applied everywhere
- 🤖 **Top 8 Agents**: Your customized AI dream team with your personality
- 🌊 **Cascade Workflows**: Mission → Story → Task → Agent flows auto-generated
- 🌐 **Space Visiting**: Others can visit and interact with your AI space
- 🛒 **Template Marketplace**: Monetize your successful configurations
- ☁️ **Global Deployment**: Cloudflare + Convex + Claude Code SDK
- 🔄 **One-File Regeneration**: Edit me.md → everything updates

## 🏗️ Mission-1: Single Source Architecture

### Edit One File → Regenerate Everything

```javascript
// Mission-1 eliminates complexity through unified orchestration
const Mission1 = {
  // SINGLE SOURCE: One file controls everything
  source: "/me/me.md",

  // SCAFFOLD: Complete ontology structure auto-created
  scaffold: {
    ".one/spaces/default/": "Your customizable space",
    ".one/agents/": "Global 43+ agent library",
    ".one/missions/": "Auto-generated from your goals",
    ".one/stories/": "Spawned from missions",
    ".one/tasks/": "Broken down from stories",
    ".one/templates/": "Mission/story/task templates",
    ".one/checklists/": "R.O.C.K.E.T. quality validation",
    ".one/hooks/": "Automated organization & validation",
  },

  // GENERATION: Everything flows from me.md
  workflow: "me.md → /one:generate → complete space",

  // DEPLOYMENT: One command global deployment
  deployment: "Cloudflare + Convex + Claude Code SDK",
  accessibility: "12-year-old to Fortune 500",
};
```

### Mission-1 Scaffold Structure (Auto-Generated)

```
your-project/  # Created by npx oneie
├── me/
│   ├── me.md          # 🎯 SINGLE SOURCE: Edit this, everything updates
│   ├── assets/        # Your logos, images, themes
│   └── templates/     # Your custom templates
├── .one/              # 🏗️ SCAFFOLD: Complete ontology structure
│   ├── spaces/
│   │   └── default/   # Your primary space (customizable)
│   │       ├── config.yaml      # Generated from me.md
│   │       ├── agents/          # Your Top 8 + space-specific
│   │       ├── missions/        # Auto-generated from goals
│   │       └── workflows/       # Cascade orchestration
│   ├── agents/        # Global 43+ agent library
│   ├── templates/     # Mission/story/task templates
│   ├── checklists/    # R.O.C.K.E.T. quality validation
│   ├── hooks/         # Auto-organization & validation
│   ├── apps/          # Multi-platform applications
│   │   ├── web/       # Next.js (Cloudflare Pages)
│   │   ├── mobile/    # React Native
│   │   └── desktop/   # Electron
│   └── packages/      # Shared libraries
│       ├── one/       # ONE UI (ShadCN-based)
│       ├── ui/        # Base components
│       └── types/     # TypeScript definitions
```

## 🎨 Your `/me/me.md` - Single Source Configuration

```yaml
# Edit this file → Run /one:generate → Everything regenerates

company:
  name: "Your Company"
  tagline: "Your space. Your agents. Your rules."

brand:
  theme: "professional" # executive | classic-myspace | cyberpunk | kid
  colors: ["#2563EB", "#64748B", "#FFFFFF"]
  voice: "friendly, professional, helpful"

top_agents:
  - name: "Personal Assistant"
    role: "Digital twin and coordinator"
    personality: "Professional, proactive, organized"

  - name: "Growth Hacker"
    role: "Lead generation specialist"
    personality: "Data-driven, creative, growth-obsessed"

  - name: "Content Creator"
    role: "Multi-platform content creation"
    personality: "Creative, engaging, brand-consistent"

  # ... 5 more agents (your Top 8)

spaces:
  - id: "default"
    title: "My AI Universe"
    public: true
    features: ["visiting", "templates", "analytics"]

customers:
  segments:
    - name: "Content Creators"
      pains: ["inconsistent content", "no workflow"]
      outcomes: ["daily output", "monetizable systems"]
```

**Result:** Your entire space regenerates with your branding, agents, workflows, and goals.

## 🌊 Cascade Workflow System (Auto-Generated)

### Mission → Story → Task → Agent Flow

```bash
# Your me.md automatically generates:

🎯 MISSION: "Daily Content Creation"
├── 📖 STORY: "Morning Content Research"
│   ├── ✅ TASK: "Trend Analysis" → 🤖 Data Analyst
│   └── ✅ TASK: "Hook Generation" → 🤖 Content Creator
├── 📖 STORY: "Content Production"
│   ├── ✅ TASK: "Draft Writing" → 🤖 Content Creator
│   └── ✅ TASK: "Visual Design" → 🤖 Brand Designer
└── 📖 STORY: "Distribution & Analytics"
    ├── ✅ TASK: "Multi-Platform Publishing" → 🤖 Growth Hacker
    └── ✅ TASK: "Performance Tracking" → 🤖 Data Analyst
```

### Quality Gates at Every Level

```javascript
const QualityGates = {
  mission: "4.0+ stars required before story spawning",
  story: "4.0+ stars required before task breakdown",
  task: "4.0+ stars required before agent assignment",
  agent: "4.0+ stars required before completion",

  validation: "R.O.C.K.E.T. framework + ontology compliance",
};
```

### Social Features

```bash
/one:visit @sarah    # Visit Sarah's space
/one:export --template --price $99    # Monetize your config
/one:marketplace     # Browse successful setups
```

## 🚀 Mission-1 Commands

### Essential Commands

```bash
# Setup (one-time)
npx oneie                    # Create scaffold + /me/me.md

# Development cycle
/one:generate               # Read me.md → regenerate everything
/one:dev                    # Run locally with hot reload
/one:validate               # R.O.C.K.E.T. + ontology validation

# Deployment
/one:publish                # Deploy to Cloudflare + Convex
/one:status                 # Check deployment status

# Social features
/one:spaces                 # List/create/select spaces
/one:visit @username        # Visit other spaces
/one:export --template      # Export your config as template
/one:marketplace            # Browse/buy/sell templates

# Customization
/one:theme cyberpunk        # Switch themes instantly
/one:agents                 # Edit Top 8, sync with me.md
```

### Universal Examples

```bash
# 12-year-old:
echo "I want to build a game" >> me/me.md
/one:generate  # → Game dev mission + agents auto-created

# Fortune 500:
echo "Optimize customer acquisition funnel" >> me/me.md
/one:generate  # → Enterprise workflows + compliance agents
```

### Powered By Mission-1 Architecture

- **🏗️ Unified Scaffold**: Complete `.one/` ontology structure
- **🧠 Claude Code SDK**: 43+ agents with cascade intelligence
- **⚡ Cloudflare Edge**: Sub-100ms global deployment
- **📊 Convex**: Real-time cascade synchronization
- **🎨 ShadCN**: Themed UI components
- **🔄 Single Source**: `/me/me.md` → everything regenerates

## 🔥 Why This Changes Everything

### The MySpace Magic Returns

```
What made MySpace special:
✓ Complete customization freedom
✓ Express your unique identity
✓ Social discovery and connection
✓ Creator economy (bands, artists)
✓ Your space, your rules

What makes ONE better:
✓ All of the above PLUS
✓ AI agents that actually help you succeed
✓ Templates that make you money
✓ Global deployment infrastructure
✓ Universal accessibility (any age, any scale)
```

### From Zero to Hero in Minutes

```javascript
const SuccessStory = {
  day_0: "Install ONE, customize space",
  day_1: "Deploy first AI agents",
  day_7: "Generate first leads/revenue",
  day_30: "Scale with template marketplace",
  day_90: "Build sustainable AI-powered business",
};
```

## 🎯 Perfect For

### Individuals

- **Creators**: Build your AI-powered brand
- **Entrepreneurs**: Launch with AI co-founders
- **Students**: Learn with AI tutors
- **Anyone**: Express yourself through AI

### Teams

- **Startups**: Scale faster with AI agents
- **Agencies**: Deliver better results for clients
- **Enterprises**: Transform how work gets done
- **Communities**: Collaborate through AI

### Industries

- **Marketing**: AI-powered campaigns and content
- **Development**: AI-assisted coding and architecture
- **Sales**: AI sales team that never sleeps
- **Design**: AI creative collaborator

## 🛠️ Technical Excellence

### Modern Stack

```javascript
const TechStack = {
  frontend: "Next.js + ShadCN + Tailwind",
  backend: "Convex + Claude Code SDK",
  deployment: "Cloudflare Pages + Workers",
  mobile: "React Native (optional)",
  desktop: "Electron (optional)",

  philosophy: "Simple blocks, infinite possibilities",
};
```

### Performance

- **🚀 Sub-100ms**: Global loading via Cloudflare Edge
- **📱 Universal**: Web, mobile, desktop from one codebase
- **🔒 Secure**: Enterprise-grade security by default
- **💰 Cost-Effective**: Pay-per-use scaling

## 🌟 Get Started (Mission-1 Workflow)

### 1. Install & Scaffold

```bash
npx oneie
# Creates complete .one/ structure + /me/me.md template
```

### 2. Configure Once

```bash
# Edit your single source file
vim me/me.md

# Add your company, brand, agents, goals
# Everything else generates automatically
```

### 3. Generate & Deploy

```bash
/one:generate    # Regenerates entire space from me.md
/one:publish     # Deploy globally in seconds
/one:visit       # Share your space URL
```

### 4. Monetize & Scale

```bash
/one:export --template --price $199
/one:marketplace  # List in template marketplace
# Earn 70% revenue share from your successful configs
```

## 🤝 Community

### Join the Revolution

- **🌐 Website**: [one.ie](https://one.ie)
- **💬 Discord**: [discord.gg/oneie](https://discord.gg/oneie)
- **🐦 Twitter**: [@oneie](https://twitter.com/oneie)
- **📧 Email**: hello@one.ie

### Template Creators Welcome

- **💰 70% Revenue Share**: Higher than App Store
- **📈 Built-in Discovery**: Template marketplace exposure
- **🎨 Creator Tools**: Export and monetize your configurations
- **👥 Community**: Connect with other successful creators

## 📜 License

MIT - Build whatever you want, keep the rights.

---

## 🎭 The Bottom Line

**ONE gives you what you've been missing since MySpace died:**

- Complete customization freedom ✓
- Your digital identity expression ✓
- Social discovery and connection ✓
- Creator economy monetization ✓
- Your space, your rules ✓

**PLUS what MySpace never had:**

- AI agents that make you successful ✓
- Global deployment infrastructure ✓
- Universal accessibility ✓
- Modern tech stack ✓
- Infinite scalability ✓

---

**Mission-1 Complete: One file controls your entire AI universe.**

```bash
npx oneie           # Install scaffold
vim me/me.md        # Edit your config
/one:generate       # Regenerate everything
/one:publish        # Deploy globally
```

**Your space IS a cascade. Edit once, deploy everywhere.** 🌊