claude-agents-delegation 1.0.0

package/LICENSE

@@ -0,0 +1,24 @@
+                    GNU GENERAL PUBLIC LICENSE
+                       Version 3, 29 June 2007
+
+ Copyright (C) 2007 Free Software Foundation, Inc. <https://fsf.org/>
+ Everyone is permitted to copy and distribute verbatim copies
+ of this license document, but changing it is not allowed.
+
+                            Preamble
+
+  The GNU General Public License is a free, copyleft license for
+software and other kinds of works.
+
+  The licenses for most software and other practical works are designed
+to take away your freedom to share and change the works.  By contrast,
+the GNU General Public License is intended to guarantee your freedom to
+share and change all versions of a program--to make sure it remains free
+software for all its users.  We, the Free Software Foundation, use the
+GNU General Public License for most of our software; it applies also to
+any other work released this way by its authors.  You can apply it to
+your programs, too.
+
+  For the complete license text, see <https://www.gnu.org/licenses/gpl-3.0.txt>
+
+Copyright (c) 2026 waroi

package/README.md

@@ -0,0 +1,128 @@
+# claude-agents-delegation
+
+[![npm version](https://img.shields.io/npm/v/claude-agents-delegation.svg)](https://www.npmjs.com/package/claude-agents-delegation)
+[![License: GPL-3.0](https://img.shields.io/badge/License-GPL--3.0-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)
+
+Multi-agent delegation boilerplate for **Claude Code** — run Gemini, Codex, and Claude agents in parallel with simple shorthands.
+
+## Quick Start
+
+```bash
+npx claude-agents-delegation init
+```
+
+Or with defaults (no prompts):
+
+```bash
+npx claude-agents-delegation init --yes
+```
+
+## What It Does
+
+Claude Code is powerful but expensive. This boilerplate redirects simple tasks to cheaper AI models:
+
+| Layer | AI | Role | Cost |
+|-------|----|------|------|
+| **Decision** | Claude ✅ | Complex decisions, file writing, architecture | Highest |
+| **Code** | Codex 🟠 | Code analysis, bug fixing, test writing | Medium |
+| **Analysis** | Gemini 🔵 | Bulk text/data analysis, log reading | Cheapest |
+
+**Simple rule:** Claude thinks, Codex codes, Gemini reads.
+
+## Generated Files
+
+Running `init` creates the following in your project:
+
+```
+your-project/
+├── CLAUDE.md                          # Delegation rules & shorthands
+└── .claude/
+    ├── settings.local.json            # CLI permissions
+    ├── agents/
+    │   └── investigator.md            # Auto-spawned investigation agent
+    └── commands/
+        ├── codex_agents.md            # /codex_agents skill
+        └── gemini_agents.md           # /gemini_agents skill
+```
+
+Optional docs (USAGE.md, integration guides) are generated when you choose "Full" documentation.
+
+## Shorthands
+
+Add a shorthand to the end of any Claude Code command:
+
+| Shorthand | Agents | Total |
+|-----------|--------|-------|
+| `x3` | 1 Claude + 2 Gemini | 3 |
+| `x5` | 1 Claude + 4 Gemini | 5 |
+| `c` / `c3` | 3 Codex | 3 |
+| `c5` | 5 Codex | 5 |
+| `g` / `g3` | 3 Gemini | 3 |
+| `g5` | 5 Gemini | 5 |
+
+**Combine freely:**
+
+```
+analyze this project x5 c5
+```
+
+= 1 Claude + 4 Gemini + 5 Codex = **10 parallel agents**
+
+## Prerequisites
+
+### Gemini CLI
+
+```bash
+npm install -g @google/gemini-cli
+gemini  # sign in with Google account
+```
+
+### Codex CLI
+
+```bash
+npm install -g @openai/codex
+codex login
+```
+
+### Bash (Windows)
+
+All commands use bash syntax. On Windows, use **Git Bash** or **WSL**.
+
+## Features
+
+- **Three-tier delegation** — Claude for decisions, Codex for code, Gemini for bulk analysis
+- **Parallel agents** — Run up to 10 agents simultaneously with simple shorthands
+- **Automatic fallback** — Each agent tries multiple models before failing
+- **Graceful degradation** — If all external agents fail, Claude takes over automatically
+- **Zero dependencies** — Only uses Node.js built-ins
+- **Interactive setup** — Choose tools, docs, and language during init
+- **Skip-existing** — Won't overwrite files that already exist in your project
+
+## Usage Examples
+
+```
+# Code analysis with 3 Codex agents
+find bugs in src/ c3
+
+# Data analysis with 3 Gemini agents
+analyze the log files g3
+
+# Full project review with everything
+review this project x5 c5
+
+# Quick investigation
+what does this codebase do x3
+```
+
+## Options
+
+```
+npx claude-agents-delegation init [--yes]
+
+  init       Generate delegation config files in current directory
+  --yes      Use defaults (both tools, full docs, English)
+```
+
+## License
+
+[GPL-3.0](LICENSE)

package/bin/init.js

@@ -0,0 +1,42 @@
+#!/usr/bin/env node
+'use strict';
+
+const { banner, writeFiles, printSuccess } = require('../src/utils');
+const { promptUser, defaultAnswers } = require('../src/cli');
+const { generateFiles } = require('../src/generator');
+
+async function main() {
+  const args = process.argv.slice(2);
+  const command = args[0];
+
+  if (command !== 'init') {
+    console.log('');
+    console.log('  Usage: npx claude-agents-delegation init [--yes]');
+    console.log('');
+    console.log('  Options:');
+    console.log('    init       Generate delegation config files in current directory');
+    console.log('    --yes      Use defaults (both tools, full docs, English)');
+    console.log('');
+    process.exit(0);
+  }
+
+  banner();
+
+  const useDefaults = args.includes('--yes') || args.includes('-y');
+  const answers = useDefaults ? defaultAnswers() : await promptUser();
+
+  if (!useDefaults) {
+    console.log('');
+  }
+
+  const files = generateFiles(answers);
+  const targetDir = process.cwd();
+  const created = writeFiles(files, targetDir);
+
+  printSuccess(created, answers);
+}
+
+main().catch((err) => {
+  console.error('Error:', err.message);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "claude-agents-delegation",
+  "version": "1.0.0",
+  "description": "Multi-agent delegation boilerplate for Claude Code — Gemini + Codex + Claude working together",
+  "main": "src/generator.js",
+  "bin": {
+    "claude-agents-delegation": "./bin/init.js"
+  },
+  "files": [
+    "bin/",
+    "src/",
+    "LICENSE",
+    "README.md"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "gemini",
+    "codex",
+    "multi-agent",
+    "delegation",
+    "ai-agents",
+    "cli",
+    "boilerplate"
+  ],
+  "author": "waroi",
+  "license": "GPL-3.0",
+  "engines": {
+    "node": ">=16.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/waroi/claude-multiagent-boiler-plate.git"
+  },
+  "homepage": "https://github.com/waroi/claude-multiagent-boiler-plate#readme",
+  "bugs": {
+    "url": "https://github.com/waroi/claude-multiagent-boiler-plate/issues"
+  }
+}

package/src/cli.js

@@ -0,0 +1,63 @@
+'use strict';
+
+const readline = require('readline');
+
+function ask(rl, question, options) {
+  return new Promise((resolve) => {
+    console.log(`  ? ${question}`);
+    options.forEach((opt, i) => {
+      console.log(`    (${i + 1}) ${opt.label}${opt.note ? ` — ${opt.note}` : ''}`);
+    });
+    process.stdout.write('  > ');
+
+    rl.once('line', (line) => {
+      const num = parseInt(line.trim(), 10);
+      if (num >= 1 && num <= options.length) {
+        resolve(options[num - 1].value);
+      } else {
+        resolve(options[0].value);
+      }
+    });
+  });
+}
+
+async function promptUser() {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+    terminal: !!process.stdin.isTTY
+  });
+
+  const tools = await ask(rl, 'Which AI tools will you use?', [
+    { label: 'Gemini only', note: 'text/data analysis', value: 'gemini' },
+    { label: 'Codex only', note: 'code analysis', value: 'codex' },
+    { label: 'Both', note: 'recommended', value: 'both' }
+  ]);
+
+  console.log('');
+
+  const docs = await ask(rl, 'Include documentation files?', [
+    { label: 'Minimal', note: 'config files only', value: 'minimal' },
+    { label: 'Full', note: 'config + guides + usage docs', value: 'full' }
+  ]);
+
+  let lang = 'en';
+  if (docs === 'full') {
+    console.log('');
+    lang = await ask(rl, 'Documentation language?', [
+      { label: 'English', value: 'en' },
+      { label: 'Turkish', value: 'tr' },
+      { label: 'Both', value: 'both' }
+    ]);
+  }
+
+  rl.close();
+
+  return { tools, docs, lang };
+}
+
+function defaultAnswers() {
+  return { tools: 'both', docs: 'full', lang: 'en' };
+}
+
+module.exports = { promptUser, defaultAnswers };