claude-code-team 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Али
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,75 @@
+# CCT - Claude Code Team
+
+Orchestrate multiple Claude sessions to work on complex tasks in parallel.
+
+## Installation
+
+```bash
+npm install -g cct-cli
+```
+
+## Usage
+
+### Create new project
+
+```bash
+cct init my-project
+cd my-project
+claude --dangerously-skip-permissions
+```
+
+### Initialize in existing folder
+
+```bash
+cd existing-project
+cct init .
+claude --dangerously-skip-permissions
+```
+
+### Give orchestrator a task
+
+```
+> Create a web service for generating startup ideas...
+```
+
+The orchestrator will:
+1. Ask clarifying questions
+2. Create worker sessions (specialists)
+3. Delegate tasks to workers
+4. Coordinate and aggregate results
+
+## Project Structure
+
+After `cct init`:
+```
+my-project/
+├── CLAUDE.md           # Orchestrator (reads this automatically)
+└── features/           # Agent & skill templates
+```
+
+After orchestrator runs:
+```
+my-project/
+├── CLAUDE.md
+├── features/
+├── .sessions/          # Session IDs for Q&A
+├── .outputs/           # Worker results
+├── .context/
+│   └── project.md      # Shared project context
+├── workers/
+│   └── backend_worker/
+│       └── CLAUDE.md   # Worker identity
+├── backend/            # Actual code (written by workers)
+└── frontend/
+```
+
+## How It Works
+
+1. **Orchestrator** reads CLAUDE.md and understands its role
+2. **Orchestrator** creates workers (separate Claude sessions)
+3. **Workers** execute tasks and write results to `.outputs/`
+4. **Orchestrator** aggregates results and responds to user
+
+## License
+
+MIT

package/bin/cct.js

@@ -0,0 +1,29 @@
+#!/usr/bin/env node
+
+const { init } = require('../lib/init');
+
+const args = process.argv.slice(2);
+const command = args[0];
+
+if (command === 'init') {
+  const name = args[1] || '.';
+  init(name);
+} else if (command === '--help' || command === '-h' || !command) {
+  console.log(`
+CCT - Claude Code Team
+
+Usage:
+  cct init <name>     Create new CCT project
+  cct init .          Initialize in current folder
+  cct --help          Show this help
+
+Example:
+  cct init my-startup
+  cd my-startup
+  claude --dangerously-skip-permissions
+`);
+} else {
+  console.error(`Unknown command: ${command}`);
+  console.log('Run "cct --help" for usage');
+  process.exit(1);
+}

package/lib/init.js

@@ -0,0 +1,53 @@
+const fs = require('fs');
+const path = require('path');
+
+function init(name) {
+  const targetDir = name === '.' ? process.cwd() : path.join(process.cwd(), name);
+  const templatesDir = path.join(__dirname, '..', 'templates');
+
+  // Create directory if not exists
+  if (name !== '.' && !fs.existsSync(targetDir)) {
+    fs.mkdirSync(targetDir, { recursive: true });
+  }
+
+  // Create features folder
+  const featuresDir = path.join(targetDir, 'features');
+  if (!fs.existsSync(featuresDir)) {
+    fs.mkdirSync(featuresDir, { recursive: true });
+  }
+
+  // Copy CLAUDE.md (orchestrator)
+  const orchestratorSrc = path.join(templatesDir, 'orchestrator.md');
+  const orchestratorDest = path.join(targetDir, 'CLAUDE.md');
+
+  if (fs.existsSync(orchestratorSrc)) {
+    fs.copyFileSync(orchestratorSrc, orchestratorDest);
+  }
+
+  // Copy all feature files
+  const featureFiles = ['agents.md', 'skills.md', 'commands.md', 'mcps.md', 'TEMPLATE.md'];
+  for (const file of featureFiles) {
+    const src = path.join(templatesDir, file);
+    const dest = path.join(featuresDir, file);
+    if (fs.existsSync(src)) {
+      fs.copyFileSync(src, dest);
+    }
+  }
+
+  const displayPath = name === '.' ? 'current directory' : name;
+  console.log(`
+✅ CCT project initialized: ${displayPath}
+
+Created:
+  CLAUDE.md        - Orchestrator instructions
+  features/        - Agent & skill templates
+
+Next steps:
+  ${name !== '.' ? `cd ${name}` : ''}
+  claude --dangerously-skip-permissions
+
+Then give the orchestrator a task!
+`);
+}
+
+module.exports = { init };

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "claude-code-team",
+  "version": "0.1.0",
+  "description": "Claude Code Team - orchestrate multiple Claude sessions",
+  "bin": {
+    "cct": "./bin/cct.js"
+  },
+  "files": [
+    "bin",
+    "lib",
+    "templates"
+  ],
+  "keywords": [
+    "claude",
+    "ai",
+    "orchestrator",
+    "agents",
+    "cli"
+  ],
+  "author": "",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/USER/cct.git"
+  }
+}

package/templates/TEMPLATE.md

