# CC 2.1.84 Adoption Brainstorm

OrchestKit Integration Opportunities Explorer
2026-03-26 | OrchestKit 7.23.0 -> 7.24.0
25 integration opportunities 10 quick wins 9 medium effort 6 large/auto 5 categories
Effort:
Impact:
Category:
10
Quick Wins (<1hr each)
9
Medium Effort (2-4hrs)
3
Large Effort (1+ day)
3
Automatic Benefits

### Top 5 High-Impact Integrations

1. TaskCreated Hook Event
Hook Medium High Impact
New hook event fires when TaskCreate tool is used. Enables task initialization tracking, auto-assignment, prerequisite validation, and context injection. OrchestKit already has TaskCompleted with 3 handlers — mirror that pattern.
9/10
2. Skill paths: Field (YAML Glob Lists)
Skill Quick High Impact
Skills can now declare `paths:` in frontmatter — a YAML list of globs that auto-load relevant files when the skill activates. Currently unused across all 99 skills. Massive opportunity: implement, design-to-code, memory, storybook-mcp, mcp-patterns are top candidates.
9/10
3. Workflow Subagent json-schema Fix
Agent Medium High Impact
Previously: outer session with --json-schema + subagent with schema = API 400 error. Now fixed. Unblocks structured output in brainstorm (4 agents), implement (5 agents), cover (3 agents), verify (4 agents). bare-eval already uses --json-schema — can expand to all workflow skills.
8/10
4. Doctor Version Matrix Update
Docs Quick High Impact
Doctor skill's CC version compatibility matrix (77+ features through 2.1.83) is the canonical reference. Must add 2.1.84 features: TaskCreated hook, WorktreeCreate HTTP, paths glob list, ANTHROPIC_DEFAULT_* env vars, CLAUDE_STREAM_IDLE_TIMEOUT_MS, allowedChannelPlugins, PowerShell tool.
8/10
5. WorktreeCreate HTTP Type
Hook Quick High Impact
WorktreeCreate hook now supports type: "http" — returns worktree path via hookSpecificOutput.worktreePath. 24 agents use worktree isolation. Existing worktree-lifecycle-logger.ts needs update to handle HTTP type and return the path. Enables API-driven worktree orchestration.
8/10

### Impact vs Effort Matrix

Click any item to see details in the Opportunities tab

#### Quick Win + High Impact

#2 paths: field on 15+ skills
#4 Doctor matrix update
#5 WorktreeCreate HTTP type
#14 Bump CC req to >= 2.1.84

#### Medium Effort + High Impact

#1 TaskCreated hook event
#3 Subagent json-schema
#10 owner/repo#123 format in skill output

#### Large Effort

#22 PowerShell Windows support
#23 Enterprise channel plugin template
#24 Full structured output pipeline

#### Quick Win + Medium Impact

#6 ANTHROPIC_DEFAULT_* env vars
#8 CLAUDE_STREAM_IDLE_TIMEOUT_MS
#9 MCP 2KB cap docs
#11 MCP dedup docs
#15 Deep link terminal pref docs

#### Medium Effort + Medium Impact

#7 MODEL_NAME/DESCRIPTION labels
#12 Idle-return session handoff
#13 allowedChannelPlugins template
#16 Bash stuck detection awareness

#### Automatic Benefits (free)

#17 System-prompt caching + ToolSearch
#18 MCP startup parallelism
#19 MCP cache leak fix
#20 Startup 30ms improvement
#21 p90 cache rate improvement
#1 TaskCreated Hook Event
Hook Medium High Impact
New CC 2.1.84 hook event fires when TaskCreate tool is invoked. OrchestKit has TaskCompleted (3 handlers) but no TaskCreated. Gap: task initialization tracking, auto-assignment, prerequisite validation, context pre-injection.
Files: src/hooks/src/task-created/ (new dir) Effort: ~3 hours Blocked by: CC >= 2.1.84

#### What to build

