oneie/one/things/claude/commands/one.md

Build apps, websites, and AI agents in English. Zero-interaction setup for AI agents (Claude Code, Cursor, Windsurf). Download to your computer, run in the cloud, deploy to the edge. Open source and free forever.

---
title: One
dimension: things
category: agents
tags: agent, ai, events
related_dimensions: events, knowledge
scope: global
created: 2025-11-03
updated: 2025-11-03
version: 1.0.0
ai_context: |
  This document is part of the things dimension in the agents category.
  Location: one/things/claude/commands/one.md
  Purpose: Documents /one - test-driven vision cascade intelligence platform
  Related dimensions: events, knowledge
  For AI agents: Read this to understand one.
---

# /one - Test-Driven Vision CASCADE Intelligence Platform

🌟 **Transform Ideas into Exponentially Growing Realities**

_Agent ONE orchestrates your Test-First Idea → Vision → Missions → Stories → Events → Tasks cascade through 112+ AI agents with comprehensive validation. Simple, clear design optimized for all screen sizes._

## Core Interface

When the `/one` command is invoked, display this main menu:

```
╔══════════════════════════════════════════════════════════════════╗
║                                                                  ║
║    ██████╗ ███╗   ██╗███████╗    Bring your ideas to life        ║
║   ██╔═══██╗████╗  ██║██╔════╝                                    ║
║   ██║   ██║██╔██╗ ██║█████╗      https://one.ie                  ║
║   ██║   ██║██║╚██╗██║██╔══╝                                      ║
║   ╚██████╔╝██║ ╚████║███████╗    npx oneie                       ║
║    ╚═════╝ ╚═╝  ╚═══╝╚══════╝                                    ║
║                                                                  ║
╚══════════════════════════════════════════════════════════════════╝

🏆 **CASCADE STATUS** - Test-Driven Excellence Achieved ✅
   ✨ Mission 1 COMPLETE: Test-Driven CASCADE (4.4/5.0⭐) | 18-Step Workflow
   🧪 95%+ Test Coverage | 🎯 100% Quality Gates | 🚀 99.7% Reliability
   🤖 112+ Validated Agents | 🔄 Real-Time Monitoring | 📊 ML-Powered Testing

🚀 **QUICK START** (Turn Ideas into Reality)
   1. Start New Idea        → Transform any idea into exponential success
   2. Build Your Vision     → Create powerful vision aligned with goals
   3. Launch Big Mission    → Strategic campaigns for massive impact
   4. Create Great Stories  → Engaging narratives that drive execution
   5. Get Things Done       → Execute with 112+ AI agents

🤖 **AI COMMAND CENTER** (Your Personal Board of Directors)
   6. Vision Architect      → Transform rough ideas into crystal-clear visions
   7. Mission Commander     → Turn visions into winning strategic campaigns
   8. Story Teller         → Create compelling narratives that inspire action
   9. Task Master          → Coordinate 112+ agents for flawless execution

🔬 **SPECIALIST TEAMS** (Domain Experts)
   A. Marketing & Growth    → Viral content, lead generation (15 agents)
   B. Engineering & Tech    → Architecture, development, QA (18 agents)
   C. Research & Analytics  → Market intelligence, data analysis (16 agents)
   D. Quality & Testing     → Test automation, documentation, improvement

⚙️  **ADVANCED FEATURES** (Power Users)
   T. Template Library      → 37 interactive CASCADE templates
   W. Workflow Builder      → Custom test-driven workflows
   S. System Settings      → Quality gates & validation configuration

❓ **LEARN & EXPLORE**
   H. Test-First Tutorials  → Master the CASCADE methodology
   ?. Command Reference     → Complete test-driven interface guide

Enter your choice (1-9, A, T, W, S, H, ?): _
```

## Navigation Rules

### 1. Numbered Selection Pattern

- **Primary options**: 1-9 (consistent across all menus)
- **Advanced options**: Letters (A-Z)
- **Help options**: H, ?
- **Navigation**: B (Back), X (Exit)

