# 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

```bash
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`).