cto-platform

Files (1)

• SKILL.md

SKILL.md (first lines)

# CTO Platform Skill

Comprehensive knowledge of the CTO (Cognitive Task Orchestrator) platform for AI-driven development workflows.

## When to Use

- Running intake to generate tasks from PRDs
- Starting and monitoring Play workflows
- Understanding agent sequencing and responsibilities
- Debugging workflow issues

---

## Intake Workflow

### MCP Tool

```
mcp_cto_intake(project_name="my-project")
```

### Flow

```
PRD Document → mcp_cto_intake() → Linear Project Created
                                → PRD Issue with Morgan as delegate
                                → PM Webhook → Argo Workflow
                                → Morgan Pod generates tasks.json
                                → Task issues created in Linear
```

### Key Points

- `local: false` in cto-config.json = Argo workflow (production)
- `local: true` = local binary execution (debugging only)
- Morgan auto-assigned triggers intake via PM webhook

---

## Play Workflow

### MCP Tools

```
mcp_cto_play()           # Start workflow, auto-detects next task
mcp_cto_play_status()    # Query progress
mcp_cto_jobs()           # List running workflows
mcp_cto_stop_job()       # Cancel workflow
```

### Agent Sequence (Per Task)

```
┌─────────────────────────────────────────────────────────────────────────────┐
│                           PLAY WORKFLOW (Per Task)                           │
│                                                                              │
│   1. IMPLEMENTATION AGENT (based on task.agentHint)                         │
│      ├─ bolt (infrastructure - Task 1 ALWAYS, plus any infra tasks)        │
│      ├─ rex (Rust: axum, tokio, sqlx)                                       │
│      ├─ grizz (Go: chi, grpc, pgx)                                          │
│      ├─ nova (Node.js/Bun: Elysia, Effect, Drizzle)                         │
│      ├─ blaze (React/Web: Next.js, shadcn/ui, TailwindCSS)                  │
│      ├─ tap (Mobile: Expo, React Native)                                    │
│      └─ spark (Desktop: Electron)                                           │
│                                                                              │
│   2. SUPPORT AGENTS (sequential, run for EVERY task)                        │
│      ├─ Cleo (quality) ──── max 5 retries                                   │
│      ├─ Cipher (security) ─ max 2 retries                                   │
│      ├─ Tess (testing) ──── max 5 retries                                   │
│      └─ Atlas (integration) final merge gate                                │
└─────────────────────────────────────────────────────────────────────────────┘
```

---

## cto-config.json Structure

```json
{
  "version": "1.0",
  "orgName": "5DLabs",
  "defaults": {
    "intake": {
      "local": false,           // MUST be false for production
      "githubApp": "5DLabs-Morgan"
    },
    "linear": {
      "teamId": "CTOPA",
      "pmServerUrl": "http://localhost:8081"
    },
    "play": {
      "repository": "5dlabs/cto",
      "healerEndpoint": "http://localhost:8083",
      "autoMerge": true,        // Atlas auto-merges PRs
      "implementationMaxRetries": 10,
      "qualityMaxRetries": 5,
      "securityMaxRetries": 2,
      "testingMaxRetries": 5
    }
  },
  "agents": {
    "morgan": { ... },
    "bolt": { ... },
    "rex": { ... },
    // ...
  }
}
```

### Key Fields

| Field | Purpose |
|-------|---------|
| `intake.local` | `false` = Argo workflow, `true` = local binary |
| `play.autoMerge` | Atlas merges PRs automatically |
| `play.healerEndpoint` | Healer API for session notifications |
| `play.*MaxRetries` | Per-agent retry limits |

---

From 5DLabsInc/cto, AGPL-3.0.

More from 5DLabsInc/cto