Visual
The Visual tab shows your work-item hierarchy as a connected tree. From here you can Sync Azure Boards work items from Spec Kit files (one level at a time), find and auto-link existing Boards items into the Spec Kit tree, refine items with AI, and explore links.
If Spec Kit is not initialized yet, the right panel still shows Initialize Spec Kit. After Spec Kit is initialized but before you have Epics or Features to show, Visual may show "No work items found" with + Start a New Spec Session:
After you generate specs and sync work items, the hierarchy canvas looks like this:
The hierarchy
flowchart LR
C["Constitution"] --> E["Epic"]
E --> F["Feature"]
F --> U["User Story"]
U --> T["Task"]
The Constitution node is an anchor from your Spec Kit constitution — it is not an Azure Boards work item. Epics, Features, User Stories, and Tasks are Boards items. Type names follow your process template (for example, "Issue" instead of "Feature").
Each card shows type, ID, status, title, child counts, and a magic-wand button. Click the title to open the work item in Azure DevOps.
Items stay on the main Spec Kit tree when they are Spec Kit–owned, carry the raaghuspeckit-autolinked tag, or overlap a real wiki spec.md / tasks.md. Unmatched Boards items appear in the orphan graph after you run chart Sync.
Sync and refine (magic wand)
Open a card's magic-wand menu:
| Sync from | Creates | Requires in Wiki |
|---|---|---|
| Constitution | Epics | Kept constitution |
| Epic | Features | At least one feature spec |
| Feature | User Stories | Feature spec |
| User Story | Tasks | Feature tasks |
Work level by level. Sync compares Spec Kit files to existing items and creates or updates them — it does not create duplicates. Syncing one level does not automatically create all deeper children.
Refine opens the item in chat so you can improve it with AI.
If Sync is disabled, generate the required files first with Spec Kit Commands.
Chart Sync (find and auto-link)
One control sits on the Visual chart overlay (separate from the magic-wand Sync | … actions that create items from wiki files):
| Control | Label | What it does |
|---|---|---|
| Chart Sync | Sync / Syncing… | Finds work items outside the Spec Kit hierarchy, then auto-links matching items into the tree |
Chart Sync first discovers orphans (toast title may still say Scan complete), then runs auto-link. Auto-link requires Spec Kit to be initialized (constitution present) and an AI provider. If AI is not configured, you may see Auto-link skipped — Configure an AI provider to auto-link work items. If Spec Kit is not initialized, auto-link is skipped until you initialize.
When linking succeeds, you may see Auto-link complete (for example Linked N work item(s) into the Spec Kit hierarchy.) Linked cards can show a green check (connected to the project hierarchy). Spec Kit stamps the raaghuspeckit-autolinked tag on matched items.
Spec gaps
When a linked brownfield item’s description is behind the matching wiki content, the card shows an amber warning (spec gaps detected). Hover the warning to see the match (for example Matched to spec …), that Description is behind the spec., missing sections (for example Missing Overview), and Click the wand → Refine to update from the spec.
Use the magic wand → Refine, review the draft (Preview / Edit / Diff), then continue to update the work item from the constitution / spec.md / tasks.md.
Related work in the wiki
Chart Sync auto-link and gap Refine can add a Related work section on the matched wiki page (constitution or feature spec) with entries for the linked Boards items, and can add a wiki hyperlink on the work item. Open the wiki page under Raaghu Spec Kit/ (or Speckit/ on older projects) to review it.
Navigate the canvas
- Expand or collapse branches with the count badges.
- Filter by type and search by title in the toolbar.
- Pan and zoom the canvas.