propose

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-dev:propose <idea or problem>
```
.
Feature/idea worth a roadmap item.

When NOT to use

Small fix (typo, dep bump, one-liner) →
```
/jackin-dev:create-pr
```
.
Designing an existing item →
```
/jackin-dev: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-dev:research
```
.

Scaffold the roadmap item. Run

cargo xtask change new <slug> --group <group>

— it creates

docs/content/docs/reference/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-dev: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.

propose

NPX Install

Tags

SKILL.md Content

propose

When to use

When NOT to use

Arguments

Process

Common mistakes

Tooling