feat(tooling): dev-orchestrator — OpenSpec + OpenCode dev→QA loop #5

2026-08-04T18:24:59-03:00

jpporta commented

2026-08-04 18:24:59 -03:00

Dev Orchestrator

Script + workflow guide para orquestração de desenvolvimento com IA usando OpenCode + OpenSpec + git worktrees.

Arquivos

tooling/dev-orchestrator — script principal (executável)
tooling/WORKFLOW.md — guia completo de uso e arquitetura

Comandos

Comando	Função
`dev-orchestrator init`	Configura repo (1x por projeto)
`dev-orchestrator spec <feature>`	Cria spec OpenSpec + worktree isolado + preenche via IA
`dev-orchestrator build <feature>`	Loop dev→QA automático, merge no main se QA passar
`dev-orchestrator status`	Visão kanban dos features ativos
`dev-orchestrator clean <feature>`	Remove worktree + branch

Fluxo

init → spec → [review specs] → build → [dev→QA loop até 3 tentativas] → merge + archive

Dependências

Zero binários pesados. Apenas:

git (já incluso)
opencode CLI (npm install -g opencode-ai)
openspec CLI (npm install -g @fission-ai/openspec)

Pesquisa e implementação baseadas na análise de Swarm Tools, Gas Town, git-stint e Vibe Kanban. Caminho escolhido: leve, scriptável, OpenCode-native.

## Dev Orchestrator Script + workflow guide para orquestração de desenvolvimento com IA usando **OpenCode + OpenSpec + git worktrees**. ### Arquivos - `tooling/dev-orchestrator` — script principal (executável) - `tooling/WORKFLOW.md` — guia completo de uso e arquitetura ### Comandos | Comando | Função | |---|---| | `dev-orchestrator init` | Configura repo (1x por projeto) | | `dev-orchestrator spec <feature>` | Cria spec OpenSpec + worktree isolado + preenche via IA | | `dev-orchestrator build <feature>` | Loop dev→QA automático, merge no main se QA passar | | `dev-orchestrator status` | Visão kanban dos features ativos | | `dev-orchestrator clean <feature>` | Remove worktree + branch | ### Fluxo ``` init → spec → [review specs] → build → [dev→QA loop até 3 tentativas] → merge + archive ``` ### Dependências Zero binários pesados. Apenas: - `git` (já incluso) - `opencode` CLI (`npm install -g opencode-ai`) - `openspec` CLI (`npm install -g @fission-ai/openspec`) --- *Pesquisa e implementação baseadas na análise de Swarm Tools, Gas Town, git-stint e Vibe Kanban. Caminho escolhido: leve, scriptável, OpenCode-native.*

jpporta added 1 commit 2026-08-04 18:25:00 -03:00

feat(tooling): add dev-orchestrator script + workflow guide 6d861958ce

- dev-orchestrator: OpenSpec + OpenCode dev→QA loop with git worktrees
- WORKFLOW.md: complete usage guide and architecture documentation

Commands: init, spec, build, status, clean
Zero heavy dependencies — only git, opencode, openspec

jpporta added 1 commit 2026-08-04 18:26:10 -03:00

docs: expand WORKFLOW.md with tool interaction guide c53a7f278b

- Added per-tool usage: when to use OpenCode/OpenSpec directly vs orchestrator
- Direct interaction patterns for manual work
- Clear gate: you review specs before build — critical step
- When to step out of the orchestrator workflow
- Smoother flow diagram

jpporta added 1 commit 2026-08-04 18:41:41 -03:00

feat(dev-orchestrator): add NixOS home-manager module 80556753e3

- New module: modules/home-manager/dev-orchestrator/
- Wraps script via writeShellApplication, git as runtime dep
- opencode + openspec already in PATH via existing modules
- Enabled in jpporta-nixos home.nix

After rebuild: dev-orchestrator available in PATH

jpporta added 1 commit 2026-08-05 10:43:39 -03:00

dev-orchestrator: decouple spec scaffold from fill, delegate exploration to OpenSpec native /opsx commands 32bc53bb68

- cmd_spec now only scaffolds (OpenSpec change + worktree + deps), no auto-fill
- Added cmd_fill as fallback for headless spec filling
- Output guides user to /opsx:explore and /opsx:continue inside OpenCode
- cmd_build (dev→QA loop) unchanged — core value proposition

jpporta added 1 commit 2026-08-05 10:46:54 -03:00

fix: shellcheck warnings for Nix writeShellApplication 810047a074

- Remove unused SCRIPT_DIR (SC2034)
- Split local var= declaration from assignment (SC2155)
- Replace &&/|| with if/else in cmd_clean (SC2015)
- Add shellcheck disable for .venv source (SC1091)

This pull request has changes conflicting with the target branch.

tooling/dev-orchestrator

View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.

git fetch -u origin feat/dev-orchestrator:feat/dev-orchestrator

git checkout feat/dev-orchestrator

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: jpporta/ndots#5