jackin-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-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.

jackin-propose

NPX Install

Tags

SKILL.md Content

jackin-propose

When to use

When NOT to use

Arguments

Process

Common mistakes

Tooling