requirement-convergence
Solid変更が生むべき成果と、そこへ至るために提案された要件を切り分け、ユーザーが除外したものを記録し、コストを構造からバンドで見積もる。要件がワークフローに入った時点、設計を始める前、または「どこまでやるか/スコープ外は何か/やる価値があるか」が言及された時に使用。
AI & Automation 225 stars
24 forks Updated 1 weeks ago MIT
Install
Quality Score: 88/100
Stars 20%
Recency 20%
Frontmatter 20%
Documentation 15%
Issue Health 10%
License 10%
Description 5%
Skill Content
# 要件収束
## 目的
要件は、膨らんだ状態、曖昧な状態、狙う成果を外した状態で届く。能力の高いモデルはその3つをまとめて筋の通った計画に組み直し、忠実に作り上げてしまう — 求められたものが間違っていたときに、求められたとおりのものを届けることになる。
このスキルは**何を作るか**を収束させる。どう作るか、そして変更にどのドキュメントが必要かは、何を作るかが決まった後に定める。
## 収束フィールド
| フィールド | 通過条件 |
|-----------|---------|
| `outcome` | 観測可能な結��が1つ。それに寄与しない要件は余剰である。 |
| `requirements[]` | 各項目に `current-state`、`desired-future`、`speculative` のいずれかのラベルが付いている。`speculative` はこのレイヤーラベルの1つであり独立したフィールドではない。「投機的要件」とはそのラベルを持つ項目を指す。 |
| `nonGoals[]` | ユーザーが挙げたもの。または、除外すべきものはないとユーザーが述べたこと。 |
| `cost` | バンド1つと、それを決めた構造���の根拠、および残っている不明点。 |
`cost` は粗いバンドであり、作業計画書がスケジュールの根拠にする工数見積ではない — 要件の段階では人日を支えられない。その不明点は、大きさよりも判断上の重みを持つ。
各フィールドは自身の readiness ラベルを持つ: `ready`、`weak`、`weak-but-explicit`(weak だが、未解決のまま残すことにユーザーが同意した状態)。`weak-but-explicit` を設定できるのはユーザーだけである。該当する全フィールドが `ready` または `weak-but-explicit` になった時点で、要件は収束したとみなす。
フィールドごとの判断ルール: [references/criteria.md](references/criteria.md)。
## ヒアリングプロトコル
聞き出す作業と判定の両方をオーケストレーターが担う。アナライザーが出したスコープとコストのエビデンスを用い、リポジトリからは答えられないプロダクト上の選択のみを尋ねる。アナライザーを再実行するのは、回答が分析対象または必要なスコープエビデンスを変える場合のみとする。
開始前に以下のステップを登録し、完了ごとにその根拠を記録する:
| ステップ | 行うこと | 完了の根拠 |
|---------|---------|-----------|
| 1 | 分析が出したスコープの事実を述べ、そこから要件について何が言えるかを分けて示す | 事実が、その出所となった分析出力とともに列挙されている |
| 2 | `ready` に達していないフィールドについて、1メッセージあたり最大2問で質問する | `ready` に達していないフィールドごとに1問 |
| 3 | 各回答をそのフィールドの値として記録する | 値が、ユーザーが選択した選択肢、またはユーザーが述べた言い回しになっている |
| 4 | 記録した値がまだ通過条件を満たさない場合は1度だけ聞き直し、2度目の回答のままでよいとユーザーが同意した時点でそのフィールドを `weak-but-explicit` とする | 記録された回答が2つ、またはそこで止める...
Details
- Author
- shinpr
- Repository
- shinpr/ai-coding-project-boilerplate
- Created
- 1 years ago
- Last Updated
- 1 weeks ago
- Language
- JavaScript
- License
- MIT
Similar Skills
Semantically similar based on skill content — not just same category
Code & Development Listed
requirements-review
要件・仕様(作るものの状態=WHAT)の壁打ちとレビュー。甘い前提・抜けた非機能要件・外部API/クラウド制約の見落としを媚びずに突き、確定要件を受入基準(AC)付きで固める。要件定義・仕様策定・仕様レビュー時に使用(実装・コードは対象外)。
1 Updated 3 days ago
mryo0826 AI & Automation Featured
requirement-convergence
Separates the outcome a change must produce from the requirements proposed to reach it, records what the user excluded, and bands cost from structure. Use when a requirement enters a workflow, before design begins.
664 Updated 2 weeks ago
shinpr AI & Automation Listed
brainstorming
アイデアや要件を対話的に設計書(PBI INPUT PACKAGE)へ昇華する。Use when: 「こういう機能を作りたい」「どう実装すればいい?」「要件を整理したい」「設計を考えたい」「ブレスト」「アイデア出し」「what if」「どういうアプローチがある?」「PBI INPUT PACKAGEを作りたい」「技術調査の方向性を決めたい」。実装計画の作成にはai-dev-workflowを使用。
2 Updated today
s977043