xonecas.io
56101
Df

dotfiles / commit 49047d8

docs: simplify README, remove skills and agent docs sections

xonecas2026-01-31 49047d8b47cbff634ed7f03f26c3ed1c3077f3d7 parent 7a1caa0

1 file changed

opencode/README.md+7−23
@@ -1,23 +1,21 @@
11 # OpenCode config
22
3-Personal OpenCode configuration with custom agents, slash commands, and skills.
3+Personal OpenCode configuration with custom agents and slash commands.
44
55 ## Structure
66
7-- **`AGENTS.md`** — Global agent instructions + compressed docs index
8-- **`.agent-docs/`** — Versioned agent docs referenced by `AGENTS.md`
9-- **`agents/`** — Custom agent definitions (debug, plan)
7+- **`AGENTS.md`** — Global agent instructions
8+- **`agents/`** — Custom agent definitions (debug, plan, writer)
109 - **`commands/`** — Slash commands (commit-all, format-then-lint, review)
11-- **`skills/`** — Custom skills (good-programming-principles, token-efficiency-opencode)
1210 - **`install.sh`** — Symlink installer for `~/.config/opencode`
1311
1412 ## Agents
1513
1614 ### Debug
17-**Mode:** All (primary + subagent)
15+**Mode:** Primary
1816 **Purpose:** Systematic debugging using root cause analysis
1917
20-Read-only during investigation; implements fixes only after completing the four-phase debugging process. No shortcuts permitted.
18+Enforces a four-phase debugging process and requires TodoWrite tracking. No fixes before root cause analysis.
2119
2220 ### Plan
2321 **Mode:** Primary
@@ -25,8 +23,8 @@ Read-only during investigation; implements fixes only after completing the four-
2523
2624 Read-only agent for scoping work, comparing approaches, and writing plans to `.opencode/plans` before implementation.
2725
28-### Blog Writer
29-**Mode:** All (subagent)
26+### Writer
27+**Mode:** Subagent
3028 **Purpose:** Personal, informal blog post drafts
3129
3230 Writes ~500 word markdown posts from topics or provided resources, and always includes a Sources section.
@@ -37,23 +35,9 @@ Writes ~500 word markdown posts from topics or provided resources, and always in
3735 - **`/format-then-lint`** — Run formatter followed by linter
3836 - **`/review`** — Review code changes before committing
3937
40-## Skills
41-
42-- **`good-programming-principles`** — KISS, DRY, YAGNI, SOLID principles
43-- **`token-efficiency-opencode`** — Minimize token usage in file operations
44-
45-## Agent Docs
46-
47-- **`.agent-docs/debugging/`** — Full systematic debugging framework split into focused sections
48-- **`.agent-docs/programming/`** — KISS/DRY/YAGNI/SOLID + scope control
49-- **`.agent-docs/writing/`** — Writing essentials + AI patterns to avoid
50-
5138 ## Resources
5239
5340 - [OpenCode Agents Documentation](https://opencode.ai/docs/agents/)
54-- [AGENTS.md outperforms skills in agent evals](https://vercel.com/blog/agents-md-outperforms-skills-in-our-agent-evals)
55-- [Systematic Debugging Skill by obra/superpowers](https://raw.githubusercontent.com/obra/superpowers/refs/heads/main/skills/systematic-debugging/SKILL.md)
56-- [Brainstorming Skill by obra/superpowers](https://skills.sh/obra/superpowers/brainstorming)
5741
5842 ## Usage