mcpField
R
requirements-generator

requirements-generator

github.com/nextstage-brasil開発045 回インストール5 日前に更新
リポジトリ

requirements-generator について

Requirements Generatorは、指定したプロダクトバージョン向けに構造化されたrequirements.mdを作成するスキルです。プロジェクト計画のワークフローを対象とし、汎用または適用可能なスタックプロファイルに沿って要件をまとめます。

主な機能

  1. 01バージョンごとのrequirements.md生成
  2. 02汎用およびスタック別プロファイルの選択
  3. 03調査内容を非機能要件や受け入れ基準に反映
  4. 04該当時にフロントエンドのUI/UX要件を追加
  5. 05データモデル、テーブル順序、エンドポイントの明記

活用シーン

  1. 01新しいプロダクトバージョンの要件案作成
  2. 02既知の技術スタックに合わせた要件作成
  3. 03調査結果を受け入れ基準に反映
  4. 04フロントエンドやデータモデル要件の文書化

インストール

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

$npx skills add https://github.com/nextstage-brasil/skills --skill requirements-generator

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

同梱ファイル

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

evals/
evals.json
references/stacks/
generic.md
intelligent-saas.md
laravel-react.md

詳細

要件ジェネレーター

{product_root}/docs/versions/{version_san}/ 用の、構造化された requirements.md を作成します。

ハーネスの確認

../nextstage-harness/references/harness-discovery.md と ../nextstage-harness/references/artifact-layout.md を参照してください。書き込みを始める前に、{product_root}/docs/versions/{version_san}/ を作成します。

入力

  • スコープの説明（clarify-requirements によって補足されている場合があります）
  • {product_root}、{version_san}
  • 任意：design-brief.md、スタックプロファイル、ブラウンフィールドマップ、オーケストレーターからのウェブ調査

スタックプロファイル

スタックが判明している場合は、references/stacks/ からプロファイルを1 つ読み込みます。

プロファイル適用条件
generic.mdデフォルト — スタックに依存しない構成
laravel-react.mdLaravel + React のモノレポを検出、または確認した場合
intelligent-saas.mdバックエンド + フロントエンド + agent-api

プロファイルまたは検出されたスタックが該当しない限り、フレームワーク固有のツールには言及しないでください。

ドキュメントの構成

Markdown ドキュメントのみを生成します（会話的な前置きは含めません）。

## Main objective of the version:

{executive summary}

## Technology stack:

{confirmed stack — reference applicable rules when harness has them}

## UI/UX guidelines:

{from design-brief when frontend in scope — omit if backend-only}

## Data model and APIs:

{tables, FK order, key endpoints — source of truth for tasks}

## Feature grouping:

### Feature 001 - TITLE

**Precedence:** None | Feature NNN
**Layers:** Backend | Frontend | Infrastructure | Tests
**Detailed description:** ...

#### Acceptance criteria:

- [ ] ...

## Non-functional requirements (NFRs):

...

新規プロジェクトの順序

プロジェクトがグリーンフィールドの場合、（スタックプロファイルに従って）インフラストラクチャ／セットアップ機能をドメイン機能より先に配置します。順序は次のとおりです：インフラ → データベース → キャッシュ／キュー → バックエンドモジュール → フロントエンド → テスト。

言語

成果物についてユーザーが別の言語を明示的に指定しない限り、英語を使用します。

ルール

  • 確認済みの {product_root} の配下でのみ作業します
  • 調査結果が提供されている場合は、NFR または受け入れ基準に反映します
  • フロントエンド機能には、デザインブリーフに基づく UI/UX セクションを含めます。該当する場合は、ビジュアルトークンの受け入れ基準も含めます
  • データモデルのセクションは重要です — テーブルの明示的な作成順序とエンドポイントを記載します

インテグレーション

  • 生成後：Gate 1（requirements_confirmed）— ../nextstage-harness/references/gates.md を参照してください
  • 次の手順：Gate 2 の後に analyze-consistency を実行します

参考資料

ファイル使用するタイミング
references/stacks/generic.mdデフォルト
references/stacks/laravel-react.mdLaravel／React スタック
references/stacks/intelligent-saas.mdエージェント拡張型 SaaS

コメント

Markdown 対応