- Create `src/hooks/src/task-created/` directory with unified-dispatcher.ts
- Handler 1: task-metadata-injector — enriches task with project context (branch, milestone)
- Handler 2: task-dependency-validator — checks blockedBy tasks exist and are valid
- Handler 3: task-progress-tracker — logs task creation to .claude/logs/task-activity.jsonl

#### Pattern to follow

    // Mirror TaskCompleted pattern:
    // src/hooks/src/task-completed/completion-tracker.ts
    // src/hooks/src/task-completed/task-commit-linker.ts
    // src/hooks/src/task-completed/task-progress-tracker.ts

#### hooks.json registration

    {
      "event": "TaskCreated",
      "command": "${CLAUDE_PLUGIN_ROOT}/hooks/bin/run-hook.mjs task-created/unified-dispatcher",
      "description": "Track task creation, inject metadata, validate dependencies"
    }

#2 Skill paths: Field (YAML Glob Lists)
Skill Quick Win High Impact
CC 2.1.84 adds `paths:` frontmatter — a YAML list of globs auto-loaded when skill activates. Currently 0/99 skills use it. Auto-loads relevant context without manual Read calls.
Files: 15-20 SKILL.md files Effort: ~20 min per skill Priority skills: implement, design-to-code, memory, storybook-mcp, mcp-patterns

#### Top candidates with recommended paths

    # implement/SKILL.md
    paths:
      - "src/**/*.{ts,tsx}"
      - "package.json"
      - "tsconfig.json"
      - "CLAUDE.md"

    # design-to-code/SKILL.md
    paths:
      - "src/components/**/*.{tsx,css}"
      - "**/*design-tokens*"
      - ".storybook/**"

    # memory/SKILL.md
    paths:
      - ".claude/memory/**"
      - ".claude/projects/**/memory/**"

    # storybook-mcp-integration/SKILL.md
    paths:
      - ".storybook/**"
      - "src/**/*.stories.{ts,tsx}"

    # database-patterns/SKILL.md
    paths:
      - "**/migrations/**"
      - "**/models/**"
      - "alembic.ini"

#### Full list of candidates

- implement — src files, package.json, configs
- design-to-code — components, design tokens, storybook
- memory — .claude/memory directory
- storybook-mcp-integration — storybook config, stories
- mcp-patterns — .mcp.json, MCP server files
- database-patterns — migrations, models, alembic
- cover — test files, coverage config
- fix-issue — src files for debugging
- devops-deployment — .github/workflows, Dockerfile, k8s
- ci-cd-engineer — CI config files
- security-patterns — auth files, middleware
- architecture-patterns — src directory structure
- next-best-practices — app/, pages/, next.config
- terraform-style-guide — *.tf files
- configure — .claude/settings*, plugin manifests

#3 Workflow Subagent json-schema
Agent Medium High Impact
Fixed: outer session + subagent both specifying --json-schema no longer returns API 400. Unblocks structured output in all multi-agent workflow skills. 23 skills spawn subagents but 0 use structured output schemas today.
Skills affected: brainstorm, implement, cover, verify, review-pr, fix-issue, explore, assess Effort: ~3 hours total

#### Where to add structured output

- brainstorm — Phase 2 divergent ideas: schema for { ideas: [{title, description, feasibility}] }
- implement — Architecture plan: schema for { components: [{file, purpose, dependencies}] }
- cover — Coverage matrix: schema for { coverage: [{file, testFile, coveragePercent}] }
- verify — Verification results: schema for { checks: [{name, pass, details}] }
- assess — Rating output: schema for { score, dimensions: [{name, score, reason}] }

#### Implementation pattern

    // In Agent() calls within workflow skills:
    Agent(
      subagent_type="backend-system-architect",
      prompt="Analyze architecture for...",
      // NEW: structured output schema
      jsonSchema={
        type: "object",
        properties: {
          components: { type: "array", items: {...} },
          risks: { type: "array", items: {...} },
          recommendation: { type: "string" }
        }
      }
    )

