AGENT SKILL

zion-prd-evolve

Ponto de entrada único do dia 2 do harness Zion Build PRD — endereça mudanças pós-release (RF novo, RF alterado/removido, decisão revertida) versionando a PRD (§13 changelog), roteando supersessão de ADR e re-decomposição parcial, e parando nas pontes. Use quando um requisito muda depois da release 1, ou o usuário disser "mudou o escopo", "reverter uma decisão" ou "evoluir a PRD".

License 许可
MIT
最近更新
2026-07-29
Stars
★ 0
Forks
0

01 前言 Front Matter

name
zion-prd-evolve
metadata
{ "author": "zion-build-prd" }
description
Ponto de entrada único do dia 2 do harness Zion Build PRD — endereça mudanças pós-release (RF novo, RF alterado/removido, decisão revertida) versionando a PRD (§13 changelog), roteando supersessão de ADR e re-decomposição parcial, e parando nas pontes. Use quando um requisito muda depois da release 1, ou o usuário disser "mudou o escopo", "reverter uma decisão" ou "evoluir a PRD".
argument-hint
A mudança pós-release em linguagem natural (ex.: "exportar PNG saiu; entrou exportar SVG")
user-invocable
true
disable-model-invocation
false

02 资源文件 4

03 SKILL.md 正文

zion-prd-evolve — o dia 2 do harness (mudança pós-release)

Ponto de entrada único para mudar um artefato depois da release 1: um RF novo, um RF alterado ou removido, ou uma decisão estruturante revertida. Versiona a PRD (changelog na §13), roteia para os comandos donos de cada artefato parando em cada gate, e termina nas pontes — o ciclo /speckit.* é do usuário. Sequência e fronteira em references/process-context.md; regras do dia 2 em references/quality-rules.md #dia-2. Contrato de 5 fases; gates aconselham, nunca bloqueiam.

Cenários canônicos (uma mudança pode combinar mais de um)

  • C1 — RF novo: requisito que não existia. Toca §6 (RF no épico certo ou épico novo) + §13 + re-decomposição parcial do épico + tabela (§12 via trace).
  • C2 — RF alterado ou removido: requisito muda de significado ou sai de escopo. Toca §6 + §13 + specs do épico afetado + tabela; spec já com spec.md → contexto de re-specify montado pela ponte.
  • C3 — Decisão revertida: decisão estruturante caiu. Toca ADR novo que substitui o antigo (referência cruzada simétrica) + §8 (restrições) + §13 + aviso de revisar a constitution + a narrativa da §1 quando a decisão caída a sustentava (o bloco de avisos acusa).

Fase 0 — Pré-requisito (aconselha)

docs/PRD.md deve existir — o dia 2 pressupõe o dia 1. Faltando → avise ("recomendo /zion-prd-write antes") e pare graciosamente.

Fase 1 — Validar entrada e classificar

O argumento é a descrição da mudança em linguagem natural. Classifique-a em C1/C2/C3 (pode ser mais de um). Descrição vaga demais para classificar → pergunte em vez de adivinhar (ex.: "essa mudança cria um requisito novo, altera um existente, ou derruba uma decisão de arquitetura?"). Cuidado com a decisão que cai disfarçada de requisito (parece C2, é C3): se a mudança só se resolve trocando uma decisão estruturante já registrada num ADR, é C3. Confirme a classificação com o usuário antes de tocar qualquer arquivo.

Fase 2/3 — Plano de toque + execução roteada

Monte e mostre o plano de toque: a lista ordenada dos artefatos afetados e o comando dono de cada um. Execute inline só o que é barato e local; para o resto, pare e delegue com handoff explícito, um gate por vez — não encadeie tudo num turno só.

Inline (você mesmo):

  • §13 (changelog) — acrescente uma linha na tabela da §13 da PRD, no formato de #dia-2: Data, Cenário (só C1/C2/C3), Mudança, Motivo, Artefatos afetados. O evolve é o dono da escrita do changelog.
  • Edição pontual da §6/§8 — o RF novo/alterado na §6 (no épico certo) ou a restrição na §8.

