tool-selection-framework

Select Claude Code or Gemini CLI for development tasks using a structured decision framework.

Updated Nov 27, 2025
One-click install
npx skills add https://github.com/Rehan-Ul-Haq/physical-ai-robotics --skill tool-selection-framework-rehan-ul-haq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: tool-selection-framework
Source: https://github.com/Rehan-Ul-Haq/physical-ai-robotics/tree/main/.claude/skills/tool-selection-framework
Command: npx skills add https://github.com/Rehan-Ul-Haq/physical-ai-robotics --skill tool-selection-framework-rehan-ul-haq

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill designs a systematic decision framework to select the right AI tool (e.g., Claude Code vs Gemini CLI) based on codebase size, task type, reasoning depth, and workflow complexity.

Core Features & Use Cases

  • Codebase Size Assessment: Guidance for choosing Claude Code vs Gemini CLI based on codebase scale.
  • Task Type Evaluation: Distinguishes between exploration and focused implementation.
  • Reasoning Depth & Budget: Aligns tool choice with required depth of reasoning and token budget.
  • Multi-Phase Workflows: Plans phased work that leverages multiple tools efficiently.
  • Contextual Optimisation: Prevents wasted context by matching tool capabilities to tasks.

Quick Start

Provide project constraints (codebase size, task type, timeline); the framework outputs a recommended tool set and a phased workflow.

Frequently Asked Questions about tool-selection-framework

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I choose between Claude Code and Gemini CLI for my project?

Tool selection depends on codebase size, task complexity, and context window needs. Claude Code suits larger codebases and deep reasoning; Gemini CLI handles focused tasks with tighter constraints. The framework evaluates these factors to allocate the optimal tool for each phase.

When should I use multiple AI tools in a single workflow?

Multi-phase workflows leverage different tools efficiently by matching each phase to tool strengths. Use exploration phases with one tool, implementation phases with another, based on context limits and reasoning depth required for each stage.

How does codebase size affect which AI tool I should pick?

Larger codebases approaching context limits benefit from Claude Code's extended window and reasoning capacity. Smaller, focused tasks fit Gemini CLI's constraints. The framework assesses scale to prevent wasted context and optimize cost versus performance trade-offs.

What's the difference between exploration tasks and implementation tasks when selecting a tool?

Exploration tasks require broad reasoning and pattern discovery; implementation tasks need focused execution. Tool selection distinguishes between these types—exploration often benefits from deeper reasoning budgets, while implementation prioritizes efficiency and context precision.

Can I use this framework with projects that have unclear tool requirements?

Yes, the framework specifically targets projects with unclear requirements. It provides a structured decision process that evaluates context window size, task complexity, and reasoning depth to identify the best tool allocation before committing resources.

How do I avoid wasting context window when working with large codebases?

Contextual optimization matches tool capabilities to task scope, preventing unnecessary context consumption. The framework guides phase planning so each tool's window is used efficiently for its assigned work, reducing overhead and improving performance.