mcpField
N
ns-sdd-version-partitioner

ns-sdd-version-partitioner

github.com/nextstage-brasil開発067 回インストール1 週間前に更新
リポジトリ

ns-sdd-version-partitioner について

マスターの requirements.md を順次計画できるサブバージョンに分割し、ロードマップと要件の抜粋を作成するスキルです。この文書ベースのバージョン計画を行うチーム向けです。

主な機能

  1. 01機能、依存関係、データモデルの手掛かりを解析
  2. 02依存関係の DAG を構築
  3. 03ドメイン別に分類し、大きなスライスを分割
  4. 04ロードマップと要件抜粋を作成
  5. 05各スライスに空の tasks ディレクトリを作成

活用シーン

  1. 01大規模なリリース要件を順次計画する単位に分割
  2. 02スライスごとのタスク計画前にロードマップをレビュー

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/nextstage-brasil/skills --skill ns-sdd-version-partitioner

インストール後、Claude Code で/ns-sdd-version-partitionerを入力して読み込まれたか確認します。

同梱ファイル

SKILL.md と一緒にインストールされる参考資料やスクリプト。

evals/
evals.json
references/
partition-workflow.md
version-roadmap.template.md

詳細

バージョン分割ツール

master の requirements.md を分割し、順次計画できるサブバージョンにします。

ハーネスの確認

../ns-harness/references/artifact-layout.md と ../ns-harness/references/harness-discovery.md を参照してください。ハーネスに core-subversions ルールがある場合は読み込んでください。

対象範囲

  • 読み取り専用: master {product_root}/docs/versions/{version_san}/requirements.md
  • 禁止事項: タスクや execution-handoff の生成、Gate 1 の再実行
  • 読み込まない: 製品のバックエンド/フロントエンドのルール — 構造上の分割のみ行います

アルゴリズム

  1. master を解析 — 機能、優先順位、データモデルのヒント、レイヤータグ
  2. DAG を構築 — デフォルトの順序は schema → API → FE → テストです。明示された優先順位があればそれに従います
  3. 境界コンテキストごとにグループ化 — ドメイン/エンティティごとにまとめます
  4. 規模が大きすぎるグループを分割する条件:
    • 相互依存する機能が 12 を超える、または
    • 推定タスク数が約 50、または
    • トークン数のヒューリスティックが約 600k
  5. 規模が小さすぎるグループを統合 — 安全な場合は、約 4 タスク未満の隣接スライスを統合します。サブバージョンあたり4~7 タスクを目標にします
  6. トポロジカルソート — フォルダー名は 01-slug、02-slug、… とします
  7. 成果物を出力:
    • バージョンのルートに version-roadmap.md
    • subversions/{subversion_san}/requirements.md — 抜粋と、master の ../requirements.md#Feature-ID へのリンク
    • 各スライスに空の subversions/{subversion_san}/tasks/

ロードマップの表の列

| NN | slug | 機能 | 依存関係 | 推定タスク数 | 推定トークン数 | ステータス |

status は pending で開始します。

出力チェックリスト

  • version-roadmap.md を保存
  • 抜粋した要件を含むすべてのサブバージョンフォルダーと、空の tasks/
  • task-*.md が作成されていない
  • 人がスライス計画のループ前にレビューできる

参照資料

ファイル用途
references/version-roadmap.template.mdロードマップの構成
references/partition-workflow.md分割後のオーケストレーターのループ

統合

分割後 → Gate Roadmap(人が確認)→ Gate 1 を繰り返さずに各スライスを計画(Gate 2~3、タスク)。

コメント