Delegado (pare em cada gate):

  • Supersessão de decisão (C3) → /zion-adr-new "<título>" --substitui ADR-<n>: cria o ADR novo com Substitui: ADR-<n> e marca o antigo Status: Substituído por ADR-<m> (referência simétrica).
  • Re-fatiamento do épico afetado (C1/C2) → /zion-prd-decompose --epico E<k>: re-fatia apenas o épico indicado; specs já implementadas são intocáveis.
  • Narrativa estrutural defasada (C1/C2/C3) → /zion-prd-decompose --narrativa: quando a mudança cria/derruba componente ou contrato de topo, ou quando o bloco zion:narrativa-avisos do docs/architecture.md acusa narrativa-superseded/narrativa-defasada. Revisa só a §1–§2, sem re-fatiar nada, e nunca sobrescreve a prosa do Autor sem confirmação (ADR-018).
  • Reconciliação da tabela (§12) → /zion-prd-trace: dono único da tabela.
  • Spec já especificada (C2) → /zion-prd-specify-prompt em enquadramento re-specify: revê a spec existente contra a mudança, com a linha da §13 como contexto.
  • ADR substituído alimentava a constitution (C3) → aconselhe rodar /zion-prd-constitution-prompt de novo (não edita a constitution).

Fase 4 — Validar saída (aconselha)

Rode os verificadores do references/ e ecoe o veredito por item — não reverta:

bash references/check-prd.sh prd docs/PRD.md
bash references/check-adr.sh docs/adr

check-prd.sh confere a §13 (todo RF-xx/ADR-xxx citado existe, ou a linha o declara "removido"; Cenário só C1/C2/C3) e a §8 (restrição apontando ADR substituído → restricao-morta). check-adr.sh confere a simetria da supersessão. Scripts ausentes (instalação parcial) → degrade para conferência em prosa contra #dia-2, com aviso — como as demais skills.

Saída

A PRD versionada (§13), os artefatos afetados atualizados pelos comandos donos e — quando a mudança toca uma spec já especificada — o prompt de re-specify pronto para o usuário disparar. PARE nas pontes: o ciclo /speckit.* é do usuário.

04 同仓库更多 Skills

tuyoshivinicius
tuyoshivinicius/zion-build-prd

zion-speckit-install

Instala a integração do harness Zion Build PRD com o Spec Kit no repositório do PRODUTO — grava o bloco versionado de regras de fonte canônica no CLAUDE.md, semeia docs/architecture.md de esqueleto e oferece um guard de pre-commit opt-in. Idempotente e re-rodável, substitui só o bloco marcado e nunca sobrescreve documento existente. Use para "instalar a integração com o Spec Kit", "declarar o canon no repo do produto" ou para atualizar o bloco de regras após upgrade do harness.

★ 0
tuyoshivinicius
tuyoshivinicius/zion-build-prd

zion-prd-write

Estágio 3 do harness Zion Build PRD — copia o esqueleto da PRD e conduz o preenchimento seção a seção (RF-xx por épico, NFRs com número, restrições das ADRs), guardando a fronteira o-quê/como. Use para "escrever a PRD", "preencher a PRD" ou revisar uma PRD existente, depois da descoberta e dos spikes.

★ 0
tuyoshivinicius
tuyoshivinicius/zion-build-prd

zion-prd-trace

Reconcilia a rastreabilidade da PRD (§12), o backlog de specs (docs/backlog.md) e os blocos derivados do docs/architecture.md do produto (índice de ADRs, visão do backlog) a partir das specs/*/spec.md — RF↔spec, spec↔pasta e status ☐/◐/● derivados por máquina, com o veredito advisório do check de arquitetura ecoado. É o ritual de fim de spec. Use para "atualizar a rastreabilidade", "reconciliar a tabela/o backlog" ou depois de fatiar/implementar uma spec. Rodável a qualquer momento.

★ 0
tuyoshivinicius
tuyoshivinicius/zion-build-prd

zion-prd-spike

Estágio 2 do harness Zion Build PRD — pesquisa os trade-offs das 2–3 decisões estruturantes e registra ADRs em docs/adr/ antes de fechar a PRD. Use após a descoberta, sempre que houver decisões que mudam a PRD inteira a provar com spike, ou quando o usuário mencionar "decisões estruturantes", "trade-offs" ou "ADRs".

★ 0
tuyoshivinicius
tuyoshivinicius/zion-build-prd

zion-prd-specify-prompt

Ponte do harness Zion Build PRD para o Spec Kit — monta o prompt do /speckit.specify de UMA spec vertical, blindando a fronteira sem-stack, entrega pronto e para. Use para levar uma spec do backlog ao Spec Kit; não dispara o /speckit.* por você.

★ 0
tuyoshivinicius
tuyoshivinicius/zion-build-prd

zion-prd-plan-prompt

Ponte do harness Zion Build PRD para o Spec Kit — monta o prompt do /speckit.plan de UMA feature injetando os ADRs confirmados — e, quando existe, a prosa estrutural do docs/architecture.md do produto — como restrição a honrar, entrega pronto e para. Use para levar uma feature (spec.md + ADRs) ao passo plan do Spec Kit; não dispara o /speckit.* por você.

★ 0