@@ -0,0 +1,50 @@
+# Feature: [Название]
+
+> Шаблон для создания новых features.
+> Удали этот блок при создании реального feature.
+
+## Требования (от Business Analytics)
+
+### Бизнес-задачи
+
+1. [Что должен решать]
+2. [Какую ценность приносит]
+
+### Ожидаемые результаты
+
+- [Что должен выдавать]
+
+### Ограничения
+
+- [Что НЕ должен делать]
+
+## Инструменты (от Tech Lead)
+
+### MCP Серверы
+
+- [mcp-server-name]: [для чего]
+
+### Skills
+
+- [skill-name]: [для чего]
+
+### Библиотеки/Зависимости
+
+- [library]: [версия]
+
+## Когда использовать
+
+- [Сценарий 1]
+- [Сценарий 2]
+
+## Кто может назначить
+
+- Team Leads: для своих разрабов
+- Tech Lead: для Team Leads
+
+## Статус
+
+- [ ] Требования от BA
+- [ ] Создан Tech Lead
+- [ ] Подтверждён CCT Lead
+- [ ] Подтверждён User

package/templates/agents.md

@@ -0,0 +1,50 @@
+npx claude-code-templates@latest --agent=development-team/frontend-developer --yes
+
+npx claude-code-templates@latest --agent=development-tools/code-reviewer --yes
+
+npx claude-code-templates@latest --agent=development-team/backend-architect --yes
+
+npx claude-code-templates@latest --agent=performance-testing/react-performance-optimization --yes
+
+npx claude-code-templates@latest --agent=development-team/ui-ux-designer --yes
+
+npx claude-code-templates@latest --agent=development-team/fullstack-developer --yes
+
+npx claude-code-templates@latest --agent=database/database-optimization --yes
+
+npx claude-code-templates@latest --agent=programming-languages/typescript-pro --yes
+
+npx claude-code-templates@latest --agent=programming-languages/python-pro --yes
+
+npx claude-code-templates@latest --agent=database/database-architect --yes
+
+npx claude-code-templates@latest --agent=expert-advisors/architect-review --yes
+
+npx claude-code-templates@latest --agent=development-team/devops-engineer --yes
+
+npx claude-code-templates@latest --agent=deep-research-team/technical-researcher --yes
+
+npx claude-code-templates@latest --agent=database/database-optimizer --yes
+
+npx claude-code-templates@latest --agent=programming-languages/sql-pro --yes
+
+npx claude-code-templates@latest --agent=business-marketing/business-analyst --yes
+
+npx claude-code-templates@latest --agent=deep-research-team/data-analyst --yes
+
+npx claude-code-templates@latest --agent=deep-research-team/research-orchestrator --yes
+
+npx claude-code-templates@latest --agent=web-tools/react-performance-optimizer --yes
+
+
+npx claude-code-templates@latest --agent=devops-infrastructure/monitoring-specialist --yes
+
+
+
+
+
+
+
+
+
+

package/templates/commands.md

@@ -0,0 +1,29 @@
+npx claude-code-templates@latest --command=utilities/ultra-think --yes
+
+npx claude-code-templates@latest --command=documentation/create-architecture-documentation --yes
+
+npx claude-code-templates@latest --command=documentation/update-docs --yes
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

package/templates/mcps.md

@@ -0,0 +1,32 @@
+npx claude-code-templates@latest --mcp=devtools/context7 --yes
+
+npx claude-code-templates@latest --mcp=browser_automation/playwright-mcp-server --yes
+
+npx claude-code-templates@latest --mcp=deepgraph/deepgraph-react --yes
+
+npx claude-code-templates@latest --mcp=web/web-fetch --yes
+
+npx claude-code-templates@latest --mcp=devtools/chrome-devtools --yes
+
+npx claude-code-templates@latest --mcp=browser_automation/playwright-mcp --yes
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+
+

package/templates/orchestrator.md

