propose

propose

機能、改善、または問題を、追跡可能なロードマップ項目と初期 PR にします。このスキルはコードを一切書きません。ロードマップ項目に必要な情報をすべて集めて PR を作成したら、そこで終了します。実装は必ず後の別の手順で行います（/goal Implement <slug>.md）。

jackin' のルールファイルは自動的に読み込まれます — BRANCHING.md、COMMITS.md、PULL_REQUESTS.md、docs/ のルール、TODO.md（ロードマップの規約）。このスキルでは、これらに沿って手順を進めます。

使用する場面

• オペレーターが /jackin-dev:propose <idea or problem> を実行したとき。
• ロードマップ項目にする価値のある機能やアイデアがあるとき。

使用しない場面

• 小規模な修正（誤字、依存関係の更新、1 行の変更）→ /jackin-dev:create-pr。
• 既存項目の設計 → /jackin-dev:brainstorm。実装 → /goal Implement <slug>.md。

引数

• --branch <name> / --auto-branch — ブランチ名を明示的に指定する／自動で選ぶ。
• --no-pr — ブランチとロードマップのドラフトのみ作成し、PR は作成しません（まれなケースです。デフォルトでは PR を作成します）。
• --research — 最初に deep-research を実行し、短い要約をドラフトに反映します。

手順

1. ブランチを作成します。 main には決してコミットしません。アイデアから feature/<slug> の形式の名前を決めます（変更の種類に応じて fix/ / refactor/ / chore/ も使用します）。--auto-branch / --branch が指定されていない場合は、候補を提案して確認します。
2. （任意）調査します。 --research が指定されている場合は、組み込みの deep-research スキルを実行し、調査結果をドラフトに要約します。大規模な調査では /jackin-dev:research を優先してください。
3. ロードマップ項目のひな形を作成します。 cargo xtask change new <slug> --group <group> を実行します。これにより、docs/content/docs/roadmap/<slug>.mdx（**Status**: Open、## Problem、## Why It Matters、## Design、## Tasks、## Related Files）が作成され、選択したグループの Fumadocs meta.json に登録されます。既存のロードマップグループから --group を選びます。次に、アイデアの文章をもとに Problem / Why It Matters を記入し、cargo xtask roadmap audit を実行します。
4. コミットしてプッシュします。 docs: タイプと DCO の -s を付けてから、git push を実行します。
5. PR を作成します。 --no-pr が指定されていない場合は、create-pr の手順に従って PR を作成します。Summary = アイデア、What ships = "<slug> のロードマップ項目のドラフト"、Verify = ドキュメントのレンダリング。
6. 終了します。 次の手順として、## Design を記入する /jackin-dev:brainstorm <slug> をオペレーターに案内します。実装はしません。

よくある間違い

• コードを書いたり、## Design / ## Tasks を記入したりすること — これらは brainstorm / plan / goal の作業であり、propose では行いません。
• サイドバーへの項目追加や監査を省略し、項目にアクセスできなくなること。
• 初期 PR を忘れること（デフォルトで作成されます。--no-pr の場合にのみ省略します）。

ツール

cargo xtask change new <slug> --group <group> は .mdx のひな形を作成し、Fumadocs meta.json の項目を登録します。cargo xtask roadmap audit はサイドバーを検証します。