🧠 OpenSpec Workflow Visualizer

Turn your OpenSpec files into a live Kanban & progress dashboard.

Stop reading proposal.md → design.md → task.md manually. See your progress instantly.

---

✨ What is this?

OpenSpec Workflow Visualizer transforms your OpenSpec workflow into:

• ✅ A Kanban board
• ✅ Lifecycle progress tracking
• ✅ Blocker detection
• ✅ Workflow intelligence

Built for developers who manage work through markdown and specs.

---

🎯 Why this exists

If you use OpenSpec, your workflow looks like:

proposal.md → design.md → task.md → implementation

But today:

• ❌ Progress is hidden in files
• ❌ Blockers are invisible
• ❌ Workflow status is unclear

This tool makes your workflow visible & actionable.

---

🖥️ What you get

📊 Kanban Board from Markdown

• Auto-detect tasks
• Track status
• Drag & drop workflow

🔄 Spec Lifecycle View

See status instantly:

Stage	Status
Proposal	✅ Complete
Design	⚠️ Missing sections
Tasks	🔄 In progress
Build	⏳ Pending

🚧 Blocker Detection

• Identify missing steps
• Detect stalled tasks
• Highlight dependencies

📈 Progress Intelligence

• Completion %
• Workflow health
• Milestone tracking

---

⚡ Demo

Lifecycle Progress          Kanban Board
─────────────────           ──────────────────────────────────
✔ Proposal complete         Backlog → In Progress → Review → Done
⚠ Design incomplete
⏳ Tasks pending

📸 GIF demo coming soon

---

🧩 How it works

1. Parse your OpenSpec files
2. Detect lifecycle stages
3. Extract tasks & status
4. Visualize workflow progress

No config. No migration. Markdown stays the source of truth.

---

🚀 Quick Start

Install (VS Code)

Coming soon to VS Code Marketplace

Run locally

git clone https://github.com/vietanhvu225/OpenSpec-Mastermind.git
cd OpenSpec-Mastermind
npm install
npm run build

Then open a workspace containing OpenSpec files (openspec/config.yaml).

---

📂 Supported Structure

openspec/
├── config.yaml
├── specs/
│   └── ...
└── changes/
    └── my-change/
        ├── proposal.md
        ├── design.md
        └── tasks.md

---

🧠 Who is this for?

• ✔ Developers using OpenSpec
• ✔ AI-assisted coding workflows
• ✔ Spec-driven development teams
• ✔ Markdown-first productivity nerds

---

🔥 Roadmap

MVP

• Spec parser
• Kanban board
• Lifecycle status

Next

• Dependency graph
• Progress analytics
• Roadmap timeline

AI-native future

• Suggest next steps
• Detect spec gaps
• AI workflow sync

---

🤝 Contributing

PRs welcome. Ideas welcome. Experiments welcome.

If you believe specs should be first-class citizens in dev workflow — join us.

---

⭐ Philosophy

Markdown is the source of truth. Workflow should be visible. AI should understand progress.

---

📄 License

MIT © vietanhvu225

---

If this helps you — give it a ⭐, share with your dev friends, and help build the future of spec-driven development!