AI Agent Workflow (Workflow & Productivity)
When to use this skill
- Optimize everyday AI agent work
- Integrate Git/GitHub workflows
- Use MCP servers
- Manage and recover sessions
- Apply productivity techniques
1. Key commands by agent
Claude Code commands
| Command |
Function |
When to use |
/init |
Auto-generate a CLAUDE.md draft |
Start a new project |
/usage |
Show token usage/reset time |
Start of every session |
/clear |
Clear conversation history |
When context is polluted; start a new task |
/context |
Context window X-Ray |
When performance degrades |
/clone |
Clone the entire conversation |
A/B experiments; backups |
/mcp |
Manage MCP servers |
Enable/disable MCP |
!cmd |
Run immediately without Claude processing |
Quick status checks |
Gemini CLI commands
| Command |
Function |
gemini |
Start a conversation |
@file |
Add file context |
-m model |
Select model |
Codex CLI commands
| Command |
Function |
codex |
Start a conversation |
codex run |
Run a command |
2. Keyboard shortcuts (Claude Code)
Essential shortcuts
| Shortcut |
Function |
Importance |
Esc Esc |
Cancel the last task immediately |
Highest |
Ctrl+R |
Search prompt history |
High |
Shift+Tab x2 |
Toggle plan mode |
High |
Tab / Enter |
Accept prompt suggestion |
Medium |
Ctrl+B |
Send to background |
Medium |
Ctrl+G |
Edit in external editor |
Low |
Editor editing shortcuts
| Shortcut |
Function |
Ctrl+A |
Move to start of line |
Ctrl+E |
Move to end of line |
Ctrl+W |
Delete previous word |
Ctrl+U |
Delete to start of line |
Ctrl+K |
Delete to end of line |
3. Session management
Claude Code sessions
# Continue the last conversation
claude --continue
# Resume a specific session
claude --resume <session-name>
# Name the session during the conversation
/rename stripe-integration
Recommended aliases
# ~/.zshrc or ~/.bashrc
alias c='claude'
alias cc='claude --continue'
alias cr='claude --resume'
alias g='gemini'
alias cx='codex'
4. Git workflow
Auto-generate commit messages
"Analyze the changes, write an appropriate commit message, then commit"
Auto-generate draft PR
"Create a draft PR from the current branch's changes.
Make the title summarize the changes, and list the key changes in the body."
Use Git worktrees
# Work on multiple branches simultaneously
git worktree add ../myapp-feature-auth feature/auth
git worktree add ../myapp-hotfix hotfix/critical-bug
# Independent AI sessions per worktree
Tab 1: ~/myapp-feature-auth → new feature development
Tab 2: ~/myapp-hotfix → urgent bug fix
Tab 3: ~/myapp (main) → keep main branch
PR review workflow
1. "Run gh pr checkout 123 and summarize this PR's changes"
2. "Analyze changes in src/auth/middleware.ts. Check for security issues or performance problems"
3. "Is there a way to make this logic more efficient?"
4. "Apply the improvements you suggested and run tests"
5. Using MCP servers (Multi-Agent)
Key MCP servers
| MCP server |
Function |
Use case |
| Playwright |
Control web browser |
E2E tests |
| Supabase |
Database queries |
Direct DB access |
| Firecrawl |
Web crawling |
Data collection |
| Gemini-CLI |
Large-scale analysis |
1M+ token analysis |
| Codex-CLI |
Run commands |
Build, deploy |
MCP usage examples
# Gemini: large-scale analysis
> ask-gemini "@src/ Analyze the structure of the entire codebase"
# Codex: run commands
> shell "docker-compose up -d"
> shell "npm test && npm run build"
MCP optimization
# Disable unused MCP servers
/mcp
# Recommended numbers
# - MCP servers: fewer than 10
# - Active tools: fewer than 80
6. Multi-Agent workflow patterns
Orchestration pattern
[Claude] Plan → [Gemini] Analysis/research → [Claude] Write code → [Codex] Run/test → [Claude] Synthesize results
Practical example: API design + implementation + testing
1. [Claude] Design API spec using the skill
2. [Gemini] ask-gemini "@src/ Analyze existing API patterns" - large-scale codebase analysis
3. [Claude] Implement code based on the analysis
4. [Codex] shell "npm test && npm run build" - test and build
5. [Claude] Create final report
TDD workflow
"Work using TDD. First write a failing test,
then write code that makes the test pass."
# The AI:
# 1. Write a failing test
# 2. git commit -m "Add failing test for user auth"
# 3. Write minimal code to pass the test
# 4. Run tests → confirm they pass
# 5. git commit -m "Implement user auth to pass test"
7. Container workflow
Docker container setup
FROM ubuntu:22.04
RUN apt-get update && apt-get install -y \
curl git tmux vim nodejs npm python3 python3-pip
RUN curl -fsSL https://claude.ai/install.sh | sh
WORKDIR /workspace
CMD ["/bin/bash"]
Safe experimentation environment
# Build and run the container
docker build -t ai-sandbox .
docker run -it --rm \
-v $(pwd):/workspace \
-e ANTHROPIC_API_KEY=$ANTHROPIC_API_KEY \
ai-sandbox
# Do experimental work inside the container
8. Troubleshooting
When context is overloaded
/context # Check usage
/clear # Reset context
# Or create HANDOFF.md and start a new session
Cancel a task
Esc Esc # Cancel the last task immediately
When performance degrades
# Check MCP/tool counts
/mcp
# Disable unnecessary MCP servers
# Reset context
Quick Reference Card
=== Essential commands ===
/clear reset context
/context check usage
/usage check tokens
/init generate project description file
!command run immediately
=== Shortcuts ===
Esc Esc cancel task
Ctrl+R search history
Shift+Tab×2 plan mode
Ctrl+B background
=== CLI flags ===
--continue continue conversation
--resume resume session
-p "prompt" headless mode
=== Multi-Agent ===
Claude plan/code generation
Gemini large-scale analysis
Codex run commands
=== Troubleshooting ===
Context overloaded → /clear
Cancel task → Esc Esc
Performance degradation → check /context
aiskillstore