jackin-propose

jackin-propose

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

jackin❯ ルールファイルは自動的に読み込まれます — BRANCHING.md、COMMITS.md、PULL_REQUESTS.md、docs/ のルール、TODO.md（ロードマップの規約）。このスキルは、それらを順に適用します。

使用するタイミング

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

使用しないタイミング

• 小さな修正（誤字、依存関係の更新、1 行の変更）→ jackin-create-pr。
• 既存項目の設計 → jackin-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-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. 終了します。 次のステップとして jackin-brainstorm <slug> を案内し、## Design を記入してもらいます。実装は行いません。

よくある間違い

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

ツール

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