xonecas.io
56101
Df

dotfiles / commit 82d0126

docs: update README with complete opencode config structure

xonecas2026-01-30 82d01266cc296a52745e3b5ebd8d9966723ea66f parent f05d89b

2 files changed

opencode/README.md+46−0
@@ -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`.
opencode/agents/README.md+0−29
@@ -1,29 +0,0 @@
1-# OpenCode Agents
2-
3-Custom agents for specialized workflows.
4-
5-## Agents
6-
7-### Debug
8-**Mode:** All (primary + subagent)
9-**Purpose:** Systematic debugging using root cause analysis
10-
11-Read-only during investigation phases, can implement fixes after completing the four-phase debugging process. Enforces no fixes without root cause investigation.
12-
13-### Thinker
14-**Mode:** Primary
15-**Purpose:** Creative brainstorming and design thinking
16-
17-Read-only agent for exploring ideas, proposing alternatives, and shaping designs before implementation. Asks questions one at a time and validates designs incrementally.
18-
19-## Resources
20-
21-These agents were built using principles from:
22-
23-- [OpenCode Agents Documentation](https://opencode.ai/docs/agents/)
24-- [Systematic Debugging Skill by obra/superpowers](https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/skills/systematic-debugging/SKILL.md)
25-- [Brainstorming Skill by obra/superpowers](https://skills.sh/obra/superpowers/brainstorming)
26-
27-## Usage
28-
29-Switch between primary agents using **Tab** or invoke subagents with **@mention** (e.g., `@debug`).