Note: This is a documentation/skill-body change — Agent() calls are in SKILL.md prose, not compiled code.

#4 Doctor Version Compatibility Matrix
Docs Quick Win High Impact
Doctor skill has 77+ CC features mapped through 2.1.83. Must add all 2.1.84 features to maintain it as the canonical version reference.
File: src/skills/doctor/references/version-compatibility.md Effort: ~30 min

#### Features to add

    | Feature | Min CC Version | OrchestKit Usage |
    |---------|---------------|------------------|
    | TaskCreated hook event | 2.1.84 | task-created/ handlers |
    | WorktreeCreate type: "http" | 2.1.84 | worktree-lifecycle-logger |
    | paths: YAML glob list (skills) | 2.1.84 | 15+ skills |
    | ANTHROPIC_DEFAULT_*_MODEL_SUPPORTS | 2.1.84 | ork.settings.json |
    | ANTHROPIC_DEFAULT_*_MODEL_NAME | 2.1.84 | /model picker |
    | CLAUDE_STREAM_IDLE_TIMEOUT_MS | 2.1.84 | Long-running agents |
    | allowedChannelPlugins | 2.1.84 | Enterprise template |
    | x-client-request-id header | 2.1.84 | Debug timeouts |
    | PowerShell tool (Windows) | 2.1.84 | Not yet |
    | MCP 2KB description cap | 2.1.84 | Awareness |
    | MCP server deduplication | 2.1.84 | Automatic |
    | Workflow subagent json-schema fix | 2.1.84 | bare-eval, workflows |
    | System-prompt caching + ToolSearch | 2.1.84 | Automatic |
    | Idle-return 75min prompt | 2.1.84 | Automatic |
    | owner/repo#123 link format | 2.1.84 | Skill output |

#5 WorktreeCreate HTTP Type
Hook Quick Win High Impact
WorktreeCreate hook now supports type: "http" — returns worktree path via hookSpecificOutput.worktreePath in response JSON. 24 agents use worktree isolation. Enables API/remote-driven worktree management.
File: src/hooks/src/worktree/worktree-lifecycle-logger.ts Effort: ~45 min

#### Current handler

worktree-lifecycle-logger.ts handles WorktreeCreate with monorepo detection and sparsePaths advisory. Needs update to:

- Detect type: "http" in hook input
- Return hookSpecificOutput.worktreePath in response JSON
- Enable remote/API-triggered worktree creation for CI/CD and remote agents

    // Updated handler pattern:
    if (input.type === 'http') {
      return {
        hookSpecificOutput: {
          worktreePath: computedWorktreePath
        },
        // ... existing monorepo detection
      };
    }

#6 ANTHROPIC_DEFAULT_* Environment Variables
Setting Quick Win Medium Impact
New env vars for 3P providers (Bedrock, Vertex, Foundry): ANTHROPIC_DEFAULT_{OPUS,SONNET,HAIKU}_MODEL_SUPPORTS overrides capability detection. Critical for enterprise users with custom model deployments.
Files: ork.settings.json, setup skill, configure skill Effort: ~30 min

#### Settings to add

    // ork.settings.json env section (commented out, for 3P users):
    "env": {
      // ... existing vars ...
      // "ANTHROPIC_DEFAULT_OPUS_MODEL_SUPPORTS": "effort,thinking",
      // "ANTHROPIC_DEFAULT_SONNET_MODEL_SUPPORTS": "effort,thinking",
      // "ANTHROPIC_DEFAULT_HAIKU_MODEL_SUPPORTS": "effort",
      // "ANTHROPIC_DEFAULT_OPUS_MODEL_NAME": "Custom Opus",
      // "ANTHROPIC_DEFAULT_OPUS_MODEL_DESCRIPTION": "My custom Opus deployment"
    }

#### Documentation updates

- Setup skill: add 3P provider configuration section
- Configure skill: document env var options
- Doctor skill: add to version matrix

