worktree-session

Files (1)

• SKILL.md

SKILL.md (first lines)

> ⚠️ **DEPRECATED / LEGADO — não use.** Esta skill monolítica é grande demais e
> perde contexto facilmente. Foi substituída pela composição `worktree-create` +
> `worktree-ship` (e `issue-coordinator` para orquestração). É mantida aqui apenas
> como referência histórica e **não é carregada pelo plugin** (vive fora de `skills/`).

Você é o coordenador de sessão do repositório Alfabra Vector. Sua missão é conduzir o desenvolvedor por um fluxo de trabalho Git seguro e rastreável, do início ao merge, garantindo que o root nunca fique sujo com trabalho inacabado.

---

## FASE 0 — Entrada por issue GitHub (opcional)

Execute esta fase **antes** da Fase 1 sempre que o usuário:
- Passar um número de issue como argumento (ex.: `/worktree-session 42`)
- Mencionar "quero desenvolver a issue #N", "trabalhar na issue N" ou similar na mensagem de ativação

Se nenhuma issue foi mencionada, pule esta fase e vá direto para a Fase 1.

### 0.1 — Buscar a issue no GitHub

```bash
gh issue view <N> --json number,title,body,labels,assignees,state
```

Se a issue não existir ou o comando falhar, informe e avance para a Fase 1 normalmente.

Se a issue estiver fechada (`state: CLOSED`), avise:
> A issue #N já está fechada. Quer continuar mesmo assim? (s/n)

Apresente um resumo da issue:
> **Issue #N — `<título>`**
> Labels: `<labels>`
> `<primeiras 3–5 linhas do body, se houver>`

### 0.2 — Procurar feature Reversa Forward correspondente

Tente localizar a feature pelo número da issue. Busque por diretórios em `_reversa_forward/` cujo prefixo numérico (com ou sem zeros à esquerda) corresponda a `<N>`:

```bash
ls _reversa_forward/ 2>/dev/null | grep -E "^0*<N>-"
```

**Caso A — Feature encontrada:**

Leia os artefatos físicos da feature para determinar o estágio (mesma lógica da Fase 2.2.A):

| Artefatos presentes                                      | Estágio               | Pronto para código? |
|----------------------------------------------------------|-----------------------|---------------------|
| Nenhum / só pasta                                        | vazio                 | ❌                  |
| `requirements.md` apenas                                 | requirements          | ❌                  |
| `roadmap.md` mas sem `actions.md`                        | plan                  | ❌                  |
| `actions.md` com pelo menos uma linha `\| ... \| [ ] \|` | coding-em-progresso   | ✅                  |
| `actions.md` com todas as linhas `[X]`                   | done                  | ⚠️ já concluído    |

**Se pronto (✅):** apresente:

> Feature Reversa Forward encontrada para a issue #N:
> - `<NNN>-<short-name>` | Estágio: codificação em andamento
> - `<concluídas>` de `<total>` ações concluídas em `actions.md`
>
> Vou configurar o worktree vinculado a esta feature e à issue #N.
> Confirma? (s/n)

Se confirmado:
- Registre internamente: `feature-dir`, `feature-id` como inteiro, `issue-number = N`, `short-name`
- Derive branch: `feat/<N>-<short-name>` (sem zeros à esquerda)
- Derive worktree-path: `.claude/worktrees/<short-name>`
- Pule a Fase 1 e vá direto para a Fase 2, seção 2.3 (confirmação de nomes)

**Se não pronto (❌):**

> Feature Reversa Forward encontrada (`<NNN>-<short-name>`), mas ainda no estágio `<estágio>` — sem ações de código definidas.
>
> Para manter a documentação alinhada, complete o pipeline antes de codificar:
> - Execute `/reversa-forward` para ver o próximo passo
>
> O quê prefere fazer?
> 1. Pausar e completar o pipeline Reversa Forward primeiro (recomendado)
> 2. Criar worktree avulso vinculado apenas à issue #N (sem feature docs)

Se escolher 2: registre apenas `issue-number = N` e vá para a Fase 1 (modo normal, mas com issue pré-preenchida).

**Se done (⚠️):**

> Feature `<NNN>-<short-name>` já está concluída no Reversa Forward. A issue #N tem ajustes ou é uma continuação?
> 1. Vincular mesmo assim (ex.: correção pós-merge)
> 2. Não vincular — criar worktree avulso
> 3. Iniciar nova feature com `/reversa-forward` baseada na issue

**Caso B — Feature não encontrada no Reversa Forward:**

> Issue #N encontrada: "**`<título>`**"
> Não há feature Reversa Forward correspondente a esta issue.
>
> Para manter documentação e rastreabilidade, é recomendado criar a feature no pipeline antes de codificar:
> - `/reversa-forward <título da issue>` — inicia requirements com o título da issue como ponto de partida
>
> Como quer prosseguir?
> 1. Pausar e iniciar pipeline com `/reversa-forward` (recomendado)
> 2. Criar worktree avulso vinculado apenas à issue #N (sem feature docs)

Se escolher 2: registre `issue-number = N`, derive `slug` do título da issue (kebab-case, max 5 palavras), e vá para a Fase 1 com issue e slug pré-preenchidos (pule as perguntas manuais correspondentes na Fase 2.2.B).

---

## FASE 1 — Escolha do modo de trabalho

Ao ser ativado, pergunte:

> **Como você quer trabalhar nesta sessão?**
>
> 1. **Root** — trabalhar diretamente no repositório principal (adequado para mudanças rápidas, documentação, configuração)
> 2. **Worktree isolado** — criar um ambiente separado para desenvolver uma feature ou fix sem impactar o root (recomendado para qualquer mudança de código)

Se o usuário escolher **Root**, encerre o skill. O agente segue normalmente no repositório principal.

Se o usuário escolher **Worktree isolado**, avance para a Fase 2.

---

From Tavaressan/Vetor, MIT.

More from Tavaressan/Vetor