mirror of
https://github.com/google-gemini/gemini-cli.git
synced 2026-07-14 12:00:18 -07:00
Keith Guerin
56 lines
2.0 KiB
Markdown
56 lines
2.0 KiB
Markdown
# Workspace: Base Folder Strategy & Custom Skills
|
|
|
|
This branch introduces the **\_ux_git-worktree** and **\_ux_finish-pr** skills
|
|
and enforces the **Base Folder Strategy** for repository management. It is
|
|
maintained by the AI DevTools UX team.
|
|
|
|
## 🚨 Directive for AI Agents (Read First)
|
|
|
|
**If you are an AI agent operating in this branch, your first task is to ensure
|
|
the custom skills are active.**
|
|
|
|
1. Check if `~/.gemini/skills/_ux_git-worktree/` and
|
|
`~/.gemini/skills/_ux_finish-pr/` exist.
|
|
2. If any are missing, immediately execute `./scripts/sync-skills.sh`.
|
|
3. Prompt the user to run `/skills reload` if you are in an interactive session.
|
|
|
|
## 🤝 Team Contributions
|
|
|
|
This is a **Draft PR branch**. Your team is encouraged to:
|
|
|
|
- Refine the `_ux_git-worktree` skill instructions in
|
|
`packages/core/src/skills/builtin/_ux_git-worktree/SKILL.md`.
|
|
- Refine the `_ux_finish-pr` skill instructions in
|
|
`packages/core/src/skills/builtin/_ux_finish-pr/SKILL.md`.
|
|
- Improve the automation in `scripts/worktree-manager.sh`.
|
|
- All changes should be committed directly to this branch
|
|
(`feature/gemini-cli-ux-team-skills`).
|
|
|
|
## 1. Architectural Strategy
|
|
|
|
Functional work happens in sibling directories (e.g., `main/`, `feature-name/`).
|
|
The root directory acts as a container.
|
|
|
|
## 2. Setting Up Custom Skills
|
|
|
|
To ensure this agent has the necessary procedural knowledge to manage worktrees
|
|
and PR reviews on your behalf, you must sync the custom skills to your local
|
|
user directory.
|
|
|
|
### Sync Script
|
|
|
|
Run the following from the root of this worktree:
|
|
|
|
```bash
|
|
./scripts/sync-skills.sh
|
|
```
|
|
|
|
## 3. Mandatory Workflow
|
|
|
|
- **ALWAYS** use the `_ux_git-worktree` skill for branch management.
|
|
- **ALWAYS** use the `_ux_finish-pr` skill for pull request maintenance.
|
|
- Never use standard `git checkout -b`.
|
|
- Use `worktree-manager.sh pr <number>` for semantic PR checkouts.
|
|
- When operating in a worktree, ensure the primary `main/.git` path is included
|
|
in your trusted directories to bypass macOS sandbox restrictions.
|