#7 Model Picker Labels (MODEL_NAME/DESCRIPTION)
Setting Medium Medium Impact
ANTHROPIC_DEFAULT_*_MODEL_NAME and _DESCRIPTION customize the /model picker labels. Nice for enterprise deployments with custom model names.
Files: configure skill, setup skill Effort: ~1 hour
#8 CLAUDE_STREAM_IDLE_TIMEOUT_MS
Setting Quick Win Medium Impact
Configurable streaming idle watchdog threshold (default 90s). Long-running OrchestKit agents (audit-full, implement with 50+ turns) can hit this. Recommend setting to 180s or 300s.
File: ork.settings.json Effort: ~15 min

    // ork.settings.json
    "env": {
      // ... existing vars ...
      "CLAUDE_STREAM_IDLE_TIMEOUT_MS": "180000"  // 3 min for long agents
    }

#9 MCP 2KB Tool Description Cap
Docs Quick Win Medium Impact
MCP tool descriptions and server instructions now capped at 2KB. OrchestKit doesn't hit this, but users building custom MCP integrations need to know. Document in CONTRIBUTING-SKILLS.md and mcp-patterns skill.
Files: CONTRIBUTING-SKILLS.md, mcp-patterns/SKILL.md Effort: ~15 min
#10 owner/repo#123 Link Format
Skill Medium High Impact
Bare #123 no longer auto-linked in CC terminal output. Skills that output issue/PR references (create-pr, fix-issue, github-operations, commit) should use owner/repo#123 format for clickable links.
Files: 6-8 skill SKILL.md files Effort: ~2 hours

#### Skills to update

- create-pr — output references like "Created PR owner/repo#123"
- fix-issue — "Investigating owner/repo#456"
- github-operations — all issue/PR references in examples
- commit — "Closes owner/repo#789" in commit messages
- review-pr — PR review output references
- visualize-plan — issue reference inputs

#### Pattern

    # Before (CC < 2.1.84):
    "Created PR #123"

    # After (CC >= 2.1.84):
    "Created PR owner/repo#123"  // clickable link

    # In code, use git remote to detect owner/repo:
    git remote get-url origin | sed 's/.*github.com[:/]\(.*\)\.git/\1/'

