Option A - Git submodule
git submodule add <repo-url> AI-toolkit- Keeps toolkit updates separate from app code
- Use when multiple projects share the toolkit
Copy the toolkit
Option B - Direct copy
- Copy the entire
AI-toolkit/folder into project root - Commit it if you want the assets tracked in source control
- Simplest approach for personal or single team use
Directory map
| Folder | Purpose | Copy to |
|---|---|---|
agents/ | All persona definitions plus INDEX.md | .claude/agents/ |
prompts/ | Prompt templates for planning, reviews, docs | .claude/prompts/ (or reference directly) |
session-commands/ | Slash commands for logging work | .claude/commands/ |
| Context bundle | Briefing templates, workflow notes, troubleshooting tips | Keep alongside your project for easy editing |
guide/ | This web manual | Optional static hosting |
Context templates
Claude briefing
Load this template before every session. Capture current goals, guardrails, and active agents so /init starts from a trusted baseline.
Gemini briefing
Keep Gemini aligned with the same objectives and constraints you share with Claude. Update it whenever the roadmap or technology focus changes.
Session summary scaffold
Use at the end of each work block to log outcomes, blockers, tests, and follow-up actions. Perfect input for the session commands and future restarts.
Installation checklist
- Create directories:
mkdir -p .claude/commands .claude/agents .claude/prompts .claude/sessions - Copy command files into
.claude/commands/ - Create empty pointer
.claude/sessions/.current-session - Copy agent files you need into
.claude/agents/ - Copy prompt templates into
.claude/prompts/ - Tailor the included Claude and Gemini briefing templates, then keep them beside your codebase for quick
/initrefreshes - Skim the workflow reminders and troubleshooting notes with your team so everyone follows the same loop
Initialize every tool
| Tool | Command | Expected result |
|---|---|---|
| Claude Code | /init | Loads customized claude.md and lists available agents |
| Gemini CLI | gemini --init or load config | Confirms access to agent files and prompts |
| Codex CLI | codex init (if available) | Sets working directory to project root |
| OpenCode | Launch and open project folder | Ensures prompts show under favorites |
| Cursor | Open workspace and run /init snippet | Verifies instructions in the Cursor assistant sidebar |
After initialization, immediately run /project:session-start in Claude to confirm the session commands are wired correctly.