Menu
Use when navigating the GAC codebase, finding where code lives, or understanding the project structure. 106 source files, 151 test files.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
| name | project-nav |
| description | Use when navigating the GAC codebase, finding where code lives, or understanding the project structure. 106 source files, 151 test files. |
| tags | ["navigation","project-structure","codebase"] |
gac/
src/gac/
cli.py # Click CLI entrypoint
main.py # Commit workflow orchestration
ai.py / ai_utils.py # AI provider integration + retry logic
prompt.py / prompt_builder.py # Dual-prompt system
git.py # Git operations
security.py # Secret detection
config.py # Config loading (GACConfig TypedDict)
errors.py # Exception hierarchy (GACError base)
preprocess.py / postprocess.py # Diff preprocessing / message cleanup
diff_scoring.py # Diff relevance scoring
providers/ # 35 provider implementations
__init__.py # PROVIDER_REGISTRY
base.py # BaseConfiguredProvider, OpenAICompatibleProvider,
# AnthropicCompatibleProvider, GenericHTTPProvider
error_handler.py # @handle_provider_errors decorator
protocol.py # ProviderProtocol
registry.py # register_provider()
openai.py, anthropic.py, gemini.py, ...
oauth/ # OAuth authentication
base.py # Base OAuth flow (19KB)
chatgpt.py # ChatGPT OAuth
claude_code.py # Claude Code OAuth
copilot.py # GitHub Copilot OAuth
token_store.py # Token storage (~/.gac/oauth/)
stats/ # Statistics tracking
store.py # Stats file read/write
recorder.py # Usage recording
commands.py # Stats CLI commands
charts.py # Chart generation
summary.py # Summary formatting
migration.py # Legacy migration
mcp/ # MCP server
server.py # MCP server implementation (22KB)
server_utils.py # Server utilities
models.py # MCP data models
constants/ # Constants package
defaults.py # EnvDefaults, etc.
commit.py # Commit format constants
file_patterns.py # Secret detection patterns
languages.py # Language code mappings
grouped_commit_*.py # Grouped commit workflow (5 files)
*_cli.py # Subcommand CLIs (config, init, diff, model, etc.)
workflow_context.py # WorkflowContext dataclass
tests/ # 151 test files mirroring src/
docs/ # Documentation (16 languages)
scripts/ # Automation helpers
This is not exhaustive. Use find src/gac -name "*.py" to explore.
Use system tools directly (NOT uv run — these aren't Python packages):
rg "def generate" src/gac/ # ripgrep for definitions
rg "class.*Provider" src/gac/providers/ # Find provider classes
rg "os.getenv" src/gac/ # Find env var usage
ls src/gac/providers/*.py | grep -v __init__ # List providers
Tests mirror source but may be split across multiple files:
| Source | Tests |
|---|---|
src/gac/cli.py | tests/test_cli.py |
src/gac/git.py | tests/test_git.py, tests/test_git_coverage.py, tests/test_git_integration.py |
src/gac/stats/store.py | tests/test_stats_core.py, tests/test_stats_tracking.py, tests/test_stats_malformed.py, ... (15+ files) |
src/gac/providers/openai.py | tests/providers/test_openai.py |
src/gac/mcp/server.py | tests/test_mcp_server.py, tests/test_mcp_utils.py |
| Starting from | Read first |
|---|---|
| CLI flags | src/gac/cli.py — Click @click.option decorators |
| Commit workflow | src/gac/main.py — generate_commit_message() |
| Provider internals | src/gac/providers/base.py:188 — BaseConfiguredProvider.generate() |
| Config values | src/gac/config.py — GACConfig TypedDict + load_config() |
| Error types | src/gac/errors.py — GACError base, AIError, SecurityError |
from gac.providers import PROVIDER_REGISTRYfrom gac.config import load_configgenerate(), returns tuple (content, in_tok, out_tok, in_cost, out_cost)~/.gac* files during developmentUse when adding a new AI provider to the GAC project (e.g. a new OpenAI-compatible inference service, Anthropic-compatible endpoint, or OAuth-based provider). Lists every file that must be created or edited and the exact registration steps required for the provider to appear in the registry, the `uvx gac init` flow, the README, and the test suite.
Use when formatting, linting, type checking, or reviewing code quality in the GAC project. Covers ruff, mypy, Makefile targets, and coding standards.
Use when debugging test failures, runtime errors, or unexpected behavior in the GAC project. Covers pytest debugging, logging, and common patterns.
Use when running, writing, or debugging tests in the GAC project. Covers test structure, pytest commands, provider testing patterns, and integration vs unit test practices.