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