Tools & Workflow
The Specification Toolchain
A comprehensive guide to every tool category in the spec-to-code workflow, with decision matrices for solo, small team, and enterprise.
The Complete Specification Toolchain
Modern product specification spans six categories of tools. Understanding the landscape prevents both under-tooling (trying to do everything in sticky notes) and over-tooling (enterprise tools for a 2-person team).
Story Writing & Management
Jira — The enterprise standard. Epics, stories, sub-tasks. Agile boards (Kanban and Scrum). Deep reporting. Integrates with GitHub, CI/CD, Confluence. Free for up to 10 users. Best for: teams needing deep reporting and integration with existing enterprise tooling. Learning curve is real.
Linear — The modern challenger. Keyboard-first, fast, opinionated workflow. $8/user/month. Integrates with GitHub and Figma. Best for: teams that want Jira's power without its complexity. Loved by developer teams.
ClickUp — All-in-one platform: tasks, docs, goals, time tracking. Generous free tier. Best for: teams wanting a single tool for everything.
Shortcut (formerly Clubhouse) — Balanced between features and simplicity. Good Agile support without Jira's weight. $8.50/user/month.
Trello — Visual Kanban boards. Drag-and-drop. Very low learning curve. Free tier is capable. Best for: small teams who want visual simplicity.
Notion — Combines docs + database + tasks in one. Build your own backlog view. Free personal. Best for: teams that want stories and documentation in the same place.
Story Mapping
Miro — Most popular digital whiteboard. Infinite canvas, sticky notes, real-time collaboration. Free tier for 3 collaborators.
FigJam — Lightweight collaboration in the Figma ecosystem. Free with Figma accounts.
StoriesOnBoard — Purpose-built for story mapping. Persona integration, release planning, Jira sync. $9/user/month.
Avion — Two-way Jira sync. Keeps story map and backlog in sync automatically.
Wireframing & Mockups
Figma — Industry standard for wireframing and mockups. Free tier, browser-based, real-time collaboration. Best all-around choice.
Balsamiq — Purpose-built wireframing with sketch aesthetic. Prevents premature visual design discussions. $9/month.
Whimsical — Wireframes + flowcharts + mind maps combined. Clean, fast interface.
Excalidraw — Free, zero learning curve, hand-drawn style. VS Code extension.
AI Design Generators
Figma AI — AI within Figma. Best for designers.
v0.dev — Text to React + Tailwind code. Best for developers.
Bolt.new — Text to full running app. Best for prototypes.
Visily — AI wireframes for non-designers. Best for PMs.
SDD & Spec Management
cc-sdd — Open-source SDD implementation. Works with 8+ AI agents. Free.
Kiro IDE — AI-native IDE with built-in SDD pipeline. From Amazon.
GitHub spec-kit — GitHub-native spec templates and workflows.
Decision Matrix
| Context | Recommended Stack |
|---|---|
| Solo developer | Notion + Figma + Excalidraw + cc-sdd |
| Small team (3-5) | Linear + Figma + Miro + cc-sdd |
| Mid-size team (5-15) | Jira + Figma + Confluence + cc-sdd |
| Enterprise | Jira + Figma + Confluence + custom steering |
Key Takeaways
- Six tool categories: story management, story mapping, wireframing, AI design, diagramming, SDD
- Match tool complexity to team size — don't adopt enterprise tools for solo or small team work
- Figma + Linear + cc-sdd is the most popular modern stack for developer-led product teams
- AI design tools (v0.dev, Bolt.new, Figma AI) accelerate mockup generation but don't replace judgment
- cc-sdd integrates across all other categories — it reads your specs and implements them
Example
# Tool Stack Decision Guide
## Solo Developer
Story tracking: GitHub Issues or Notion database
Story mapping: Excalidraw or FigJam
Wireframes: Excalidraw or Balsamiq
Mockups: Figma (free tier) or v0.dev
SDD: cc-sdd + Claude Code
Documentation: README.md + .kiro/ steering files
## Small Team (3-5 people)
Story tracking: Linear ($8/user/month)
Story mapping: Miro (free tier)
Wireframes: Figma (free tier, 3 collaborators)
Mockups: Figma + v0.dev for components
SDD: cc-sdd with shared .kiro/ in git repo
Documentation: Notion workspace
## Mid-size Team (5-15 people)
Story tracking: Jira (free up to 10, then $7.75/user)
Story mapping: Miro or StoriesOnBoard
Wireframes: Figma (paid, unlimited collaborators)
Mockups: Figma design system
SDD: cc-sdd + custom steering templates
Documentation: Confluence