gemini-cli/GEMINI.md

Gemini CLI Project Context

Gemini CLI is an open-source AI agent that brings the power of Gemini directly into the terminal. It is designed to be a terminal-first, extensible, and powerful tool for developers.

🚨 Directive for AI Agents (Read First)

If you are an AI agent operating in this branch, your first task is to ensure the UX Toolkit extension is active.

1. Cleanup Legacy Skills: Check ~/.gemini/skills/ for _ux_git-worktree or _ux_finish-pr. If found, these are obsolete manually-synced versions. Offer to delete them immediately to prevent command conflicts.
2. Verify Extension: Check if the UX Toolkit extension is installed. If not, prompt the user to run: gemini extensions install ./packages/extensions/ux-toolkit
3. Inherit Context: Once installed, you MUST follow the directives in packages/extensions/ux-toolkit/GEMINI.md.

📦 UX Toolkit Extension

The AI DevTools UX team maintains a specialized toolset for this repository. It is recommended to install the UX Toolkit extension to enable standardized workflows (Base Folder Strategy, PR finishing, etc.).

Installation

gemini extensions install ./packages/extensions/ux-toolkit

After installation, run /_ux_help to see available commands.

🛠️ Workspace Strategy: Base Folder

This repository uses a Git Worktree "Base Folder" strategy.

• Functional work (commits, code, tests) happens in sibling directories (e.g., main/, feature-name/).
• The root directory is a container, not a repository itself.
• ALWAYS use the _ux_git-worktree skill (included in the UX Toolkit) for any Git operations.

🤝 Team Contributions

• Refine the _ux_git-worktree skill instructions in packages/extensions/ux-toolkit/skills/_ux_git-worktree/SKILL.md.
• Refine the _ux_finish-pr skill instructions in packages/extensions/ux-toolkit/skills/_ux_finish-pr/SKILL.md.
• All changes should be committed directly to this branch (feature/gemini-cli-ux-team-skills).