wiki-roadmaplisted
Install: claude install-skill paulnsorensen/hallouminate
# wiki-roadmap — author milknado-importable roadmaps
The wiki owns roadmap and goal **intent**; milknado owns task **execution
state**. This skill writes the intent side in exactly the shape
`milknado roadmap import <slug>` consumes, so a later milknado install loads
the roadmap as-is.
Templates ship in this pack at `templates/roadmap/` (from this skill's base
directory: `../../templates/roadmap/`): `index.md` for the roadmap, `goal.md`
for each goal. Their skeletons are inlined below in case only the skill file
was copied to your harness.
## Layout
```text
.hallouminate/wiki/roadmaps/<roadmap-slug>/
├── index.md # the roadmap node — title + created
├── <goal-a>.md # one file per goal; the stem is the goal slug
└── <goal-b>.md
```
## The format contract
What milknado's importer reads — get these right and everything else is prose
for humans:
| Element | Rule |
|---|---|
| Frontmatter block | Required on every file. Import stamps a missing `created` and errors when there is no `---` block to stamp into. |
| `created: <YYYY-MM-DD>` | Keys the deterministic identity (`wiki_ref = uuid5(roadmap/goal@created)`). Stamp once at authoring; never change it after import — a changed date is a brand-new node to milknado. |
| First `# H1` | Becomes the milknado node description. |
| `prereqs: [a, b]` | Goal slugs in the same roadmap that must land first (edges in the graph). Every slug must name a sibling `<slug>.md` or import fails. The wikilink form `down: ["[[a]]"]