planning

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