{"id":46205411,"url":"https://github.com/yoodaddy0311/artibot","last_synced_at":"2026-06-08T10:01:05.185Z","repository":{"id":339347412,"uuid":"1156881484","full_name":"Yoodaddy0311/artibot","owner":"Yoodaddy0311","description":"Cognitive orchestration OS for Claude Code — 28 agents, 113 skills, 71 commands, dual-process routing, GRPO lifelong learning, native Agent Teams, MCP server.","archived":false,"fork":false,"pushed_at":"2026-06-07T16:24:30.000Z","size":10563,"stargazers_count":3,"open_issues_count":12,"forks_count":1,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-06-07T18:14:43.120Z","etag":null,"topics":["agent-orchestration","ai-agent","anthropic","autonomous-agent","claude","claude-code","grpo","hierarchical-memory","llm-tools","mcp-server","plugin","typescript"],"latest_commit_sha":null,"homepage":"https://github.com/Yoodaddy0311/artibot","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Yoodaddy0311.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":"CITATION.cff","codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-02-13T06:48:11.000Z","updated_at":"2026-06-05T08:31:52.000Z","dependencies_parsed_at":null,"dependency_job_id":"c6ddf8ab-d52b-4b16-a654-8be38019c2a9","html_url":"https://github.com/Yoodaddy0311/artibot","commit_stats":null,"previous_names":["yoodaddy0311/artibot"],"tags_count":97,"template":false,"template_full_name":null,"purl":"pkg:github/Yoodaddy0311/artibot","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yoodaddy0311%2Fartibot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yoodaddy0311%2Fartibot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yoodaddy0311%2Fartibot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yoodaddy0311%2Fartibot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Yoodaddy0311","download_url":"https://codeload.github.com/Yoodaddy0311/artibot/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Yoodaddy0311%2Fartibot/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34057158,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-08T02:00:07.615Z","response_time":111,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["agent-orchestration","ai-agent","anthropic","autonomous-agent","claude","claude-code","grpo","hierarchical-memory","llm-tools","mcp-server","plugin","typescript"],"created_at":"2026-03-03T06:02:52.253Z","updated_at":"2026-06-08T10:01:05.177Z","avatar_url":"https://github.com/Yoodaddy0311.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Artibot\n\n[![Version](https://img.shields.io/badge/version-4.23.0-blue?style=flat-square)](plugins/artibot/CHANGELOG.md)\n[![License](https://img.shields.io/badge/license-MIT-blue?style=flat-square)](LICENSE)\n[![Node.js](https://img.shields.io/badge/Node.js-18%2B-brightgreen?style=flat-square)](package.json)\n[![Tests](https://img.shields.io/badge/tests-passing-brightgreen?style=flat-square)](plugins/artibot/tests/)\n[![Coverage](https://img.shields.io/badge/coverage-90%25%2B-brightgreen?style=flat-square)](plugins/artibot/tests/)\n[![Lint](https://img.shields.io/badge/lint-clean-brightgreen?style=flat-square)](plugins/artibot/eslint.config.js)\n[![Claude Code Plugin](https://img.shields.io/badge/Claude_Code-Plugin-7C3AED?style=flat-square)](https://github.com/anthropics/claude-code)\n[![Cowork Plugin](https://img.shields.io/badge/Claude_Cowork-Plugin-orange?style=flat-square)](https://claude.com/cowork)\n[![Agent Teams](https://img.shields.io/badge/Agent_Teams-Native-orange?style=flat-square)](plugins/artibot/lib/runtime/middleware/subagents.js)\n\n\u003e **Cognitive orchestration OS for Claude Code with hierarchical memory, GRPO-RLVR self-learning, MCP server, and multi-platform agent teams.**\n\nThis repository ships **two complementary plugins** under one marketplace:\n\n| Plugin | Target | Version | Best for |\n|---|---|---|---|\n| [`artibot`](./plugins/artibot/) | Claude Code (developer CLI) | **4.23.0** | full Agent Teams orchestration, TDD, code review, security audits, GRPO learning, MCP server, **Goal-driven autopilot**, **`/learning` diagnostics**, **`/save` + `/resume` single-shot handoff**, **safety boost (machineId frontmatter, git-lock fail, 10m throttle)** |\n| [`artibot-cowork`](./plugins/artibot-cowork/) | Claude Cowork (knowledge workers) | **3.1.0** | marketing campaigns, long-form writing, AEO/GEO content, KR-market SEO, AI-slop detection, **Claude Design, Routines, Ultraplan, Monitor** |\n\nBoth plugins share the same DEV protocol, Korean market expertise, data-sovereignty policy, and 6-stage content quality pipeline. They differ only in **target environment** and **skill mix**.\n\nA cognitive orchestration plugin for [Claude Code](https://github.com/anthropics/claude-code) powered by **dual-process routing**, **lifelong learning**, and the **native Agent Teams API**. Artibot uses a System 1/2 cognitive architecture to classify every request, assembles specialized agent teams with P2P communication, and continuously learns from session outcomes to improve routing accuracy over time.\n\n\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/artibot-mascot.jpeg\" alt=\"Artibot Mascot\" width=\"400\" /\u003e\n\u003c/p\u003e\n\n## Overview\n\nMost Claude Code plugins use simple sub-agent (`Task()`) delegation -- fire-and-forget with one-way result reporting. Artibot takes a fundamentally different approach by using Claude's **native Agent Teams API** as its core engine, enabling true team orchestration:\n\n| Capability | Sub-Agent (Task) | Agent Teams (Artibot) |\n|------------|------------------|----------------------|\n| Communication | Return result to parent only | P2P bidirectional messaging (SendMessage) |\n| Task Management | Parent manages everything | Shared task list (TaskCreate/TaskList) |\n| Self-Assignment | Not possible | Teammates self-claim from task list |\n| Peer Communication | Not possible | Direct DM + broadcast |\n| Plan Approval | Not possible | plan_approval_response |\n| Lifecycle | One-shot | Create -\u003e Work -\u003e Shutdown -\u003e Cleanup |\n\n## Key Features\n\n- **Cognitive Architecture** -- Dual-process System 1/2 routing inspired by Kahneman's theory: fast intuitive responses for simple tasks, deep deliberative reasoning for complex ones\n- **Lifelong Learning** -- GRPO-based batch learning from session outcomes with automatic knowledge transfer between System 1 and System 2 caches\n- **CTO-Led Orchestration** -- `orchestrator` agent leads 28 specialist agents as a team coordinator (delegation mode: no direct coding)\n- **Intelligent Delegation** -- Auto-selects Sub-Agent (simple) vs Agent Team (complex) based on cognitive complexity scoring\n- **5 Orchestration Patterns** -- Leader, Council, Swarm, Pipeline, Watchdog\n- **8 DAG Playbooks** -- Feature, Bugfix, Refactor, Security + Marketing Campaign, Marketing Audit, Content Launch, Competitive Analysis (DAG-based with parallel node execution, topological sort, and cycle detection)\n- **72 Slash Commands** -- `/sc` smart router, `/save`, `/resume`, `/daily`, `/team`, `/orchestrate`, `/spawn`, `/implement`, `/visual-check`, `/sc playbook`, `/learning`, `/ultrareview`, `/ultraplan`, `/audit-claude-md`, `/export`, and more\n- **28 Specialized Agents** -- Architecture, security, frontend, backend, testing, DevOps, marketing, SEO, analytics, and more (opus 73%, sonnet 27%)\n- **113 Domain Skills** -- 11 persona skills, 8 core skills, 16 language skills, 8 utility skills, 35 marketing skills, visual-validation, daily, team, session-worklog, vibe-coding, repo-benchmarking, auto-learning-pipeline, git-worktree, dynamic-context-injection, claude-md-auditor (all enhanced with Anthropic best-practice descriptions, workflow checklists, HITL v2 conversational checkpoints, output templates, and freedom levels)\n- **8 Auto-Activating Rules** -- DEV protocol, quality gates, agent coordination, config safety, frontend/backend/test patterns, clean state enforcement\n- **Guard Registry** -- Centralized guard pipeline with `registerGuard()`/`executeChain()` API, 6 built-in guards extracted from hook scripts (75% code reduction)\n- **Loop Detection** -- Circular buffer-based agent loop detection with fingerprint matching, automatic warn/block on repeated tool calls\n- **Clean State Enforcement** -- TaskCompleted hook ensures lint+test verification at feature completion boundaries\n- **57 Event Hook Registrations** -- Cognitive routing, lifelong learning, session lifecycle, dangerous command blocking, auto-formatting, team tracking, loop detection, clean state checks, HTTP webhook notifications, git autopilot, auto-learning scheduler\n- **Advisory File Locking** -- Spin-lock based file locking for concurrent hook state access, fail-open pattern prevents workflow blocking\n- **DEV Protocol** -- Mandatory Decompose-Execute-Verify workflow with zero-skip policy for all code changes\n- **Vibe Coding Support** -- Natural language request handling with read-first, verify-after, evidence-based completion\n- **Visual Validation Pipeline** -- SSIM-based screenshot comparison, auto-fix suggestion, iterative correction loop via Playwright MCP\n- **Conversation-to-Memory** -- Auto-extracts rules and decisions from user messages (Korean/English), injects into skills dynamically\n- **Project CLAUDE.md Seeding** -- `install.sh` auto-generates project-level CLAUDE.md with Artibot methodology and DEV protocol\n- **Runtime Middleware Pipeline** -- 9-stage middleware engine (router, subagents, tasks, checkpoint, memory, skills, guardrail, token-usage, summarization) for runtime context injection\n- **Auto-Learning Pipeline** -- Zero-config nightly self-improvement: self-scan, pattern-extract, knowledge-update, skill-refinement with auto-commit/push\n- **Output Design System** -- 7 output styles with design tokens (tokens.md) and narrative template for consistent formatting\n- **Forked Context Skills** -- All 113 skills run in isolated forked context for clean execution without cross-contamination\n- **HTTP Webhook Notifications** -- Session events sent to Slack, Discord, or custom endpoints via configurable webhooks\n- **Cross-Platform Compatible** -- Works with Gemini CLI, OpenAI Codex, and Cursor via platform adapters\n- **Zero Dependencies** -- Pure Node.js built-in modules only (`node:fs`, `node:path`, `node:os`)\n\n## Get Started\n\n### Prerequisites\n\n**Agent Teams** is auto-enabled by Artibot on first session start. No manual setup needed.\n\n### Installation\n\n**Recommended: `install.sh` (flat install — no command prefix)**\n```bash\ngit clone https://github.com/Yoodaddy0311/artibot.git\ncd artibot/plugins/artibot\nbash install.sh          # macOS / Linux / Git Bash on Windows\n```\n\nThis flat-copies agents and commands into `~/.claude/`, so slash commands are\ncalled **without a prefix** (`/save`, `/sc`, `/daily`). It enables Agent Teams\nand seeds a conservative read-only permission allowlist (`Read`/`Glob`/`Grep`)\ninto `~/.claude/settings.json`, removing the repeated approval prompts new users\nhit on first run. To uninstall: `bash install.sh uninstall`.\n\n\u003e **Windows:** run `install.sh` from **Git Bash** ([Git for Windows](https://gitforwindows.org/)),\n\u003e or use the native PowerShell installer: `powershell -ExecutionPolicy Bypass -File install.ps1`.\n\n**Command invocation differs by install method:**\n\n| Install method | Command form | Example |\n|---|---|---|\n| **`install.sh` / `install.ps1`** (recommended) | flat (no prefix) | `/save`, `/sc`, `/daily` |\n| `claude plugin install` (marketplace) | namespaced `artibot:` | `/artibot:save`, `/artibot:sc` |\n\n**Alternative (advanced): Claude Code marketplace**\n```bash\nclaude plugin marketplace add https://github.com/Yoodaddy0311/artibot\nclaude plugin install artibot@artibot\n```\n\nMarketplace install namespaces **every** command under the `artibot:` prefix\n(e.g. `/save` → `/artibot:save`). Use it only for plugin-managed updates via\n`claude plugin`. Agent Teams auto-enables on first session start. To uninstall:\n`claude plugin uninstall artibot`.\n\n### Requirements\n\n- [Claude Code](https://github.com/anthropics/claude-code) CLI\n- Node.js \u003e= 18.0.0\n- Agent Teams (auto-enabled by Artibot, or manually set `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`)\n\n### Cross-Platform Installation\n\nArtibot works beyond Claude Code. Built-in adapters auto-convert agents, skills, and commands for each platform.\n\n\u003e Replace `\u003cyour-project\u003e` with the root directory path of the target project.\n\n| Platform | Compatibility | Agent Teams | Sub-Agent | Skills |\n|----------|:------------:|:-----------:|:---------:|:------:|\n| Claude Code | 10/10 | ✅ | ✅ | ✅ |\n| Gemini CLI | 9/10 | ❌ | ✅ | ✅ |\n| Codex CLI | 8/10 | ❌ | ✅ | ✅ |\n| Antigravity | 8/10 | ❌ | ✅ | ✅ |\n| Cursor IDE | 6/10 | ❌ | ⚠️ | ✅ |\n\n#### Gemini CLI\n\n```bash\ngit clone https://github.com/Yoodaddy0311/artibot.git\ncd artibot\nnode --input-type=module -e \"import { exportForGemini } from './plugins/artibot/lib/core/skill-exporter.js'; const r = await exportForGemini({ pluginRoot: './plugins/artibot' }); console.log(r.summary);\"\n```\n\n#### OpenAI Codex CLI\n\n```bash\ngit clone https://github.com/Yoodaddy0311/artibot.git\ncd artibot\nnode --input-type=module -e \"import { exportForCodex } from './plugins/artibot/lib/core/skill-exporter.js'; const r = await exportForCodex({ pluginRoot: './plugins/artibot' }); console.log(r.summary);\"\n```\n\n#### Google Antigravity\n\n```bash\ngit clone https://github.com/Yoodaddy0311/artibot.git\ncd artibot\nnode --input-type=module -e \"import { exportForGemini } from './plugins/artibot/lib/core/skill-exporter.js'; const r = await exportForGemini({ pluginRoot: './plugins/artibot' }); console.log(r.summary);\"\n```\n\n\u003e **Note:** Agent Teams API is exclusive to Claude Code. Other platforms automatically fall back to Sub-Agent mode (one-way delegation). Learning, memory, and swarm intelligence work identically across all platforms.\n\u003e\n\u003e For the full cross-platform guide including Cursor IDE and batch export, see [plugins/artibot/README.md](plugins/artibot/README.md).\n\n## What can Artibot do?\n\n### `/implement` -- Feature Implementation Pipeline\n\n**Before (manual):**\n```\nYou: \"implement user authentication\"\nClaude: writes code in one file, misses edge cases, no tests, no review\nYou: manually request tests, then review, then fix issues found in review\n-\u003e 4+ back-and-forth prompts, inconsistent coverage\n```\n\n**After (with Artibot):**\n```\nYou: \"implement user authentication\"\nArtibot: /implement triggers automatically\n  -\u003e planner agent: decomposes into 5 subtasks\n  -\u003e architect agent: designs auth flow + data model\n  -\u003e backend-developer + frontend-developer: implement in parallel (Agent Teams)\n  -\u003e tdd-guide agent: writes tests (80%+ coverage)\n  -\u003e code-reviewer agent: reviews with 4-severity classification\n  -\u003e result: complete feature with tests, reviewed, ready to merge\n-\u003e 1 prompt, full pipeline\n```\n\n### `/team` -- Parallel Team Execution\n\n**Before (manual):**\n```\nYou: \"refactor the payment module and update the API docs\"\nClaude: does refactoring first (10 min), then docs (5 min) = 15 min sequential\nNo cross-check between the two tasks\n```\n\n**After (with Artibot):**\n```\nYou: \"refactor the payment module and update the API docs\"\nArtibot: /team triggers automatically\n  -\u003e refactor-cleaner agent: refactoring (teammate A)\n  -\u003e doc-updater agent: documentation (teammate B)\n  -\u003e both run in parallel via Agent Teams API (P2P messaging)\n  -\u003e cross-check phase: each reviews the other's output\n  -\u003e result: 7 min total, cross-verified\n```\n\n### `/export` -- Cross-Platform Export\n\n**Before (manual):**\n```\nYou want to use Artibot agents in Cursor IDE\n-\u003e manually rewrite each agent .md file to .mdc format\n-\u003e figure out Cursor Rules-for-AI conventions\n-\u003e repeat for 28 agents = hours of tedious work\n```\n\n**After (with Artibot):**\n```\n/export cursor\n  -\u003e auto-converts all 28 agents to .mdc format\n  -\u003e places them in .cursor/rules/ with correct frontmatter\n  -\u003e preserves agent expertise and tool permissions\n  -\u003e supports: cursor, codex, opencode, antigravity, all\n-\u003e 1 command, all platforms\n```\n\n---\n\n## Usage\n\n### Smart Routing\n\nThe `/sc` command analyzes natural language intent and routes to the optimal command:\n\n```\n/sc implement login feature\n-\u003e routes to /implement -\u003e TeamCreate -\u003e spawns planner + architect + developer + reviewer\n```\n\n```\n/sc analyze security vulnerabilities in auth module\n-\u003e routes to /analyze --focus security -\u003e delegates to security-reviewer sub-agent\n```\n\n```\n/sc launch email marketing campaign for product launch\n-\u003e routes to /campaign -\u003e TeamCreate -\u003e spawns marketing-strategist + data-analyst + ad-specialist\n```\n\n### Direct Commands\n\n```bash\n/implement user authentication API --type api --tdd\n/code-review @src/auth/\n/test --coverage\n/git commit\n/campaign product launch --channels email,social\n/seo audit @website\n```\n\n### Team Orchestration\n\nFor complex tasks, Artibot assembles a full Agent Team:\n\n```bash\n/orchestrate payment system --pattern feature\n```\n\nThis triggers the full team lifecycle:\n1. `TeamCreate(\"payment-feature\")` -- create the team\n2. `Task(planner, team, \"planner\")` + `Task(architect, team, \"architect\")` + ... -- spawn teammates\n3. `TaskCreate` per phase (plan -\u003e design -\u003e implement -\u003e review) -- populate task list\n4. `TaskUpdate` -- set dependencies and assign teammates\n5. `SendMessage` -- P2P coordination between teammates\n6. `shutdown_request` -\u003e `TeamDelete` -- graceful cleanup\n\n### Marketing Orchestration\n\n```bash\n/campaign product launch --channels email,social,ads\n```\n\nUses the marketing-campaign playbook:\n1. `[Leader]` marketing-strategist defines strategy\n2. `[Council]` team plans channels and content\n3. `[Swarm]` specialists create content in parallel\n4. `[Council]` review and optimize\n5. `[Leader]` launch coordination\n\n### Parallel Execution\n\n```bash\n/spawn full codebase security audit --mode parallel --agents 5\n```\n\nSpawns 5 teammates that self-claim tasks from the shared task list and report findings via `SendMessage`.\n\n## Architecture\n\n```\n+-------------------------------------------------+\n|                  User Request                    |\n+------------------+------------------------------+\n                   |\n                   v\n+-------------------------------------------------+\n|           /sc Router (Intent Analysis)           |\n|       keyword 40% + context 40% + flags 20%      |\n+------------------+------------------------------+\n                   |\n                   v\n+-------------------------------------------------+\n|       Delegation Mode (Complexity Scoring)        |\n|    score \u003c 0.4 -\u003e Sub-Agent  |  \u003e= 0.4 -\u003e Team   |\n+-------+---------------------------------+-------+\n        |                                 |\n        v                                 v\n+---------------+         +-----------------------+\n|   Sub-Agent   |         |   Agent Teams Engine   |\n|   Task()      |         |                       |\n|   one-way     |         |  TeamCreate           |\n|               |         |    -\u003e Task(spawn)     |\n|               |         |    -\u003e TaskCreate      |\n|               |         |    -\u003e SendMessage(P2P)|\n|               |         |    -\u003e TeamDelete      |\n+---------------+         +-----------+-----------+\n                                      |\n                                      v\n                          +-----------------------+\n                          |  orchestrator (CTO)    |\n                          |  Leader | Council |    |\n                          |  Swarm | Pipeline |    |\n                          |  Watchdog              |\n                          +-----------+-----------+\n                                      |\n                                      v\n                          +-----------------------+\n                          |  28 Specialist Agents  |\n                          |  TaskList -\u003e self-claim|\n                          |  SendMessage -\u003e P2P    |\n                          |  TaskUpdate -\u003e report  |\n                          +-----------------------+\n```\n\n## Cognitive Architecture\n\nArtibot uses a dual-process cognitive model inspired by Daniel Kahneman's System 1/System 2 theory to classify and route every user request:\n\n```\nUser Request\n      |\n      v\n+-------------+\n|  Cognitive   |    Complexity Score = weighted sum of:\n|   Router     |      steps (0.25) + domains (0.20)\n| (hook-based) |      + uncertainty (0.20) + risk (0.20) + novelty (0.15)\n+------+------+\n       |\n       +--- score \u003c 0.4 ---\u003e System 1 (Fast / Intuitive)\n       |                       - Pattern-matched from cached experience\n       |                       - Target latency: \u003c 100ms\n       |                       - Keyword-based heuristic scoring\n       |\n       +--- score \u003e= 0.4 ---\u003e System 2 (Deep / Deliberative)\n       |                       - Multi-step structured reasoning\n       |                       - Full context + dependency analysis\n       |                       - Sandbox verification for high-risk ops\n       |\n       +--- confidence \u003c 0.6 or latency exceeded ---\u003e Escalation\n                                System 1 -\u003e System 2 automatic fallback\n```\n\n### Escalation Rules\n- System 1 confidence drops below 0.6\n- Processing time exceeds 100ms\n- No matching pattern in System 1 cache\n- Security or production keywords detected\n- Request spans 3+ domains\n- Explicit `--think`, `--think-hard`, or `--ultrathink` flag\n\n### Integration with Delegation\n\nThe cognitive router feeds directly into the orchestration delegation mode:\n\n| Complexity Score | System | Delegation Mode |\n|-----------------|--------|-----------------|\n| \u003c 0.4 | System 1 | Sub-Agent (Task tool) |\n| \u003e= 0.4 | System 2 | Agent Team (Teams API) |\n\n#### Sub-Agent vs Agent Teams\n\n| Aspect | Sub-Agent | Agent Teams |\n|--------|-----------|-------------|\n| **Delegation** | Task() single call | TeamCreate → Task(team_name) |\n| **UI Visibility** | Hidden (background) | Teammates shown below prompt |\n| **Communication** | One-way (result only) | P2P bidirectional (SendMessage) |\n| **Task Management** | None | Shared task list (TaskCreate/Update/List) |\n| **Persistence** | One-shot | Session-persistent |\n| **Speed** | Fast (low overhead) | Slower (9+ API calls) |\n| **Token Cost** | 1x | ~5x |\n| **Best For** | Single file analysis, search | Complex features, multi-agent collaboration |\n\n## Lifelong Learning\n\nArtibot continuously improves its routing accuracy through a session-based learning pipeline:\n\n```\nSession Start                    Session Active                    Session End\n     |                                |                                |\n     v                                v                                v\nLoad thresholds              Record experiences              Batch learning (GRPO)\nLoad System 1 cache          (routing decisions +            Knowledge transfer\n                              outcomes)                      Persist updated state\n```\n\n### GRPO (Group Relative Policy Optimization)\n\n1. Group similar experiences (group size: 5)\n2. Compare System 1 vs System 2 success rates per group\n3. Compute relative advantage\n4. Adjust routing threshold (step: 0.05, clamped to [-0.1, 0.1])\n\n### Knowledge Transfer\n\n| Direction | Condition | Action |\n|-----------|-----------|--------|\n| **Promote** (S2 -\u003e S1) | 3 consecutive System 2 successes | Cache pattern in System 1 for fast retrieval |\n| **Demote** (S1 -\u003e S2) | 2 consecutive System 1 failures | Remove from System 1, flag for System 2 re-analysis |\n\n### Learning Storage\n\n```\n~/.claude/artibot-learning/\n  +-- experiences.jsonl      # Raw experience log (append-only)\n  +-- system1-cache.json     # Promoted fast patterns\n  +-- system2-cache.json     # Complex pattern registry\n  +-- thresholds.json        # Adaptive threshold state\n  +-- transfer-log.json      # Promotion/demotion history\n```\n\n### Agent Teams API Tools\n\n| Tool | Purpose |\n|------|---------|\n| `TeamCreate` | Create a named team with description |\n| `Task(type, team_name, name)` | Spawn teammates into the team |\n| `TaskCreate` | Add work items to shared task list |\n| `TaskUpdate` | Set status, owner, dependencies (blockedBy/blocks) |\n| `TaskList` / `TaskGet` | View and read tasks |\n| `SendMessage` | DM, broadcast, shutdown request/response, plan approval |\n| `TeamDelete` | Clean up team resources |\n\n### Team Levels\n\n| Level | Mode | Agents | When |\n|-------|------|--------|------|\n| **Solo** | Sub-Agent | 0 | Single file edit, quick fix |\n| **Squad** | Agent Team | 2-4 | Feature implementation, bugfix, refactoring |\n| **Platoon** | Agent Team | 5+ | Large feature, architecture change, security audit, marketing campaign |\n\n### Playbooks\n\n8 DAG playbooks (4 dev + 4 marketing) with parallel node execution.\n\n\u003cdetails\u003e\n\u003csummary\u003eView all 8 playbooks\u003c/summary\u003e\n\n**Feature:**\n```\nTeamCreate -\u003e [Leader] plan -\u003e [Council] design -\u003e [Swarm] implement -\u003e [Council] review -\u003e [Leader] merge -\u003e TeamDelete\n```\n\n**Bugfix:**\n```\nTeamCreate -\u003e [Leader] analyze -\u003e [Pipeline] fix -\u003e [Council] verify -\u003e TeamDelete\n```\n\n**Refactor:**\n```\nTeamCreate -\u003e [Council] assess -\u003e [Pipeline] refactor -\u003e [Swarm] test -\u003e [Council] review -\u003e TeamDelete\n```\n\n**Security:**\n```\nTeamCreate -\u003e [Leader] scan -\u003e [Council] assess -\u003e [Pipeline] fix -\u003e [Council] verify -\u003e TeamDelete\n```\n\n**Marketing Campaign:**\n```\nTeamCreate -\u003e [Leader] strategy -\u003e [Council] plan -\u003e [Swarm] create -\u003e [Council] review -\u003e [Leader] launch -\u003e TeamDelete\n```\n\n**Marketing Audit:**\n```\nTeamCreate -\u003e [Leader] scan -\u003e [Council] assess -\u003e [Pipeline] optimize -\u003e [Council] verify -\u003e TeamDelete\n```\n\n**Content Launch:**\n```\nTeamCreate -\u003e [Leader] plan -\u003e [Swarm] create -\u003e [Council] review -\u003e [Leader] publish -\u003e TeamDelete\n```\n\n**Competitive Analysis:**\n```\nTeamCreate -\u003e [Council] research -\u003e [Swarm] analyze -\u003e [Council] synthesize -\u003e [Leader] report -\u003e TeamDelete\n```\n\n\u003c/details\u003e\n\n## Agents\n\n28 specialized agents: 1 orchestrator (CTO) + 27 specialist teammates. Opus 73%, Sonnet 27%.\n\n\u003cdetails\u003e\n\u003csummary\u003eOrchestrator (Team Leader / CTO)\u003c/summary\u003e\n\n| Agent | Model | Role | Team API Tools |\n|-------|-------|------|----------------|\n| **orchestrator** | opus | CTO-level team leader. Coordination only (delegation mode). | TeamCreate, SendMessage, TaskCreate, TaskUpdate, TaskList, TaskGet, TeamDelete, Task() |\n\nThe orchestrator **never writes code directly**. It assembles the team, distributes tasks, coordinates between teammates, and synthesizes results.\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eSpecialist Agents (27 Teammates)\u003c/summary\u003e\n\nAll teammates have their specialist tools + team collaboration tools (`SendMessage`, `TaskList`, `TaskGet`, `TaskUpdate`).\n\n**Design \u0026 Analysis:**\n\n| Agent | Model | Specialty |\n|-------|-------|-----------|\n| architect | opus | System architecture, ADR, trade-off analysis |\n| planner | opus | Implementation planning, risk assessment |\n| llm-architect | opus | LLM architecture, prompt design, RAG |\n\n**Quality \u0026 Security:**\n\n| Agent | Model | Specialty |\n|-------|-------|-----------|\n| code-reviewer | opus | Code review (4 severity levels, 5 dimensions) |\n| security-reviewer | opus | OWASP Top 10, threat modeling |\n| tdd-guide | opus | TDD (RED-\u003eGREEN-\u003eREFACTOR), 80%+ coverage |\n| e2e-runner | opus | Playwright E2E testing |\n\n**Development:**\n\n| Agent | Model | Specialty |\n|-------|-------|-----------|\n| frontend-developer | opus | UI/UX, WCAG accessibility, Core Web Vitals |\n| backend-developer | opus | API, database, services |\n| database-reviewer | opus | SQL optimization, schema design |\n| typescript-pro | opus | Advanced types, strict mode |\n| build-error-resolver | opus | Build error diagnosis and auto-fix |\n\n**Utilities:**\n\n| Agent | Model | Specialty |\n|-------|-------|-----------|\n| refactor-cleaner | opus | Dead code removal, refactoring |\n| doc-updater | sonnet | Documentation sync, changelog |\n| content-marketer | sonnet | Blog, SEO, social media |\n| devops-engineer | opus | CI/CD, Docker, monitoring |\n| mcp-developer | opus | MCP server development |\n\n**Marketing:**\n\n| Agent | Model | Specialty |\n|-------|-------|-----------|\n| marketing-strategist | opus | Campaign strategy, market positioning, brand architecture |\n| data-analyst | sonnet | Marketing analytics, attribution modeling, KPI dashboards |\n| presentation-designer | sonnet | Pitch decks, marketing collateral, visual storytelling |\n| seo-specialist | sonnet | Technical SEO, keyword strategy, SERP optimization |\n| cro-specialist | sonnet | Conversion optimization, A/B testing, funnel analysis |\n| ad-specialist | sonnet | PPC campaigns, ad creative, ROAS optimization |\n| repo-benchmarker | opus | Repository analysis, competitive benchmarking |\n\n**Performance \u0026 Infrastructure:**\n\n| Agent | Model | Specialty |\n|-------|-------|-----------|\n| performance-engineer | opus | Performance profiling, bottleneck analysis |\n\n\u003c/details\u003e\n\n## Commands\n\n70+ slash commands across development, marketing, and workflow automation. Key commands: `/sc` (smart router), `/implement`, `/team`, `/code-review`, `/save`/`/resume`.\n\n\u003cdetails\u003e\n\u003csummary\u003eDevelopment Commands\u003c/summary\u003e\n\n| Command | Description |\n|---------|-------------|\n| `/sc [request]` | Smart router entry point with auto-routing |\n| `/build [target]` | Project builder with framework auto-detection |\n| `/build-fix` | Build error auto-diagnosis and fix |\n| `/implement [feature]` | Feature implementation pipeline |\n| `/improve [target]` | Evidence-based code enhancement |\n| `/design [domain]` | System design and architecture |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eAnalysis and Debugging Commands\u003c/summary\u003e\n\n| Command | Description |\n|---------|-------------|\n| `/analyze [target]` | Multi-dimensional code/system analysis |\n| `/troubleshoot [symptoms]` | Root cause analysis |\n| `/explain [topic]` | Educational explanations |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eQuality Commands\u003c/summary\u003e\n\n| Command | Description |\n|---------|-------------|\n| `/code-review [target]` | Code review (CRITICAL/HIGH/MEDIUM/LOW) |\n| `/test [type]` | Test runner with auto-detection |\n| `/tdd [feature]` | TDD workflow (RED-\u003eGREEN-\u003eREFACTOR) |\n| `/verify` | Validation pipeline (lint-\u003etype-\u003etest-\u003ebuild) |\n| `/refactor-clean [target]` | Refactoring and dead code removal |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eTeam Orchestration Commands\u003c/summary\u003e\n\n| Command | Description |\n|---------|-------------|\n| `/orchestrate [workflow]` | Agent Teams multi-agent workflow |\n| `/spawn [mode]` | Team spawn with parallel task execution |\n| `/team [task]` | Parallel team orchestration with cross-check |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eWorkflow Commands\u003c/summary\u003e\n\n| Command | Description |\n|---------|-------------|\n| `/plan [feature]` | Implementation planning |\n| `/task [operation]` | Task management (CRUD) |\n| `/git [operation]` | Git workflow automation |\n| `/checkpoint` | State snapshot save/restore |\n| `/daily` | Daily work recap and retrospective |\n| `/save` | Session handoff save (context restore in next session) |\n| `/resume` | Restore previous session handoff |\n| `/visual-check [url]` | Visual validation with SSIM screenshot comparison |\n| `/sc playbook list` | Browse and discover playbooks |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eDocumentation and Content Commands\u003c/summary\u003e\n\n| Command | Description |\n|---------|-------------|\n| `/document [target]` | Documentation generation |\n| `/content [type]` | Content marketing and SEO |\n| `/learn [pattern]` | Pattern extraction and memory storage |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eMarketing Commands\u003c/summary\u003e\n\n| Command | Description |\n|---------|-------------|\n| `/campaign [name]` | Marketing campaign orchestration and management |\n| `/seo [target]` | SEO audit, keyword research, and optimization |\n| `/social-media [platform]` | Social media content strategy and scheduling |\n| `/email-marketing [campaign]` | Email campaign design and automation |\n| `/competitive [target]` | Competitive analysis and market intelligence |\n| `/ad-campaign [platform]` | Paid advertising campaign management |\n| `/content-calendar [period]` | Editorial calendar planning and management |\n| `/ab-test [target]` | A/B testing design and analysis |\n| `/analytics [report]` | Marketing analytics and performance reporting |\n| `/funnel [stage]` | Conversion funnel analysis and optimization |\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eUtility Commands\u003c/summary\u003e\n\n| Command | Description |\n|---------|-------------|\n| `/cleanup [target]` | Technical debt reduction |\n| `/estimate [target]` | Evidence-based estimation |\n| `/index [query]` | Command catalog search |\n| `/load [path]` | Project context loading |\n| `/doctor` | Automated health check |\n| `/export [platform]` | Cross-platform agent/skill export |\n\n\u003c/details\u003e\n\n## Skills\n\n113 auto-activating domain skills organized in six categories.\n\n\u003cdetails\u003e\n\u003csummary\u003eCore Skills (8)\u003c/summary\u003e\n\norchestration, cognitive-routing, lifelong-learning, token-efficiency, principles, coding-standards, security-standards, testing-standards\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003ePersona Skills (11)\u003c/summary\u003e\n\narchitect, frontend, backend, security, analyzer, performance, qa, refactorer, devops, mentor, scribe\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eUtility Skills (8)\u003c/summary\u003e\n\ngit-workflow, tdd-workflow, delegation, mcp-context7, mcp-playwright, mcp-coordination, continuous-learning, strategic-compact\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eLanguage Skills (16)\u003c/summary\u003e\n\nTypeScript, JavaScript, Python, Go, Rust, Java, Kotlin, Swift, C++, C#, Ruby, PHP, Scala, Elixir, R, Flutter/Dart\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eMarketing Skills (34)\u003c/summary\u003e\n\nmarketing-strategy, campaign-planning, seo-strategy, technical-seo, content-seo, social-media, email-marketing, competitive-intelligence, advertising, ab-testing, brand-guidelines, copywriting, customer-journey, data-analysis, data-visualization, lead-management, marketing-analytics, presentation-design, report-generation, segmentation, cro-page, cro-funnel, cro-forms, and more\n\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eWorkflow Skills (8)\u003c/summary\u003e\n\ndaily (work recap/retrospective), team (parallel orchestration), session-worklog (auto session tracking), vibe-coding (natural language coding protocol), repo-benchmarking (external repo analysis and comparison), auto-learning-pipeline (zero-config nightly self-improvement), git-worktree (worktree isolation), dynamic-context-injection (runtime context management)\n\n\u003c/details\u003e\n\n## Hooks\n\n23 hook registrations across 15 event types.\n\n\u003cdetails\u003e\n\u003csummary\u003eHook Event Table\u003c/summary\u003e\n\n| Event | Script | Purpose |\n|-------|--------|---------|\n| SessionStart | `session-start.js` | Environment detection, config loading |\n| PreToolUse (Write) | `pre-write.js` | Block writes to sensitive files (.env, .pem) |\n| PreToolUse (Bash) | `pre-bash.js` | Block dangerous commands (rm -rf, force push) |\n| PostToolUse (Edit) | `post-edit-format.js` | Auto-format suggestion for JS/TS |\n| PostToolUse (Bash) | `post-bash.js` | Auto-detect PR URLs after git push |\n| PreCompact | `pre-compact.js` | State snapshot before context compression |\n| Stop | `check-console-log.js` | Detect leftover console.log statements |\n| UserPromptSubmit | `user-prompt-handler.js` | Intent detection and agent suggestion |\n| UserPromptSubmit | `cognitive-router.js` | System 1/2 cognitive routing classification |\n| SubagentStart/Stop | `subagent-handler.js` | Teammate registration/deregistration tracking |\n| TeammateIdle | `team-idle-handler.js` | Alert idle teammates about pending tasks |\n| SessionEnd | `session-end.js` | Persist session state |\n| SessionEnd | `nightly-learner.js` | Batch learning (GRPO) + knowledge transfer |\n| SessionEnd | `http-notify.js` | HTTP webhook notifications (Slack/Discord/generic) |\n\n\u003c/details\u003e\n\n## Auto-Update\n\nArtibot checks for new versions on session start via GitHub Releases API (24h cached).\n\n```\nSession start:\n  Artibot v1.8.0 initialized\n  ✅ You are running the latest version\n```\n\n**`/update` command** (flat install; `/artibot:update` if installed via marketplace)**:**\n\n| Flag | Behavior |\n|------|----------|\n| `--check` | Check version only (default) |\n| `--force` | Clear cache and force reinstall |\n| `--dry-run` | Show plan without executing |\n\n## MCP Integration\n\nArtibot integrates with MCP servers for extended capabilities:\n\n**Context7** -- Library and framework documentation lookup\n```json\n{\n  \"context7\": {\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"@upstash/context7-mcp@latest\"]\n  }\n}\n```\n\n**Playwright** -- Cross-browser E2E testing, performance metrics, visual testing\n```json\n{\n  \"playwright\": {\n    \"command\": \"npx\",\n    \"args\": [\"-y\", \"@executeautomation/playwright-mcp-server\"]\n  }\n}\n```\n\n## Cross-Platform Compatibility\n\nArtibot includes platform adapters for use beyond Claude Code:\n\n| Platform | Adapter | Status |\n|----------|---------|--------|\n| **Claude Code** | Native (no adapter needed) | Full support |\n| **Gemini CLI** | `adapters/gemini-cli.js` | Agent mapping, command translation |\n| **OpenAI Codex** | `adapters/openai-codex.js` | Tool mapping, prompt adaptation |\n| **Cursor** | `adapters/cursor.js` | Extension integration, command bridging |\n\nEach adapter translates Artibot's Agent Teams API calls into the target platform's native orchestration primitives while preserving the CTO-led coordination pattern.\n\n## Plugin Structure\n\n\u003cdetails\u003e\n\u003csummary\u003eView directory tree\u003c/summary\u003e\n\n```\nplugins/artibot/\n+-- .claude-plugin/\n|   +-- plugin.json              # Plugin manifest\n+-- agents/                      # 28 agent definitions\n|   +-- orchestrator.md          #   CTO / Team leader (Agent Teams API)\n|   +-- [17 dev specialists].md  #   Development teammates\n|   +-- [8 marketing agents].md  #   Marketing specialists\n+-- commands/                    # 72 slash commands\n|   +-- sc.md                    #   Smart router\n|   +-- daily.md                 #   Daily work recap and retrospective\n|   +-- team.md                  #   Parallel team orchestration\n|   +-- orchestrate.md           #   Team orchestration (TeamCreate)\n|   +-- spawn.md                 #   Team spawn (parallel execution)\n|   +-- [25 dev commands].md\n|   +-- [10 marketing commands].md\n+-- skills/                      # 113 skill directories\n|   +-- orchestration/           #   Delegation mode + team routing\n|   +-- cognitive-routing/       #   System 1/2 dual-process routing\n|   +-- lifelong-learning/       #   GRPO batch learning + knowledge transfer\n|   +-- delegation/              #   Sub-Agent/Team strategies\n|   +-- auto-learning-pipeline/  #   Zero-config nightly self-improvement\n|   +-- [23 dev skills]/\n|   +-- [23 marketing skills]/\n|   +-- [7 workflow skills]/\n+-- rules/                       # 8 auto-activating rules\n|   +-- dev-protocol.md          #   DEV (Decompose-Execute-Verify) protocol\n|   +-- quality-gates.md         #   Quality enforcement gates\n|   +-- agent-coordination.md    #   Agent collaboration patterns\n|   +-- [4 domain rules].md\n+-- hooks/\n|   +-- hooks.json               # Hook event mappings\n+-- scripts/\n|   +-- hooks/                   # 59 hook scripts (ESM)\n|   +-- ci/                      # 6 CI validation scripts\n|   +-- evals/                   # Runtime eval suite\n|   +-- utils/\n+-- lib/\n|   +-- core/                    # Core modules (platform, config, cache, playbook-parser, playbook-registry, guard-registry, event-bus, blocked-patterns)\n|   +-- runtime/                 # Runtime pipeline (12 files, 9 middlewares: router, subagents, tasks, checkpoint, memory, skills, guardrail, token-usage, summarization)\n|   +-- visual/                  # Visual validation (SSIM differ, style-fixer, validator)\n|   +-- intent/                  # Intent detection (language, trigger)\n|   +-- context/                 # Context management (session)\n|   +-- privacy/                 # PII protection (pii-detector, pii-scrubber, homoglyph, token-rotation, differential-privacy)\n|   +-- learning/                # Lifelong learning (15 modules: memory, GRPO, pattern-analyzer, tool-history, rule-extractor, skill-injector, knowledge-demotion, etc.)\n|   +-- adapters/                # Cross-platform adapters\n+-- output-styles/               # 7 output styles (default, compressed, mentor, team-dashboard, tokens, narrative, statusline)\n+-- templates/                   # 5 writing templates\n+-- artibot.config.json          # Plugin config (Agent Teams settings)\n+-- package.json                 # Node.js ESM runtime\n+-- .mcp.json                    # MCP server configuration\n```\n\n\u003c/details\u003e\n\n## Configuration\n\nKey settings in `artibot.config.json`:\n\n| Setting | Description | Default |\n|---------|-------------|---------|\n| `version` | Plugin version | `1.14.1` |\n| `cognitive.router.threshold` | System 1/2 boundary | `0.4` |\n| `cognitive.router.adaptRate` | Per-feedback adjustment step | `0.05` |\n| `cognitive.system1.maxLatency` | System 1 max response time (ms) | `100` |\n| `cognitive.system1.minConfidence` | System 1 minimum confidence | `0.6` |\n| `cognitive.system2.maxRetries` | System 2 max retry attempts | `3` |\n| `cognitive.system2.sandboxEnabled` | Enable sandbox for high-risk ops | `true` |\n| `learning.lifelong.batchSize` | Experiences per GRPO batch | `50` |\n| `learning.lifelong.grpoGroupSize` | Experiences per comparison group | `5` |\n| `learning.knowledgeTransfer.promotionThreshold` | Consecutive successes to promote | `3` |\n| `learning.knowledgeTransfer.demotionThreshold` | Consecutive failures to demote | `2` |\n| `team.engine` | Team engine | `claude-agent-teams` |\n| `team.delegationMode` | Leader coordination-only mode | `true` |\n| `team.maxTeammates` | Max concurrent teammates | `null` (unlimited) |\n| `team.ctoAgent` | CTO agent name | `orchestrator` |\n| `team.levels.squad` | Squad team size | `2-4` |\n| `team.levels.platoon` | Platoon team size | `5+` |\n| `automation.intentDetection` | Auto intent detection | `true` |\n| `automation.supportedLanguages` | Supported languages | `en, ko, ja, zh` |\n\n## Validation\n\n```bash\nnode scripts/validate.js              # Full validation\nnode scripts/ci/validate-agents.js    # Agent validation\nnode scripts/ci/validate-skills.js    # Skill validation\nnode scripts/ci/validate-commands.js  # Command validation\nnode scripts/ci/validate-hooks.js     # Hook validation\n```\n\n## Best Practices\n\n- **Use `/sc` for auto-routing** -- Let the smart router pick the optimal command and delegation mode\n- **Trust the delegation scoring** -- Simple tasks use fast sub-agents; complex tasks get full teams\n- **Enable Agent Teams** -- Without `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1`, team features won't work\n- **Let teammates self-claim** -- The Swarm pattern works best when teammates pick tasks from the shared list\n- **Use playbooks for common workflows** -- 8 playbooks (4 dev + 4 marketing) provide proven team patterns\n- **Leverage marketing specialists** -- Use `/campaign` and related commands for end-to-end marketing orchestration\n\n## When to Use Artibot\n\n**Use for:**\n- Complex feature implementation spanning multiple files and domains\n- Security audits requiring multi-perspective analysis\n- Large-scale refactoring with coordinated testing\n- Architecture decisions needing specialist input\n- Marketing campaigns requiring strategy, content, SEO, and analytics coordination\n- Competitive analysis with data-driven insights\n- Any task benefiting from parallel agent collaboration\n\n**Don't use for:**\n- Single-line bug fixes\n- Trivial edits or formatting changes\n- Tasks where a single agent is sufficient\n- Quick questions or explanations (unless you want team discussion)\n\n## Troubleshooting\n\n### Agent Teams not working\n\n**Issue**: TeamCreate or SendMessage not available\n\n**Solution**: Ensure the environment variable is set:\n```json\n// ~/.claude/settings.json\n{\n  \"env\": {\n    \"CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS\": \"1\"\n  }\n}\n```\n\n### Teammates not picking up tasks\n\n**Issue**: Tasks stay in \"pending\" status\n\n**Solution**:\n- Verify tasks have no unresolved `blockedBy` dependencies\n- Check that teammates are spawned with correct `team_name`\n- Use `TaskUpdate` to explicitly assign if self-claim isn't working\n\n### High token usage\n\n**Issue**: Team orchestration consuming too many tokens\n\n**Solution**:\n- Use Sub-Agent mode for simpler tasks (score \u003c 0.4)\n- Reduce team size with `--agents` flag\n- Enable token efficiency with `--uc` flag\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for the full guide on adding skills, agents, and commands.\n\n1. Fork this repository\n2. Create a feature branch\n3. Follow the existing plugin structure and conventions\n4. Run `npm run ci` to validate\n5. Submit a pull request\n\n## Author\n\n**Artience** ([@Yoodaddy0311](https://github.com/Yoodaddy0311))\n\n## Quick Links\n\n| Resource | Path |\n|---|---|\n| **Installation guide** | [`INSTALL.md`](./INSTALL.md) |\n| **Contributing guide** | [`CONTRIBUTING.md`](./CONTRIBUTING.md) |\n| **CHANGELOG** (root summary) | [`CHANGELOG.md`](./CHANGELOG.md) |\n| **CHANGELOG** (full detail) | [`plugins/artibot/CHANGELOG.md`](./plugins/artibot/CHANGELOG.md) |\n| **artibot plugin README** (Claude Code) | [`plugins/artibot/README.md`](./plugins/artibot/README.md) |\n| **artibot-cowork plugin README** (Claude Cowork) | [`plugins/artibot-cowork/README.md`](./plugins/artibot-cowork/README.md) |\n| **Architecture deep dive** | `plugins/artibot/docs/ARCHITECTURE.md` (see CHANGELOG for module map) |\n| **MCP server usage** | `plugins/artibot/docs/MCP-SETUP.md` |\n| **Marketplace submission package** | [`plugins/artibot/_marketplace/`](./plugins/artibot/_marketplace/) |\n\n## When to use which\n\n```\n                          ┌──────────────────────────┐\n        Developer task →  │  artibot (Claude Code)   │  ← TDD, /code-review, /implement, /orchestrate\n                          └──────────────────────────┘\n\n                          ┌──────────────────────────┐\n   Knowledge-worker task → │  artibot-cowork (Cowork) │  ← /campaign, long-form writing, KR SEO\n                          └──────────────────────────┘\n```\n\nYou can install **both** in the same Anthropic account — `artibot` runs in your Claude Code terminal sessions, `artibot-cowork` runs in your Cowork chat. They never interfere because they target different runtimes.\n\n## Version\n\n**4.13.0** (2026-05-19) — feat: `/save` single-shot session handoff command (+`/resume`) — `.artibot/HANDOFF.md` produces 5s next-session context restore. Safety boost: YAML frontmatter (machineId/createdAt/branch), git-lock graceful fail (5s timeout), 10m archive throttle, atomic advisor consumed marking. See [CHANGELOG](./plugins/artibot/CHANGELOG.md) for full history.\n\n**4.12.0** (2026-05-19) — Comprehensive audit fixes: security hardening (timing-safe auth, K_SERVICE bypass removed, shell-injection surfaces eliminated), manifest drift sync, layer-cycle fix.\n\n[📖 Full release notes (비개발자용)](./RELEASE_NOTES_4.8_KO.md) · [CHANGELOG](./plugins/artibot/CHANGELOG.md)\n\n## License\n\nMIT License — see [LICENSE](LICENSE) for details. Both `plugins/artibot/` and `plugins/artibot-cowork/` ship under MIT, matching the upstream marketplace policy.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyoodaddy0311%2Fartibot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyoodaddy0311%2Fartibot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyoodaddy0311%2Fartibot/lists"}