Turn a feature, improvement, or problem into a tracked roadmap item and an early PR. This skill never writes code — it collects everything for the roadmap item, opens the PR, and stops. Implementation is always a separate later step (/goal Implement <slug>.md).

jackin❯ rule files auto-load — BRANCHING.md, COMMITS.md, PULL_REQUESTS.md, docs/ rules, TODO.md (roadmap conventions). This skill sequences them.

When to use

Operator runs jackin-propose <idea or problem>.
Feature/idea worth a roadmap item.

When NOT to use

Small fix (typo, dep bump, one-liner) → jackin-create-pr.
Designing an existing item → jackin-brainstorm. Implementing one → /goal Implement <slug>.md.

Arguments

--branch <name> / --auto-branch — explicit / self-chosen branch name.
--no-pr — branch + roadmap draft only, no PR (rare; default opens a PR).
--research — run deep-research first and fold a short summary into the draft.

Process

Branch. Never commit to main. Derive a feature/<slug> name (or fix/ / refactor/ / chore/ per change type) from the idea; suggest and confirm unless --auto-branch / --branch given.
(optional) Research. On --research, run the built-in deep-research skill and summarize findings into the draft. For large research, prefer jackin-research.
Scaffold the roadmap item. Run cargo xtask change new <slug> --group <group> — it creates docs/content/docs/roadmap/<slug>.mdx (Status: Open, ## Problem, ## Why It Matters, ## Design, ## Tasks, ## Related Files) and registers it in the chosen group's Fumadocs meta.json. Pick the --group from the existing roadmap groups. Then fill Problem / Why It Matters from the idea text, and run cargo xtask roadmap audit.
Commit + push. docs: type, DCO -s, then git push.
Open the PR. Unless --no-pr, build and open the PR with create-pr mechanics — Summary = the idea, What ships = "roadmap item draft for <slug>", Verify = docs render.
Stop. Point the operator at the next step: jackin-brainstorm <slug> to fill ## Design. Do not implement.

Common mistakes

Writing code or filling ## Design / ## Tasks — those belong to brainstorm / plan / goal, never propose.
Skipping the sidebar entry or audit, leaving the item unreachable.
Forgetting the early PR (it is the default — only --no-pr skips it).

Tooling

cargo xtask change new <slug> --group <group> scaffolds the .mdx + registers the Fumadocs meta.json entry; cargo xtask roadmap audit validates the sidebar.

npx skills add jackin-project/jackin-dev --skill jackin-propose