Project · Active development

SpecKit Governance Dashboard

An open-source tool to transform scattered SpecKit and Markdown files into a clear visual dashboard that tracks features, implementation stages, decisions, and risks, while keeping the original files as the Source of Truth without modifying them.

Technologies: TypeScript · CSS · JavaScript · HTML Source repository
SpecKit Governance Dashboard UI screenshot
Main Dashboard interface of the SpecKit Governance Dashboard

What is this project?

SpecKit Governance Dashboard is a lightweight, fast tool built to solve documentation overload when using the Spec-Kit methodology.

In large projects, files like spec.md, plan.md, and tasks.md expand rapidly, making it hard to track where everything stands. This dashboard parses your Markdown files directly, compiling implementation stages, phase gates, checklists, and pending decisions into one clean interface—without modifying a single file (fully read-only).

Features & Functionality

  • Status Overview: Aggregates features and implementation phases in one view.
  • Governance Tracking: Automatically extracts phase gates, checklists, and pending decisions.
  • Markdown as Source of Truth: No external database or separate management system is introduced; it relies entirely on your existing text files.
  • Read-only Guarantee: Zero write operations on your codebase, ensuring your files remain untouched and secure.

Challenges & Engineering Decisions

The core objective of the tool was simplicity: solving documentation sprawl without introducing a heavier management layer. Consequently, we chose to parse Markdown files dynamically on demand rather than establishing a database synchronization process, keeping the solution direct, fast, and secure.