#11 MCP Server Deduplication
Docs Quick Win Medium Impact
MCP servers configured both locally and via claude.ai connectors are now deduplicated — local config wins. Document in setup skill and mcp-patterns skill for users with both configurations.
Files: setup skill, mcp-patterns skill Effort: ~15 min
#12 Idle-Return Session Handoff
Hook Medium Medium Impact
CC 2.1.84 adds idle-return prompt after 75+ minutes nudging /clear. OrchestKit could enhance this: detect stale sessions in SessionStart, auto-inject last handoff context, suggest continuing from previous session state.
Files: SessionStart handler enhancement Effort: ~2 hours
#13 allowedChannelPlugins Template
Setting Medium Medium Impact
New managed setting for enterprise admins to define channel plugin allowlist. Create template/example for OrchestKit enterprise deployments.
Files: managed-settings template, setup skill Effort: ~2 hours
#14 Bump CC Version to >= 2.1.84
Docs Quick Win High Impact
Update CLAUDE.md version requirement from >= 2.1.83 to >= 2.1.84. Gates adoption of all new features. Add changelog entry for v7.24.0.
Files: CLAUDE.md, CHANGELOG.md Effort: ~10 min
#15 Deep Link Terminal Preference
Docs Quick Win Low Impact
Deep links (claude-cli://) now open in preferred terminal. Document in setup/doctor skills for users who use deep links.
#16 Background Bash Stuck Detection
Hook Medium Medium Impact
Background bash tasks stuck on interactive prompts now surface notification after ~45s. Could enhance OrchestKit's dangerous-command-blocker hook to preemptively detect interactive commands (ssh, vim, less) and block them in background agents.
File: pretool/bash/dangerous-command-blocker Effort: ~2 hours
#17-21 Automatic Benefits (Free Upgrades)
Auto Medium Impact
These improvements apply automatically when users upgrade to CC 2.1.84. No OrchestKit changes needed.
Effort: Zero

- #17 System-prompt caching + ToolSearch — OrchestKit uses ENABLE_TOOL_SEARCH=auto:5. Caching now works with ToolSearch enabled. Free perf boost.
- #18 MCP startup parallelism — REPL renders before all 7 MCP servers connect. Faster startup for OrchestKit users.
- #19 MCP cache leak fix — Fixed on server reconnect. 7 MCP servers benefit from no memory leak.
- #20 Startup 30ms improvement — setup() runs in parallel with slash command loading. Small but free.
- #21 p90 cache rate improvement — Better prompt caching. Token savings for all OrchestKit sessions.

#22 PowerShell Tool Support (Windows)
Hook Large Medium Impact
CC 2.1.84 adds PowerShell tool as opt-in preview. OrchestKit currently assumes Git Bash on Windows. Could add PowerShell-aware hooks: command translation, path handling, encoding. Affects 106 hooks.
Effort: 1-2 days Risk: Large surface area, needs testing on Windows
#23 Enterprise Channel Plugin Template
Setting Large Medium Impact
Create full enterprise deployment template with allowedChannelPlugins, managed-settings.d/ fragments, channel plugin configuration. For team/enterprise admin adoption.
Effort: 1+ day
#24 Full Structured Output Pipeline
Agent Large High Impact
Add json-schema structured output to ALL 23 workflow skills that spawn subagents. Define Zod schemas per agent output type, validate responses, enable chaining. Builds on #3 fix.
Effort: 2-3 days Depends on: #3 (json-schema fix)
#25 x-client-request-id Header
Docs Quick Win Low Impact
CC now sends x-client-request-id header on API requests for debugging timeouts. Document in monitoring-observability skill for users who track request correlation.

### Implementation Timeline

Phase 1: Quick Wins (v7.24.0) ~4 hours total

- #14 Bump CC version to >= 2.1.84 in CLAUDE.md
- #4 Update doctor version compatibility matrix (15 new features)
- #5 WorktreeCreate HTTP type — update worktree-lifecycle-logger.ts
- #2 Add paths: field to top 5 skills (implement, design-to-code, memory, storybook-mcp, mcp-patterns)
- #8 Add CLAUDE_STREAM_IDLE_TIMEOUT_MS=180000 to ork.settings.json
- #6 Add ANTHROPIC_DEFAULT_* env vars (commented out) to settings
- #9 Document MCP 2KB cap in CONTRIBUTING-SKILLS.md
- #11 Document MCP dedup in setup/mcp-patterns skills
- #15 Document deep link terminal preference
- #25 Document x-client-request-id in monitoring skill

Phase 2: Core Integrations (v7.25.0) ~16 hours total

- #1 TaskCreated hook — 3 handlers (metadata-injector, dependency-validator, progress-tracker)
- #10 Update 6-8 skills for owner/repo#123 link format
- #2 Add paths: field to remaining 10-15 skills
- #3 Add json-schema to 3-4 key workflow skills (brainstorm, implement, cover)
- #12 Idle-return session handoff — enhance SessionStart handler
- #13 allowedChannelPlugins template for enterprise
- #16 Enhance dangerous-command-blocker for background bash interactive detection
- #7 Document MODEL_NAME/DESCRIPTION in configure skill

Phase 3: Large Investments (v7.26.0+) ~5 days total

- #24 Full structured output pipeline — json-schema for all 23 workflow skills
- #22 PowerShell Windows support — hook translation layer
- #23 Enterprise channel plugin deployment template

### Ready-to-Use Implementation Prompts

Copy these directly into Claude Code to implement each integration

#### Phase 1: Version Bump + Doctor Matrix

    Bump OrchestKit CC version requirement from >= 2.1.83 to >= 2.1.84 in CLAUDE.md. Then update the doctor skill's version compatibility matrix (src/skills/doctor/references/version-compatibility.md) to add all CC 2.1.84 features: TaskCreated hook, WorktreeCreate HTTP type, paths YAML glob list, ANTHROPIC_DEFAULT_*_MODEL_SUPPORTS, ANTHROPIC_DEFAULT_*_MODEL_NAME/_DESCRIPTION, CLAUDE_STREAM_IDLE_TIMEOUT_MS, allowedChannelPlugins, x-client-request-id header, PowerShell tool, MCP 2KB description cap, MCP server deduplication, workflow subagent json-schema fix, system-prompt caching with ToolSearch, idle-return 75min prompt, owner/repo#123 link format change. Follow existing matrix format.

#### Phase 1: Add paths: to Top 5 Skills

    CC 2.1.84 adds paths: frontmatter to skills — a YAML list of globs that auto-load relevant files when the skill activates. Add paths: to these 5 skills:

    1. src/skills/implement/SKILL.md — paths: ["src/**/*.{ts,tsx}", "package.json", "tsconfig.json", "CLAUDE.md"]
    2. src/skills/design-to-code/SKILL.md — paths: ["src/components/**/*.{tsx,css}", "**/*design-tokens*", ".storybook/**"]
    3. src/skills/memory/SKILL.md — paths: [".claude/memory/**", ".claude/projects/**/memory/**"]
    4. src/skills/storybook-mcp-integration/SKILL.md — paths: [".storybook/**", "src/**/*.stories.{ts,tsx}"]
    5. src/skills/mcp-patterns/SKILL.md — paths: [".mcp.json", "**/*.mcp.json"]

    Add after existing frontmatter fields, before the --- closing. Run npm run build after.

#### Phase 1: WorktreeCreate HTTP + Stream Timeout

    Two quick changes:

    1. Update src/hooks/src/worktree/worktree-lifecycle-logger.ts to handle WorktreeCreate type: "http" (new in CC 2.1.84). When input.type === 'http', return hookSpecificOutput.worktreePath in the response JSON alongside existing monorepo detection logic.

    2. Add CLAUDE_STREAM_IDLE_TIMEOUT_MS=180000 to the env section of src/settings/ork.settings.json (with a comment explaining it's for long-running agents like audit-full and implement).

    Build hooks after: cd src/hooks && npm run build. Then npm run build for plugins.

#### Phase 2: TaskCreated Hook

    /ork:implement Create a TaskCreated hook event handler for OrchestKit. CC 2.1.84 adds the TaskCreated hook event that fires when TaskCreate tool is invoked.

    Create src/hooks/src/task-created/ directory with:
    1. unified-dispatcher.ts — routes to sub-handlers (follow teammate-idle/unified-dispatcher pattern)
    2. task-metadata-injector.ts — enriches task with project context (current branch, milestone from gh)
    3. task-dependency-validator.ts — validates blockedBy tasks exist
    4. task-progress-tracker.ts — logs task creation to .claude/logs/task-activity.jsonl

    Register in src/hooks/hooks.json. Update hook count in CLAUDE.md (106 -> 109). Build and test.

#### Phase 2: owner/repo#123 Link Format

    CC 2.1.84 changed issue/PR references: bare #123 is no longer auto-linked in terminal output. Only owner/repo#123 renders as clickable.

    Update these skills to output issue/PR references in owner/repo#123 format instead of bare #123:
    - src/skills/create-pr/SKILL.md
    - src/skills/fix-issue/SKILL.md
    - src/skills/github-operations/SKILL.md
    - src/skills/commit/SKILL.md
    - src/skills/review-pr/SKILL.md
    - src/skills/visualize-plan/SKILL.md

    In each skill, find text output examples that use bare "#123" and change to detect owner/repo from git remote, then use "owner/repo#123" format. This is about terminal output text in skill instructions, not markdown file content.