Visuals
A aba Visuals mostra o seu trabalho como uma árvore conectada de itens do Azure Boards (Epic → Feature → User Story → Task). Use-a para criar work items a partir das páginas do wiki do Raaghu Spec Kit, vincular itens existentes do Boards a essa árvore, melhorar itens com IA e explorar vínculos.
Há duas ações Sync diferentes — não as confunda:
| Sync | Onde | O que faz |
|---|---|---|
| Wand Sync | Varinha mágica em um card | Cria ou atualiza itens do Boards a partir de páginas do wiki (um nível por vez) |
| Chart Sync | Botão azul Sync na barra de ferramentas do canvas | Encontra itens existentes do Boards e vincula os correspondentes à árvore do Raaghu Spec Kit |
Se o Raaghu Spec Kit ainda não estiver inicializado, o painel direito ainda mostra Initialize Raaghu Spec Kit. Depois de inicializado, mas antes de haver Epics ou Features para exibir, o Visuals pode mostrar "No work items found" com + Start a New Spec Session:
Depois de gerar specs e sincronizar work items, o canvas de hierarquia fica assim:
A hierarquia
flowchart LR
C["Constitution"] --> E["Epic"]
E --> F["Feature"]
F --> U["User Story"]
U --> T["Task"]
O nó Constitution vem da constitution do Raaghu Spec Kit — não é um work item do Azure Boards. Epics, Features, User Stories e Tasks são itens do Boards. Os nomes dos tipos seguem o seu process template (por exemplo, "Issue" em vez de "Feature").
Cada card mostra tipo, ID, status, título, contagens de filhos e um botão de varinha mágica. Clique no título para abrir o work item no Azure DevOps.
Os itens permanecem na árvore principal do Raaghu Spec Kit quando o Raaghu Spec Kit os possui, quando têm a tag raaghuspeckit-autolinked ou quando correspondem a uma página real de feature no wiki (spec / tasks). Itens do Boards que ainda não estão na árvore aparecem separadamente depois que você executa o Sync do gráfico (itens aguardando vínculo).
As páginas do Azure DevOps Wiki não usam extensão de arquivo .md. A documentação pode citar spec ou tasks como nomes das páginas do wiki. Textos mais antigos como spec.md referem-se à mesma página do wiki.
Wand Sync e Refine (varinha mágica)
Abra o menu da varinha mágica de um card para criar o próximo nível de work items a partir das páginas do wiki:
| Sync a partir de | Cria | Exige no Wiki |
|---|---|---|
| Constitution | Epics | Constitution mantida |
| Epic | Features | Pelo menos um spec de feature |
| Feature | User Stories | spec da feature |
| User Story | Tasks | tasks da feature |
Trabalhe nível a nível. O Wand Sync compara as páginas do wiki do Raaghu Spec Kit com os itens existentes e os cria ou atualiza — não cria duplicatas (incluindo Features já cobertas por itens existentes do Boards auto-vinculados). Sincronizar um nível não cria automaticamente todos os filhos mais profundos.
Refine abre o item no chat para que você possa melhorá-lo com IA.
Se o Sync estiver desabilitado, gere primeiro as páginas necessárias do wiki com Comandos do Raaghu Spec Kit ou Workflows.
Sync-ready
Quando um Epic tem Features no wiki que ainda não foram criadas sob ele no Boards, o card pode mostrar uma varinha sync-ready (separada do aviso âmbar de spec gaps). Passe o mouse no ícone para ver os nomes (por exemplo Feature A, Feature B — click Sync to create these Features). Use a varinha mágica do card → Sync para criá-las. O distintivo some quando o Sync não criaria nada.
Chart Sync (encontrar e auto-vincular)
O botão azul Sync na barra de ferramentas do canvas do Visuals é separado do Sync da varinha:
| Controle | Rótulo | O que faz |
|---|---|---|
| Chart Sync | Sync / Syncing… | Encontra work items fora da árvore do Raaghu Spec Kit e, em seguida, auto-vincula Epics correspondentes à hierarquia |
O Chart Sync primeiro encontra itens que ainda não estão na árvore (o toast ainda pode dizer Scan complete) e depois executa o auto-link. O auto-link corresponde Epics à constitution do projeto. Features, User Stories e Tasks sob um Epic correspondente vêm da hierarquia do Boards desse Epic. O Raaghu Spec Kit precisa estar inicializado (constitution presente) e a IA configurada (seu provedor ou Raaghu AI). Se a IA não estiver configurada, você pode ver Auto-link skipped — Configure an AI provider to auto-link work items. Se o Raaghu Spec Kit não estiver inicializado, o auto-link espera até você inicializar.
Quando o vínculo funciona, pode aparecer Auto-link complete (por exemplo Linked N work item(s) into the Raaghu Spec Kit hierarchy.). Cards de Epic vinculados podem mostrar um check verde (connected to the project hierarchy). O Raaghu Spec Kit aplica a tag raaghuspeckit-autolinked nos itens correspondentes.
Spec gaps
Quando a descrição de um item existente do Boards vinculado está atrás do conteúdo correspondente no wiki, o card mostra um aviso âmbar (spec gaps detected). Passe o mouse no aviso para ver a correspondência (por exemplo Matched to spec …), que Description is behind the spec., seções ausentes (por exemplo Missing Overview), e Click the wand → Refine to update from the spec.
Use a varinha mágica → Refine, revise o rascunho (Preview / Edit / Diff) e continue para atualizar o work item a partir das páginas do wiki da constitution / spec / tasks da feature.
Related work no wiki
O auto-link do Chart Sync pode adicionar uma seção Related work na constitution para Epics vinculados, e o Refine de gap pode adicionar Related work na página do wiki correspondente (constitution ou spec da feature) com entradas dos itens do Boards vinculados. Sync / Refine também podem adicionar um hyperlink do wiki no work item. Entradas de itens do Boards que não existem mais são removidas quando Sync ou Refine atualiza a página. Abra a página do wiki em Raaghu Spec Kit/ (ou Speckit/ em projetos mais antigos) para revisar.
Navegar no canvas
- Expanda ou recolha ramificações com os badges de contagem.
- Filtre por tipo e pesquise por título na barra de ferramentas.
- Faça pan e zoom no canvas.