@@ -0,0 +1,46 @@
1+# OpenCode config
2+
3+Personal OpenCode configuration with custom agents, slash commands, and skills.
4+
5+## Structure
6+
7+- **`AGENTS.md`** — Global agent instructions (communication style, debugging principles, efficiency rules)
8+- **`agents/`** — Custom agent definitions (debug, thinker)
9+- **`commands/`** — Slash commands (commit-all, format-then-lint, review)
10+- **`skills/`** — Custom skills (good-programming-principles, token-efficiency-opencode)
11+- **`install.sh`** — Symlink installer for `~/.config/opencode`
12+
13+## Agents
14+
15+### Debug
16+**Mode:** All (primary + subagent)
17+**Purpose:** Systematic debugging using root cause analysis
18+
19+Read-only during investigation; implements fixes only after completing the four-phase debugging process. No shortcuts permitted.
20+
21+### Thinker
22+**Mode:** Primary
23+**Purpose:** Creative brainstorming and design thinking
24+
25+Read-only agent for exploring ideas, proposing alternatives, and shaping designs before implementation. Asks questions one at a time.
26+
27+## Commands
28+
29+- **`/commit-all`** — Stage all changes and create a commit
30+- **`/format-then-lint`** — Run formatter followed by linter
31+- **`/review`** — Review code changes before committing
32+
33+## Skills
34+
35+- **`good-programming-principles`** — KISS, DRY, YAGNI, SOLID principles
36+- **`token-efficiency-opencode`** — Minimize token usage in file operations
37+
38+## Resources
39+
40+- [OpenCode Agents Documentation](https://opencode.ai/docs/agents/)
41+- [Systematic Debugging Skill by obra/superpowers](https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/skills/systematic-debugging/SKILL.md)
42+- [Brainstorming Skill by obra/superpowers](https://skills.sh/obra/superpowers/brainstorming)
43+
44+## Usage
45+
46+Switch primary agents with **Tab** or invoke subagents with **@mention** (e.g., `@debug`). Use slash commands with `/command-name`.