mirror of
https://github.com/google-gemini/gemini-cli.git
synced 2026-07-18 22:10:52 -07:00
Keith Guerin
53 lines
2.0 KiB
Markdown
53 lines
2.0 KiB
Markdown
# 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`).
|