Compounding Engineering for Gemini CLI

This is a port of the Compounding Engineering philosophy and tools from the Every Marketplace to the Gemini CLI.

Japanese Users / 日本語のユーザーへ

詳しいセットアップ方法や使い方は、GETTING_STARTED.md (日本語) をご覧ください。

Philosophy

Each unit of engineering work should make subsequent units of work easier—not harder.

1. Plan → Understand the change needed and its impact
2. Delegate → Use AI tools to help with implementation
3. Assess → Verify changes work as expected
4. Codify → Update documentation with learnings

graph LR
    A[Plan<br/>Plan it out<br/>in detail] --> B[Delegate<br/>Do the work]
    B --> C[Assess<br/>Make sure<br/>it works]
    C --> D[Codify<br/>Record<br/>learnings]
    D --> A

    style A fill:#f9f,stroke:#333,stroke-width:2px
    style B fill:#bbf,stroke:#333,stroke-width:2px
    style C fill:#bfb,stroke:#333,stroke-width:2px
    style D fill:#ffb,stroke:#333,stroke-width:2px

Loading

Installation

To install this extension for your Gemini CLI:

1. Ensure you have the Gemini CLI installed.
2. Create the extensions directory if it doesn't exist:

   mkdir -p ~/.gemini/extensions

3. Link this repository's extension folder to your extensions directory:

   # Run this from the root of this repository
   # Note: The folder name is 'gemini-extension'
   ln -s $(pwd)/gemini-extension ~/.gemini/extensions/compounding-engineering

4. Restart your Gemini CLI (exit and restart).

Usage

1. Plan (gemini plan)

Transform feature ideas into structured plans and GitHub issues.

gemini plan "Add user profile avatars with S3 upload"

This command researches your codebase, checks best practices, and generates a comprehensive implementation plan.

2. Work (gemini work)

Execute the plan systematically.

gemini work "path/to/plan.md"

This automates the workflow of creating branches, managing todos, and implementing features based on the plan.

3. Agents (gemini agent:...)

Consult with specialized AI agents for specific tasks.

Examples:

• Architecture:

  gemini agent:architecture-strategist "Should I use a polymorphic association here?"

• Security:

  gemini agent:security-sentinel "Check this query for SQL injection risks"

• Rails Review:

  gemini agent:kieran-rails-reviewer "Review app/models/user.rb"

Available Agents

Check gemini-extension/commands/agent/ for the full list of available agents, including:

• architecture-strategist
• security-sentinel
• performance-oracle
• code-simplicity-reviewer
• kieran-rails-reviewer (and other language reviewers)
• best-practices-researcher
• ...and more.

License

MIT