agcoco
agcoco = Agent-Coding-Config — pronounced "AG-co-co".
AI 에이전트 코딩을 위한 개인 dotfiles 레포 (Claude Code, Codex 등 멀티툴 지원).
Personal dotfiles repo for AI agent-assisted coding. Manages custom slash commands, sub-agents, skills, and per-tool symlinks for any CLI that follows the AGENTS.md convention (Claude Code, Codex, and easily extensible to Gemini / Cursor / Aider / Continue via tools/<name>.sh).
Architecture
Quick Start
git clone <repo-url> ~/agcoco
cd ~/agcoco
./install.sh
What's Included
Commands (20개)
| Category | Commands |
|---|
| Plan Lifecycle | /create-plan, /implement-plan, /iterate-plan, /validate-plan |
| Research & Debug | /research, /debug |
| Session | /handoff, /resume-handoff |
| Test | /workcheck, /affected-endpoints, /smoke-test, /branch-diff, /test-affected |
| Commit & PR | /workfinish, /commit-mailplug, /commit-suggest, /pr-description |
| Claude Usage | /claude-usage-collect, /claude-usage-analyze, /claude-usage-report |
Agents (12개)
Commands trigger these automatically — you don't call them directly.
| Agent | Role |
|---|
codebase-analyzer | Code implementation analysis |
codebase-locator | File/component location (Super Grep) |
codebase-pattern-finder | Find similar patterns + code examples |
docs-locator | Search past plans/research/handoffs |
docs-analyzer | Extract insights from past documents |
web-search-researcher | Web search for up-to-date info |
architecture-review | Architecture risk analysis |
endpoint-analysis | API endpoint behavior analysis |
pr-review-assistant | PR risk-focused review |
consistency-check | Data snapshot comparison |
document-summarizer | Document summarization |
pr-description-generator | PR description generation |
Skills (22개)
Ported from mattpocock/skills (MIT). Skills auto-fire when your phrasing matches their description field — no slash command needed.
| Category | Skill | Triggers when you say… |
|---|
| engineering | setup-matt-pocock-skills | "set up the engineering skills for this repo" — run first in any new project |
| grill-with-docs | "stress-test this plan against our domain model" |
| to-prd | "turn this conversation into a PRD" |
| to-issues | "break this plan into issues" |
| triage | "triage these incoming issues" |
| tdd | "let's TDD this", "red-green-refactor" |
| diagnose | "diagnose this bug", "this is broken/throwing/failing" |
| improve-codebase-architecture | "find refactoring opportunities", "improve architecture" |
| prototype | "let me prototype this", "try a few UI variations" |
| zoom-out | "zoom out", "give me the bigger picture" |
| productivity | grill-me | "grill me on this plan", "interview me" |
| caveman | (terse output mode) |
| write-a-skill | "create a new skill" |
| misc | git-guardrails-claude-code | "block dangerous git commands", "add git safety hooks" |
| setup-pre-commit | "set up pre-commit hooks", "add Husky + lint-staged" |
| migrate-to-shoehorn | "replace as with shoehorn in tests" |
| scaffold-exercises | "scaffold an exercise structure" |
| personal | edit-article | "edit/revise this article" |
| obsidian-vault | "find/create a note in Obsidian" |
| in-progress | writing-fragments | "ideate", "fragments", "raw material" |
| writing-shape | "shape these notes into an article" |
| writing-beats | "assemble this as a narrative" |
Commands vs Agents vs Skills:
- Commands (
/foo) — you invoke explicitly. Full workflows.
- Agents — Claude spawns them automatically inside commands. Specialized single tasks.
- Skills — auto-fire from your phrasing. Trigger via
description matching.
Multi-Tool Support (tools/ registry)
Tool-agnostic — install.sh runs a generic loop over tools/*.sh, auto-detects whatever CLIs are installed, and creates the declared symlinks. AGENTS.md is the canonical agent context (openclaw pattern); each tool's expected memory filename is a symlink to it.
Shipped (verified):
| File | Tool | Detection | Symlinks created |
|---|
tools/claude.sh | Claude Code | command -v claude | ~/.claude/CLAUDE.md → AGENTS.md, commands, agents, skills, settings.json |
tools/codex.sh | Codex CLI | command -v codex | ~/.codex/AGENTS.md → AGENTS.md, skills (same SKILL.md format) |
Add any other tool — Gemini, Cursor agent, Aider, Continue, etc:
cp tools/_template.sh tools/<your-tool>.sh
$EDITOR tools/<your-tool>.sh # fill in 4 vars: TOOL_NAME, TOOL_CMD, TOOL_DIR, TOOL_SYMLINKS
./install.sh # auto-detected from the next run on
