hanseo-opencode-workflows

Personal OpenCode workflows, agents, and command prompts for faster planning, implementation, testing, and review.

This is a personal setup shared for reuse. It is opinionated, practical, and tuned for day-to-day software delivery.

Why this repo exists

• Keep my OpenCode setup versioned and synced across devices.
• Capture repeatable workflows for solo and team work.
• Share a real-world configuration others can fork and adapt.

Repository layout

• agent/: primary and subagent definitions
• commands/: slash command templates (/plan, /prd, /test, /prcheck, ...)
• docs/: workflow and mental-model documentation
• skills/: versioned skill source-of-truth (synced to ~/.agents/skills)
• scripts/: utility scripts (including skills sync)
• AGENTS.md: global operating and safety rules

Canonical agent map

Primary modes:

• build (default)
• plan (built-in mode; no local file)
• pre-commit-gate (agent/pre-commit-gate.md)

Subagents in agent/:

• architect
• product-reviewer
• planner
• researcher
• tester
• debugger
• security-auditor
• docs-maintainer
• refactor-architect
• pr-reviewer
• gh-operator

Quick start

Linux/macOS:

git clone https://github.com/Hanseooo/hanseo-opencode-workflows.git ~/.config/opencode
ls ~/.config/opencode/agent
ls ~/.config/opencode/commands

Windows PowerShell:

git clone https://github.com/Hanseooo/hanseo-opencode-workflows.git $HOME/.config/opencode
Get-ChildItem $HOME/.config/opencode/agent
Get-ChildItem $HOME/.config/opencode/commands

Windows CMD:

git clone https://github.com/Hanseooo/hanseo-opencode-workflows.git %USERPROFILE%\.config\opencode
dir %USERPROFILE%\.config\opencode\agent
dir %USERPROFILE%\.config\opencode\commands

Skills sync

Sync repo-managed skills to runtime location (~/.agents/skills).

Linux/macOS/Git Bash:

bash scripts/skills-sync.sh --dry-run
bash scripts/skills-sync.sh --init-target

Windows PowerShell:

powershell -ExecutionPolicy Bypass -File scripts/skills-sync.ps1 -DryRun
powershell -ExecutionPolicy Bypass -File scripts/skills-sync.ps1 -InitTarget

Documentation index

• docs/getting-started.md
• docs/mental-models.md
• docs/workflows.md
• docs/recipes.md
• docs/faq.md
• docs/agent-invocation-guide.md
• docs/prompting-guide.md
• docs/agents.md
• docs/commands.md
• docs/skills.md
• docs/project-agents-template.md
• docs/team-playbook.md
• docs/security-and-secrets.md
• docs/troubleshooting.md
• CONTRIBUTING.md
• CHANGELOG.md

Open-source safety notes

• Keep secrets out of the repo (.env, API keys, private certs, tokens).
• Keep naming aligned with actual files (agent/ is singular).
• Prefer focused PRs that change one workflow concern at a time.

License

This project is licensed under MIT. See LICENSE.