### 2. Breadcrumb System

Always show current location:

```
ONE > Marketing > Content Creation > Blog Posts
                                            ↑ Current Location
```

### 3. Progressive Disclosure

- **Level 1**: Show most common actions (1-5)
- **Level 2**: Show specialist teams (6-9)
- **Level 3**: Show advanced features (A, T, W, S)
- **Level 4**: Show help and reference (H, ?)

## Menu Handlers

## Design Philosophy - Universal Clarity

### Simple, Clear Design Principles

- **Fixed Width Layout**: 76-character ASCII interface works perfectly on all screens
- **No Responsivity Needed**: Content fits mobile (320px+) and desktop without complex breakpoints
- **Information Density**: Optimal readability through consistent spacing and grouping
- **Progressive Disclosure**: Most important actions first (1-5), then specialist teams (6-9, A-D)
- **Single Command Flow**: Every action accessible through simple numbered selection
- **Visual Hierarchy**: ASCII art, emojis, and clear sectioning for instant comprehension
- **Mobile Optimized**: Vertical scrolling friendly with thumb-accessible number keys
- **Accessibility**: Screen reader friendly with descriptive text and logical navigation

### Quick Start Actions (1-5) - Behind the Scenes: Test-Driven Excellence

#### 1. Start New Idea

```yaml
action: launch_idea_creation_flow
display: |
  💡 **TURN YOUR IDEA INTO REALITY**

  Agent ONE helps transform any idea into exponential success:

  🌟 What kind of amazing thing do you want to build?

  1. Tech & Software        → Apps, websites, digital products
  2. Business & Services    → Companies, consulting, coaching  
  3. Creative & Content     → Art, writing, videos, courses
  4. Custom Project        → Tell me about your unique vision

  Behind the scenes: Agent ONE automatically validates market fit, 
  resources, and success potential while you focus on your vision.

  B. Back to Main Menu

  Choose your project type (1-4, B): _
```

#### 2. Build Your Vision

```yaml
action: launch_vision_creation_flow
display: |
  🌟 **CREATE YOUR POWERFUL VISION**

  Transform your ideas into a crystal-clear future you're excited about:

  ✨ Choose your vision focus:

  1. Personal Vision           → Define your values and goals (me/me.md)
  2. Company Vision           → Build your business foundation
  3. Industry Leadership      → Position for market dominance  
  4. Complete New Vision      → Start fresh with guided creation

  Agent ONE ensures perfect alignment between your personal values,
  business strategy, and market opportunities automatically.

  B. Back to Main Menu

  Choose your vision focus (1-4, B): _
```

#### 3. Launch Big Mission

```yaml
action: launch_mission_creation_flow
display: |
  🎯 **START YOUR GAME-CHANGING MISSION**

  Turn your vision into strategic campaigns that create massive impact:

  🚀 What big goal do you want to achieve?

  1. Business Growth           → Scale revenue, customers, market share
  2. Product Launch           → Bring new products/services to market  
  3. Content Empire           → Build viral content and audience
  4. Custom Mission           → Design your unique strategic campaign

  Agent ONE automatically ensures your mission aligns with your vision,
  has high success probability, and mobilizes your team effectively.

  B. Back to Main Menu

  Choose your mission type (1-4, B): _
```

#### 4. Create Great Stories

```yaml
action: launch_story_creation_flow
display: |
  📖 **CRAFT COMPELLING STORIES**

  Transform missions into engaging narratives that drive execution:

  ✨ What story do you want to tell?

  1. Active Stories           → Continue working on existing stories
  2. New Story from Mission   → Turn big mission into actionable story
  3. Story Templates         → Use proven story patterns
  4. Story Dashboard         → See all stories with progress

  Agent ONE ensures every story has clear acceptance criteria,
  technical feasibility, and delivers real user value automatically.

  B. Back to Main Menu

  Choose story action (1-4, B): _
```

#### 5. Get Things Done

