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