sdd-webapp

SDD (Spec Driven Development) プラグイン用の Web ダッシュボード。

機能

• 仕様書ビューア: specs/ ディレクトリ内の Markdown ファイルを整形表示
• ダッシュボード: タスク一覧、進捗状況、次のコマンド提案
• 複数プロジェクト管理: 1つのサーバーで複数プロジェクトを管理

使い方

サーバー起動

# デフォルト（10000以降の空きポートを自動選択）
bunx @r_masseater/sdd-webapp

# ポート指定
bunx @r_masseater/sdd-webapp --port 12345

プロジェクト登録

ブラウザのUIから登録するか、MCP経由で登録できます。

MCP Server

Claude Code や他の AI ツールからプロジェクトを管理するための MCP サーバーを提供しています。

起動

# MCP サーバーを起動
bunx @r_masseater/sdd-webapp mcp

設定

.claude/settings.local.json に以下を追加:

{
  "mcpServers": {
    "sdd-webapp": {
      "command": "bunx",
      "args": ["@r_masseater/sdd-webapp", "mcp"]
    }
  }
}

利用可能なツール

| ツール名 | 説明 | |---------|------| | sdd_webapp_add_project | プロジェクトを登録 | | sdd_webapp_list_projects | 登録済みプロジェクト一覧 | | sdd_webapp_remove_project | プロジェクトを削除 | | sdd_webapp_get_status | タスクステータス取得 |

技術スタック

• バックエンド: Hono + Bun.serve()
• フロントエンド: React 19 + Vite
• Markdown: marked + highlight.js
• MCP: @modelcontextprotocol/sdk

開発

# 依存関係インストール
bun install

# 開発サーバー起動
bun run dev

# クライアント開発（Vite HMR）
bun run dev:client

# ビルド
bun run build

# 型チェック
bun run typecheck

リリース

手動リリース

cd packages/sdd-webapp

# ドライラン（実際にはpublishしない）
bun run release:dry

# 本番リリース
bun run release

GitHub Actions 経由

1. タグでリリース:

   git tag sdd-webapp-v0.1.0
   git push origin sdd-webapp-v0.1.0

2. 手動トリガー:

   • GitHub Actions の "Publish sdd-webapp to npm" ワークフローを手動実行
   • バージョン番号を入力

必要な設定

• NPM_TOKEN: npm の publish 用トークンを GitHub Secrets に設定