| name | llp-create |
| description | Create a new LLP document with the next available number, the NNNN-slug.type.md filename convention, and a scaffolded metadata header — or extend an existing LLP when one already covers the topic. |
| source | ccheever/llp@v0.3.0 |
llp-create
Author one LLP in a corpus that already exists. Handles numbering, filename, and the metadata scaffold so the author can focus on content.
Invoke as /llp-create <title>, or bare and the skill asks.
Trigger
"Capture this decision" / "write an LLP for this" — during or after a design conversation.
Invariants
- MUST check for a covering document first:
Grep the **Systems:** and **Related:** headers across llp/ and propose extending an existing LLP over creating a new one when the topic is already covered.
- MUST derive the next number from the tree —
max(existing) + 1, zero-padded — scanning the whole llp/ tree including subdirectories and tombstones/. Numbers are never reused and never invented.
- MUST name the file
NNNN-slug.type.md with the lowercased type matching the header's **Type:**, and start every new LLP as Draft.
- MUST NOT overwrite an existing file — if the name collides, stop and ask.
- MUST NOT silently pick a document type when the choice is ambiguous — propose one and confirm.
Workflow
Recipe (advisory) — next number: ls llp | grep -oE '^[0-9]{4}' | sort -n | tail -1 (+1); for nested trees glob llp/**/[0-9]*.md and exclude reviews/. Slug: lowercase, non-alphanumerics → -, collapse repeats, keep it under ~6 words. Type cues: proposal → rfc; requirements → spec; settled choice → decision; steps → plan; teaching → explainer; always/never → principles; how-to → guide; bug → issue; findings → research. Scaffold sections: Summary · Motivation · Design · Open questions (Decisions use Context/Options/Decision/Consequences; Research uses Findings/Confidence).
Artifact
A new Draft LLP with a complete metadata header (Type, Status, Systems, Author, Date; Related: where relevant) — plus an offer to draft the body from the current conversation. Confirm the assigned number and path back to the user.
Hand-offs
- No corpus to add the document to →
llp-adopt.
- The document is foundational or contentious →
llp-review, scaled to stakes (LLP 0005).