kenken Configure

For Claude: This skill manages kenken configuration. Parse arguments and execute accordingly.

Arguments

--show

Display current configuration by:

1. •Load global config from ~/.claude/kenken-config.json (if exists)
2. •Load project config from .claude/kenken-config.json (if exists)
3. •Merge: project overrides global
4. •Display formatted output:

kenken Configuration

Block on severity: low

PLAN Stage:
  brainstorm: model=inherit, parallel=true
  writePlan: model=inherit, parallel=true
  planReview: tool=mcp__codex-high__codex

IMPLEMENT Stage:
  implementation: model=inherit, implementer=claude, bugFixer=codex-high, enforceLogging=true
  simplify: model=inherit, bugFixer=codex-high
  implementReview: tool=mcp__codex-high__codex, bugFixer=codex-high

TEST Stage: [disabled]
  instructions: (not configured)
  commands: lint=make lint, test=make test, coverage=make coverage
  coverageThreshold: 80%
  testPlan: model=inherit
  testImplementation: model=inherit
  testReview: tool=mcp__codex-high__codex

FINAL Stage:
  codexFinal: tool=mcp__codex-xhigh__codex (fixed)
  suggestExtensions: enabled=true, maxSuggestions=3

Config files:
  Global: ~/.claude/kenken-config.json [found/not found]
  Project: .claude/kenken-config.json [found/not found]

--reset

Ask user which config to reset:

1. •

   Use AskUserQuestion:

   • •"Which configuration to reset?"
   • •Options: Global, Project, Both
2. •

   Delete selected file(s)

3. •

   Confirm: "Reset complete. Using defaults."

Interactive Wizard (no arguments)

Step 1: Show current config

Display current values (as in --show).

Step 2: Select stages to configure

Use AskUserQuestion with multiSelect:

• •"Which stages do you want to configure?"
• •Options: PLAN Stage, IMPLEMENT Stage, TEST Stage, FINAL Stage

Step 3: Configure selected stages

For PLAN Stage:

Ask for each phase:

• •brainstorm: model (see Model Names section), parallel (true/false)
• •writePlan: model, parallel
• •planReview: tool (mcpcodexcodex/mcpcodex-highcodex/claude-review)

Common model options: inherit, sonnet, opus, haiku, opus-4.5, sonnet-4, sonnet-3.5

For IMPLEMENT Stage:

• •implementation: model, implementer (claude/codex-high/codex-xhigh), bugFixer (claude/codex-high/codex-xhigh), enforceLogging (true/false)
• •simplify: model, bugFixer
• •implementReview: tool, bugFixer

For TEST Stage:

• •enabled: true/false
• •instructions: (freeform text - project-specific testing guidance)
• •commands.lint: command to run linting
• •commands.test: command to run tests
• •commands.coverage: command to generate coverage
• •coverageThreshold: threshold (0-100)
• •coverageFormat: auto/lcov/cobertura/json
• •runTests: timeout (seconds)
• •testReview: tool

For FINAL Stage:

• •suggestExtensions: enabled (true/false), maxSuggestions (1-5)
• •(codexFinal tool is fixed, not configurable)

Step 4: Save location

Ask: "Where to save?"

• •Global (~/.claude/kenken-config.json)
• •Project (.claude/kenken-config.json)

Step 5: Save and confirm

1. •Create directory if needed
2. •Backup existing file (.backup)
3. •Merge new values with existing
4. •Write JSON with 2-space indent
5. •Confirm with summary of changes

Full Config Schema

{
  "version": 1,
  "blockOnSeverity": "low",
  "stages": {
    "plan": {
      "brainstorm": { "model": "inherit", "parallel": true },
      "writePlan": { "model": "inherit", "parallel": true },
      "planReview": { "tool": "mcp__codex-high__codex", "maxRetries": 3 }
    },
    "implement": {
      "implementation": {
        "model": "inherit",
        "implementer": "claude",
        "bugFixer": "codex-high",
        "enforceLogging": true
      },
      "simplify": { "model": "inherit", "bugFixer": "codex-high" },
      "implementReview": {
        "tool": "mcp__codex-high__codex",
        "bugFixer": "codex-high",
        "maxRetries": 3
      }
    },
    "test": {
      "enabled": false,
      "instructions": "",
      "commands": {
        "lint": "make lint",
        "test": "make test",
        "coverage": "make coverage"
      },
      "coverageThreshold": 80,
      "coverageFormat": "auto",
      "testPlan": { "model": "inherit" },
      "testImplementation": { "model": "inherit", "bugFixer": "codex-high" },
      "runTests": { "timeout": 300 },
      "testReview": {
        "tool": "mcp__codex-high__codex",
        "bugFixer": "codex-high",
        "maxRetries": 3
      }
    },
    "final": {
      "codexFinal": {
        "tool": "mcp__codex-xhigh__codex",
        "bugFixer": "codex-high"
      },
      "suggestExtensions": { "enabled": true, "maxSuggestions": 3 }
    }
  },
  "git": {
    "branchFormat": "{type}/{slug}",
    "defaultType": "feat",
    "mainBranch": "auto"
  },
  "logging": {
    "directory": ".agents/logs",
    "retainDays": 7,
    "extractErrors": true
  }
}

Defaults Summary

Validation Rules

Note on claude-review: This option uses the superpowers:requesting-code-review skill instead of Codex MCP. It's available as a fallback when Codex MCP is not configured, or for users who prefer Claude-native reviews. No additional dependencies required.

Model Names

The model field accepts several formats:

Short Names (latest version)

• •sonnet - Claude Sonnet (latest)
• •opus - Claude Opus (latest)
• •haiku - Claude Haiku (latest)

Versioned Names (specific version)

• •opus-4.5 - Claude Opus 4.5
• •opus-4 - Claude Opus 4
• •sonnet-4 - Claude Sonnet 4
• •sonnet-3.5 - Claude Sonnet 3.5
• •haiku-3.5 - Claude Haiku 3.5

Full Model IDs

For maximum control, use the full model identifier:

• •claude-opus-4-5-20251101
• •claude-sonnet-4-20250514
• •claude-sonnet-3-5-20241022

Special Value

• •inherit - Use the current session's model (recommended default)