|
| 1 | +# v0.2.0: Native-First Convergence |
| 2 | + |
| 3 | +This release turns `opencode-workflow-playbook` into a native-first OpenCode baseline. |
| 4 | + |
| 5 | +中文摘要:这个版本把仓库正式收敛为以 OpenCode 原生能力为核心的公开 baseline。 |
| 6 | + |
| 7 | +Instead of documenting a permanently layered five-tool stack, the playbook now centers on OpenCode agents, commands, plugins, optional skills, and Sentry MCP. Planning and TDD are carried by `PLAN.md` plus the `/plan` -> `/spec` -> `/implement` command chain. |
| 8 | + |
| 9 | +中文摘要:旧五工具栈不再是默认推荐方案,规划和测试纪律改由 `PLAN.md` 与命令流承载。 |
| 10 | + |
| 11 | +## Highlights |
| 12 | + |
| 13 | +- native-first architecture, setup, config overview, glossary, and workflow docs in English and Simplified Chinese |
| 14 | +- a clearer execution spine built around `/plan`, `/spec`, `/implement`, `/review`, and `/verify` |
| 15 | +- shareable templates for `opencode.json`, commands, plugins, `AGENTS.md`, and the reviewer subagent |
| 16 | +- evolution docs and decision records that explain why the stack changed |
| 17 | +- a preserved `legacy/five-tool-stack` branch for historical reference |
| 18 | + |
| 19 | +中文摘要:核心新增内容包括双语文档、命令工作流、可复用模板、演进记录,以及保留旧方案的历史分支。 |
| 20 | + |
| 21 | +## Why This Release Matters |
| 22 | + |
| 23 | +The previous public version captured useful ideas, but too much process was split across overlapping tools. That made the workflow harder to explain, slower to adapt, and more expensive in always-loaded context. `v0.2.0` keeps the discipline that mattered while moving the baseline closer to the runtime OpenCode already provides. |
| 24 | + |
| 25 | +The result is a stack that is easier to teach, easier to copy, and easier to verify. Ownership stays explicit, planning becomes a concrete artifact, tests anchor implementation, and runtime truth can still come from Sentry MCP. |
| 26 | + |
| 27 | +中文摘要:这次发布的价值不只是“少装几个组件”,而是把 ownership、规划、测试和验证重新放到更清晰、更低成本、更容易解释的位置上。 |
| 28 | + |
| 29 | +## Migration Notes |
| 30 | + |
| 31 | +1. Start with `README.md` and `docs/opencode/architecture.md` to understand the baseline model. |
| 32 | +2. Copy `config/opencode.template.json` and adapt providers, model routing, commands, plugins, and MCP settings to your local environment. |
| 33 | +3. Use `/plan` to write `PLAN.md`, `/spec` to turn acceptance criteria into test anchors, and `/implement` to execute against the plan. |
| 34 | +4. Treat `config/ROUTING_POLICY.template.md` and `config/ENV_SELF_CHECK_POLICY.template.md` as historical references, not required baseline files. |
| 35 | +5. If you want to study the earlier public stack, switch to `legacy/five-tool-stack`. |
| 36 | + |
| 37 | +中文迁移摘要:先从 README 和架构文档理解新 baseline,再复制模板、配置命令链;旧的 routing 和 self-check 模板只作为历史参考,旧五工具方案请看 `legacy/five-tool-stack`。 |
| 38 | + |
| 39 | +## Recommended Reading Path |
| 40 | + |
| 41 | +- `docs/opencode/architecture.md` |
| 42 | +- `docs/opencode/setup.md` |
| 43 | +- `docs/opencode/workflows/plan-spec-implement.md` |
| 44 | +- `docs/opencode/workflows/model-routing.md` |
| 45 | +- `docs/evolution/timeline.md` |
| 46 | +- `docs/opencode/decisions/0002-native-first-convergence.md` |
| 47 | + |
| 48 | +中文摘要:如果你要快速理解这次发布,优先读架构、安装、工作流、时间线和 0002 决策记录。 |
0 commit comments