iara-pwa/docs/plans/README.md
Francisco Solla e2eccc5741
Some checks failed
Agent PR Ready + auto-merge / ready-automerge (pull_request) Failing after 4s
CI / checks (pull_request) Failing after 4s
CI / deploy (pull_request) Has been skipped
fluxo de agente tipo teqo: scripts worktree/issue/agent, skills, CI com e2e só no CI, labels e branch protection
- scripts/ portados do teqo e adaptados (sem DB — SPA): worktree (next/plan/new/kill,
  claim + branch <code>-<slug> + bun install), issue, agent:{claim,register,ready,
  file-miss,status}, pr (cria PR + auto-merge sem gh), transitions de CI
- config por projeto em .forgejo/worktree.env (FORGEJO_REPOSITORY, WORKTREES_ROOT)
  + roteador global de terminal em ~/.config/shell/worktree.sh (escopo por git rev-parse)
- .opencode/commands e .agents/skills (plan-issue, work-issue, capture-review-debts,
  worktree-next-issue, code-simplification) + AGENTS.md com o workflow
- CI Forgejo Actions unificado: checks (lint+build+e2e) em PR e main; deploy
  gated; issue-done / plan-issue-ready / agent-pr-automerge workflows
- Playwright: config + 2 specs smoke (settings→chat, ws reconnect) — e2e só no CI
- package.json: aliases worktree/issue/agent:*/pr + gate + test:e2e
2026-08-17 21:16:12 -03:00

676 B

Planos de intenção / implementação

Convenção herdada do teqo (paralelismo com fila de claim em Issues Forgejo):

  • docs/plans/<slug>.md — plano de intenção (produto): o quê / para quem / por quê / outcome, direção suave no codebase. Criado pela skill plan-issue; a Issue nasce blocked até o plano estar em main.
  • docs/plans/<slug>-impl.md — plano de implementação (engenharia): abordagem + rejeitadas + fases. Criado pela skill work-issue no worktree, com gate humano antes da execução.

Planos de Issues in-progress/done/in-prod são imutáveis — refino vira plano + Issue sucessor (depends no pai).