Skip to content

README.md

Latest commit

 

History

History
113 lines (85 loc) · 2.86 KB

README.md

File metadata and controls

113 lines (85 loc) · 2.86 KB

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.