@@ -0,0 +1,184 @@
+# CCT Orchestrator
+
+You are an orchestrator managing a team of AI workers.
+
+## First Run Setup
+
+```bash
+mkdir -p .sessions .outputs .context
+echo "YOUR_SESSION_ID" > .sessions/orchestrator.id
+```
+
+## Important Rules
+
+### YOU DO NOT WRITE CODE
+- You are a coordinator, not a coder
+- Only WORKERS write code
+- Your job: plan, delegate, coordinate, aggregate results
+
+### Launching Workers
+- Create worker folders in `workers/<name>_worker/`
+- **Launch each worker FROM THEIR FOLDER** (cd into it first)
+- Workers write their output to `.outputs/`
+
+### Before Creating Workers
+- **Always clarify task with USER first** — ask questions to fill gaps
+- Decompose complex tasks into clear subtasks
+- Define precise scope for each worker
+- Write project context to `.context/project.md`
+
+### If Instruction Is Vague, Ask USER:
+- What exact output is expected?
+- What constraints?
+- What priorities?
+
+## Project Context
+
+Write and maintain `.context/project.md`:
+```bash
+cat > .context/project.md << 'EOF'
+# Project Context
+
+## Goal
+<what we're building>
+
+## User Requirements
+<what user asked for>
+
+## Constraints
+<limitations, requirements>
+
+## Current Status
+<what's done, what's in progress>
+
+## Definitions
+<terms, concepts workers should know>
+EOF
+```
+
+- You write and update this file
+- Workers read it before starting and to refresh context
+- Single source of truth
+
+## Creating a Worker
+
+### 1. Choose Specialist from Templates
+
+Read `features/` folder:
+- `agents.md` — agent templates
+- `skills.md` — skill templates
+
+### 2. Create Folder and CLAUDE.md
+
+```bash
+mkdir -p workers/<name>_worker
+```
+
+Worker's CLAUDE.md defines WHO THEY ARE:
+```markdown
+# <Role Name>
+
+You are a <specialist description>.
+
+## Your Competencies
+- ...
+
+## How You Work
+1. Read .context/project.md first
+2. Do your task
+3. Save result to .outputs/<name>.md
+
+## If Something Is Unclear
+
+Ask orchestrator and WAIT for answer:
+\`\`\`bash
+ORCH_ID=$(cat .sessions/orchestrator.id)
+claude --dangerously-skip-permissions -r "$ORCH_ID" --print -p "QUESTION|<name>|<your question>"
+\`\`\`
+
+## When You Finish
+
+\`\`\`bash
+ORCH_ID=$(cat .sessions/orchestrator.id)
+claude --dangerously-skip-permissions -r "$ORCH_ID" --print -p "DONE|<name>|.outputs/<name>.md"
+\`\`\`
+```
+
+### 3. Launch Worker and Save Session ID
+
+```bash
+WORKER_ID=$(uuidgen)
+
+# Save worker session ID for Q&A
+echo "$WORKER_ID" > .sessions/<name>_worker.id
+
+# Launch
+claude --dangerously-skip-permissions \
+  --session-id "$WORKER_ID" \
+  --print \
+  -p "TASK: <specific assignment>" \
+  > .outputs/<name>.md 2>&1 &
+```
+
+## Q&A Protocol
+
+### Worker Asks Question
+```
+Worker: claude -r <orch-id> -p "QUESTION|name|what is X?"
+```
+
+### You Answer Worker
+```bash
+WORKER_ID=$(cat .sessions/<name>_worker.id)
+claude --dangerously-skip-permissions -r "$WORKER_ID" --print -p "ANSWER: X is ..."
+```
+
+## Message Protocol
+
+| Message | From | Meaning |
+|---------|------|---------|
+| `DONE\|name\|path` | Worker | Finished, result at path |
+| `QUESTION\|name\|text` | Worker | Needs clarification |
+| `ERROR\|name\|text` | Worker | Error occurred |
+| `ANSWER: ...` | You | Answer to worker question |
+
+## Workflow
+
+```
+1. User gives task
+        ↓
+2. ASK USER clarifying questions
+        ↓
+3. Write .context/project.md
+        ↓
+4. Create workers (CLAUDE.md = who they are)
+        ↓
+5. Launch with task, save session IDs
+        ↓
+6. Handle QUESTION messages → send ANSWER
+        ↓
+7. Wait for DONE messages
+        ↓
+8. Read .outputs/, aggregate
+        ↓
+9. Update .context/project.md if needed
+        ↓
+10. Respond to user
+```
+
+## Structure
+
+```
+<project>/
+├── CLAUDE.md                    # You (orchestrator)
+├── features/                    # Agent/skill templates
+├── .sessions/
+│   ├── orchestrator.id          # Your session ID
+│   └── <name>_worker.id         # Worker IDs (for Q&A)
+├── .outputs/                    # Worker results
+├── .context/
+│   └── project.md               # Project context (you maintain)
+└── workers/
+    └── <name>_worker/
+        └── CLAUDE.md            # Who they are
+```

package/templates/skills.md

@@ -0,0 +1,35 @@
+npx claude-code-templates@latest --skill=development/webapp-testing --yes
+
+
+npx claude-code-templates@latest --skill=creative-design/frontend-design --yes
+
+npx claude-code-templates@latest --skill=development/senior-frontend --yes
+
+npx claude-code-templates@latest --skill=development/senior-backend --yes
+
+npx claude-code-templates@latest --skill=development/senior-architect --yes
+
+npx claude-code-templates@latest --skill=development/senior-data-engineer --yes
+
+npx claude-code-templates@latest --skill=creative-design/ui-design-system --yes 
+
+npx claude-code-templates@latest --skill=development/brainstorming --yes
+
+npx claude-code-templates@latest --skill=business-marketing/cto-advisor --yes
+
+npx claude-code-templates@latest --skill=development/systematic-debugging --yes
+
+npx claude-code-templates@latest --skill=development/senior-qa --yes
+
+npx claude-code-templates@latest --skill=business-marketing/ceo-advisor --yes
+
+npx claude-code-templates@latest --skill=development/senior-ml-engineer --yes
+
+npx claude-code-templates@latest --skill=ai-research/agents-langchain --yes
+
+npx claude-code-templates@latest --skill=development/skill-development --yes
+
+
+
+
+