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

ContextRecommended Stack
Solo developerNotion + Figma + Excalidraw + cc-sdd
Small team (3-5)Linear + Figma + Miro + cc-sdd
Mid-size team (5-15)Jira + Figma + Confluence + cc-sdd
EnterpriseJira + 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

markdown
# 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
Try it yourself — MARKDOWN