Configuration Reference - CCG Workflow Setup

This reference covers the full file layout, configuration options, and environment variables for CCG Workflow.

Installation Directory Structure

The complete file layout after CCG installation:

~/.claude/
├── commands/ccg/           # Slash commands (13 .md files)
│   ├── go.md               # /ccg:go smart entry point
│   ├── commit.md           # /ccg:commit
│   ├── rollback.md         # /ccg:rollback
│   ├── clean-branches.md   # /ccg:clean-branches
│   ├── worktree.md         # /ccg:worktree
│   ├── init.md             # /ccg:init
│   ├── context.md          # /ccg:context
│   ├── spec-init.md        # /ccg:spec-init
│   ├── spec-research.md    # /ccg:spec-research
│   ├── spec-plan.md        # /ccg:spec-plan
│   ├── spec-impl.md        # /ccg:spec-impl
│   └── spec-review.md      # /ccg:spec-review
│
├── hooks/ccg/              # Hook scripts (4 .js files)
│   ├── workflow-state.js   # Per-turn state injection
│   ├── session-start.js    # Session startup context
│   ├── subagent-context.js # Sub-agent spec injection
│   └── skill-router.js     # Domain knowledge auto-routing
│
├── .ccg/
│   ├── config.toml         # CCG main configuration
│   ├── engine/             # Strategy engine
│   │   ├── strategies/     # 10 strategy definition files
│   │   └── router.js       # Model router
│   └── prompts/            # Expert prompts
│       ├── codex/          # Codex experts (6)
│       └── gemini/         # Gemini experts (7)
│
├── skills/ccg/             # Quality gates + domain knowledge
│   ├── tools/
│   │   ├── verify-security/
│   │   ├── verify-quality/
│   │   ├── verify-change/
│   │   ├── verify-module/
│   │   └── gen-docs/
│   ├── orchestration/
│   │   └── multi-agent/
│   └── domains/            # Domain knowledge files
│       ├── security/
│       ├── architecture/
│       ├── ai/
│       ├── devops/
│       └── development/
│
├── bin/
│   └── codeagent-wrapper   # Multi-model execution bridge (compiled Go binary)
│
└── settings.json           # Hook registration + env vars

config.toml

The main configuration file lives at ~/.claude/.ccg/config.toml:

[models]
# Model routing configuration
frontend = "gemini"          # Route frontend tasks to Gemini
backend = "codex"            # Route backend tasks to Codex

[mcp]
# MCP tool configuration
provider = "fast-context"    # fast-context / ace-tool / context-weaver

[performance]
# Performance mode
parallel = true              # Enable dual-model parallel execution
timeout = 7200               # Wrapper timeout (seconds)

Environment Variables

Set in the "env" field of ~/.claude/settings.json:

Variable	Default	Description
CODEX_TIMEOUT	7200	codeagent-wrapper timeout in seconds
CODEAGENT_POST_MESSAGE_DELAY	5	Delay after wrapper execution completes (seconds)
CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS	unset	Set to 1 to enable Agent Teams parallel execution

Tip

CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS is a Claude Code experimental feature flag. When enabled, the full-collaborate strategy in /ccg:go can spawn Builder teammates for parallel coding.

settings.json Structure

The installer modifies ~/.claude/settings.json to add hook registrations and environment variables:

{
  "hooks": {
    "UserPromptSubmit": [
      { "type": "command", "command": "node ~/.claude/hooks/ccg/workflow-state.js" },
      { "type": "command", "command": "node ~/.claude/hooks/ccg/skill-router.js" }
    ],
    "SessionStart": [
      { "type": "command", "command": "node ~/.claude/hooks/ccg/session-start.js" }
    ],
    "PreToolUse": [
      { "type": "command", "command": "node ~/.claude/hooks/ccg/subagent-context.js" }
    ]
  },
  "env": {
    "CODEX_TIMEOUT": "7200",
    "CODEAGENT_POST_MESSAGE_DELAY": "5"
  },
  "permissions": {
    "allow": [
      "Bash(node ~/.claude/hooks/ccg/*)",
      "Bash(~/.claude/bin/codeagent-wrapper*)"
    ]
  }
}

Project-Level Configuration

The .ccg/ directory in your project root stores task state and coding standards:

<project-root>/
└── .ccg/
    ├── tasks/              # Task persistence directory
    │   └── <task-slug>/
    │       ├── task.json
    │       ├── plan.md
    │       └── ...
    └── spec/               # Project coding standards
        ├── backend/index.md
        ├── frontend/index.md
        └── guides/index.md

Note

It is recommended to add .ccg/tasks/ to .gitignore (transient state), but .ccg/spec/ should be committed to Git — project coding standards should be shared with your team.

Updating and Uninstalling

# Update to the latest version
npx ccg-workflow@latest

# Open the interactive menu (includes uninstall option)
npx ccg-workflow

The uninstaller cleanly removes all installed files: commands, hooks, config, skills, and binaries. It does not affect non-CCG configurations in ~/.claude/settings.json.