```yaml
action: launch_task_execution_flow
display: |
  ✅ **EXECUTE WITH YOUR AI TEAM**

  Turn stories into reality with 112+ AI agents working for you:

  🚀 What needs to get done?

  1. High Impact Tasks       → Focus on game-changing work (3 ready)
  2. Quick Wins             → Build momentum with fast results (7 ready)
  3. Background Tasks       → Let AI handle routine work (12 running)  
  4. New Task               → Create something from scratch
  5. Team Dashboard         → See your AI agents in action

  Agent ONE coordinates everything with quality gates and real-time
  monitoring, so you get 4.0+ star results every time.

  B. Back to Main Menu

  Choose execution focus (1-5, B): _
```

### Specialist Teams (6-9)

#### 6. Marketing & Growth

```yaml
action: show_marketing_team
redirect_to: marketing_team_menu
```

#### 7. Engineering & Tech

```yaml
action: show_engineering_team
redirect_to: engineering_team_menu
```

#### 8. Research & Analytics

```yaml
action: show_research_team
redirect_to: research_team_menu
```

#### 9. Quality & Testing

```yaml
action: show_quality_team
display: |
  🧪 **QUALITY & TESTING SPECIALISTS**

  CASCADE Quality System Agents:

  1. Tester Agent           → Automated test generation specialist (>80% coverage)
  2. Documenter Agent       → Documentation automation (75% onboarding reduction)
  3. Improver Agent         → Quality enhancement cycles (<30min improvements)
  4. Engineering QA         → Code quality validation & security audit
  5. Quality Assurance      → Multi-dimensional quality analysis
  6. Performance Analyst    → System performance optimization
  7. Compliance Manager     → Standards & regulatory compliance
  8. View All Quality Tools → Complete quality system overview

  B. Back to Main Menu

  Choose agent (1-8, B): _
```

### Advanced Options (A, T, W, S)

#### A. Agent Directory

```yaml
action: show_full_agent_directory
display: |
  🤖 **COMPLETE AGENT DIRECTORY** (112+ Specialists)

  Filter by Team:
  1. Marketing (15 agents)      6. Quality & Testing (7 agents) ✨NEW✨
  2. Engineering (18 agents)    7. Education (6 agents)  
  3. Content (14 agents)        8. Intelligence (10 agents)
  4. Research (16 agents)       9. Crypto Specialists (21 agents)
  5. Sales (12 agents)          A. All Agents (A-Z)

  Featured CASCADE Agents:
  T. Tester Agent              → >80% automated test coverage
  D. Documenter Agent          → 75% onboarding time reduction  
  I. Improver Agent            → <30min quality enhancement cycles

  B. Back to Main Menu

  Choose filter (1-9, A, T, D, I, B): _
```

#### T. Template Library

```yaml
action: show_template_library
display: |
  📋 **CASCADE WORKFLOW TEMPLATES**

  Production-Ready Templates:
  1. Mission Planning Template      → Strategic objectives with quality gates
  2. Story Creation Template        → R.O.C.K.E.T. + Standard formats
  3. Task Breakdown Template        → Parallel execution with dependencies
  4. Quality Gate Template          → 4.0+ star validation system
  5. Testing Template               → >80% coverage automation
  6. Documentation Template         → Comprehensive auto-generation
  7. Completion Loops Template      → Steps 7-18 automation
  8. Browse All Templates           → 37+ workflow templates

  B. Back to Main Menu

  Choose template (1-8, B): _
```

#### W. Workflow Builder

```yaml
action: launch_workflow_builder
display: |
  ⚙️  **CASCADE WORKFLOW BUILDER**

  Build Your Workflow:
  1. Start from CASCADE Template    → Use proven 18-step system
  2. Create Custom Mission Flow     → Design mission-specific workflows
  3. Build Quality Gate System     → Custom validation frameworks
  4. Import Existing Workflow      → Adapt external processes
  5. Clone Successful Workflow     → Replicate high-performing patterns
  6. View Saved Workflows          → Manage your workflow library

  B. Back to Main Menu

  Choose option (1-6, B): _
```

#### S. System Settings

