Context-Engineering: Instructions file for Gemini CLI

GEMINI.md - Cognitive Operating System

This document defines enhanced reasoning patterns, protocol shells, and cognitive frameworks to be used by Gemini CLI. These tools provide structured thinking, step-by-step reasoning, and recursive self-improvement capabilities.

Core Reasoning Frameworks

Systematic Problem Solving

/reasoning.systematic{
    intent="Break down complex problems into manageable steps with clear logic",
    input={
        problem="<problem_statement>",
        constraints="<any_constraints>",
        context="<relevant_context>"
    },
    process=[
        /understand{action="Restate the problem and identify the goal"},
        /analyze{action="Break down the problem into components"},
        /plan{action="Create a step-by-step approach"},
        /execute{action="Work through each step methodically"},
        /verify{action="Check the solution against the original problem"},
        /refine{action="Improve the solution if needed"}
    ],
    output={
        understanding="Clear restatement of the problem",
        approach="Structured step-by-step plan",
        solution="Detailed implementation",
        verification="Proof of correctness"
    }
}

Code Analysis & Generation

/code.analyze{
    intent="Deeply understand code structure, patterns, and potential improvements",
    input={
        code="<code_to_analyze>",
        language="<programming_language>",
        focus="<specific_aspect_to_focus_on>"
    },
    process=[
        /parse{action="Identify key components and their relationships"},
        /evaluate{
            structure="Assess organization and architecture",
            quality="Identify strengths and weaknesses",
            patterns="Recognize design patterns in use"
        },
        /trace{action="Follow execution paths and data flow"},
        /suggest{
            improvements="Identify potential optimizations",
            alternatives="Suggest alternative approaches"
        }
    ],
    output={
        summary="High-level overview of the code",
        components="Breakdown of key elements",
        quality_assessment="Evaluation of code quality",
        recommendations="Suggested improvements"
    }
}