Council MCP Procedures

Invoke with /tzurot-council-mcp when you need external AI consultation.

When to Consult Council

Always Use For

• Major Refactorings (>500 lines)

• Before Completing Major PRs

• When Thinking "This seems unnecessary" - STOP! Consult before removing code.

• Structured Debugging

Don't Use For

• Questions answered by existing docs/skills

• Obvious code issues (typos, syntax errors)

• Small style preferences

Debugging Procedure

mcp__council__debug({ error_message: 'Memory leak in BullMQ workers', code_context: 'Workers OOM after 2 hours', previous_attempts: ['Checked event listeners', 'Reviewed Redis connections'], });

Code Review Procedure

mcp__council__code_review({ code: changes, focus: 'behavior preservation, edge cases', language: 'typescript', });

Refactoring Plan Procedure

mcp__council__refactor({ code: myCode, goal: 'reduce_complexity', // extract_method, simplify_logic, improve_naming, etc. language: 'typescript', });

Brainstorming Procedure

mcp__council__brainstorm({ topic: 'Risks in refactoring PersonalityService', constraints: 'Must maintain exact functionality', });

Model Selection

Task Type Recommended Models

Coding/Review Claude Sonnet 4, Claude 3.5 Sonnet

Reasoning/Math DeepSeek R1, Gemini 3 Pro

Vision/Images Gemini 2.5 Flash, Gemini 2.5 Pro

Long Documents Gemini (1M tokens)

// Get recommendation mcp__council__recommend_model({ task: 'code_review' });

// Specify per-call mcp__council__code_review({ code: myCode, model: 'anthropic/claude-3.5-sonnet', });

Multi-Turn Conversations

// Start session const { session_id } = await mcp__council__start_conversation({ model: 'deepseek/deepseek-r1', system_prompt: 'You are a TypeScript architecture expert', initial_message: 'Review this service design...', });

// Continue await mcp__council__continue_conversation({ session_id, message: 'What about the error handling?', });

// End and summarize await mcp__council__end_conversation({ session_id, summarize: true, });

When Council and Claude Disagree

Resolution hierarchy:

• Project guidelines (CLAUDE.md, rules)

• Existing codebase patterns

• Technical correctness

• User preference

Available Tools

Tool Purpose

mcp__council__ask

General questions

mcp__council__brainstorm

Brainstorm ideas

mcp__council__code_review

Code review

mcp__council__debug

Structured debugging

mcp__council__refactor

Refactoring plans

mcp__council__test_cases

Test case suggestions

mcp__council__explain

Explain code/concepts

mcp__council__recommend_model

Model recommendations