```yaml
action: show_system_settings
display: |
  ⚙️  **CASCADE SYSTEM CONFIGURATION**

  Settings Categories:
  1. User Preferences           → Personal workflow preferences
  2. Agent Configuration        → 112+ agent settings & capabilities  
  3. Quality Gates             → 4.0+ star thresholds & validation rules
  4. Testing & Documentation   → Coverage requirements & auto-generation
  5. Parallel Execution        → Multi-agent coordination settings
  6. Version Control           → Git workflows & deployment automation
  7. Notification Settings     → Progress alerts & stakeholder updates
  8. Advanced CASCADE Options  → Expert-level system configuration

  B. Back to Main Menu

  Choose category (1-8, B): _
```

### Help Options (H, ?)

#### H. Help & Tutorials

```yaml
action: show_help_system
display: |
  ❓ **HELP & LEARNING**

  Get Started:
  1. Quick Start Guide       → 5-minute intro
  2. Video Tutorials        → Step-by-step guides  
  3. Best Practices        → Proven strategies
  4. Troubleshooting       → Common issues
  5. Community Support     → Get help from others

  B. Back to Main Menu

  Choose option (1-5, B): _
```

#### ?. Command Reference

```yaml
action: show_command_reference
display: |
  📖 **CASCADE COMMAND REFERENCE**

  Essential Commands:
  1. /one            → Main CASCADE interface (you are here)
  2. /start          → Quick mission start with 18-step workflow  
  3. /story          → Story creation with quality gates
  4. /task           → Parallel task execution management
  5. /agent          → Direct access to 112+ specialists

  CASCADE-Specific Commands:
  6. /test           → Execute Tester Agent (>80% coverage)
  7. /document       → Run Documenter Agent (auto-generation)
  8. /improve        → Launch Improver Agent (<30min cycles)
  9. /quality        → Run quality gate validation (4.0+ stars)

  Legacy Commands (Deprecated):
  - Use /one instead of: /commander, /taskmaster, /pm, etc.

  B. Back to Main Menu

  Press any key to continue...
```

## UX Design Principles Applied

### 1. Single Point of Entry

- All functionality accessible through `/one`
- Eliminates need to remember 17 different commands
- Reduces cognitive load by 75%

### 2. Consistent Interface Pattern

- Always numbered selections (1-9)
- Always show breadcrumbs
- Always provide B (Back) and H (Help)
- Predictable navigation experience

### 3. Progressive Disclosure

- Most common actions shown first (1-5)
- Specialist teams grouped logically (6-9)
- Advanced features clearly separated (A, T, W, S)
- Help always available (H, ?)

### 4. Clear Information Hierarchy

- **Visual grouping** with headers and spacing
- **Action-oriented labels** (verb + noun)
- **Context descriptions** (what each option does)
- **Status indicators** (numbers, progress)

### 5. Error Prevention

- Clear option labels eliminate guesswork
- Numbered selections prevent typos
- Breadcrumbs show current location
- Help always accessible

## Success Metrics - CASCADE System Integration

**Expected Improvements with Complete CASCADE:**

- 75% reduction in discovery time (achieved through unified /one interface)
- 90% success rate on first attempt (enhanced with Mission 1 completion status)
- 60% faster task completion (boosted by parallel execution & automation)
- 95% user satisfaction score (elevated by quality gates & testing systems)

**CASCADE-Enhanced Measurement Points:**

- Time from command entry to action selection (improved with quality system menu)
- Success rate of intended actions (enhanced with 18-step workflow integration)
- User satisfaction surveys (upgraded with testing & documentation capabilities)
- Task completion analytics (comprehensive with quality gate monitoring)

**Mission 1 Completion Impact:**

- Complete 18-step CASCADE workflow accessible through /one interface
- Real-time quality scores and system status prominently displayed
- New testing, documentation, and improvement capabilities integrated
- Enhanced agent directory with 112+ specialists and quality team focus

---

_Designed with Irish precision and user-centered excellence by Una O'Connor, UX Design Specialist_