format

You already wrote something — a brain-dump, rough notes, half-formed prose. format moves it into shape without adding to it.

It works on a collection blueprint, or on a free-form top-level doc you added. The latter has no shape to match, so it’s organised into the house style rather than checked against one.

The one rule: preserve, don’t pad

A formatting pass that quietly adds content is worse than none

The user stops trusting that the words on the page are theirs. That single risk governs everything this skill does.

Keep your wording. It relocates sentences into the section they belong in and tidies grammar and markdown. It does not rewrite your voice or inflate three words into a paragraph.

Add nothing of substance. No invented behaviors, intent, decisions, scope, or acceptance criteria. The product decisions that aren’t on the page are not the agent’s to make.

Surface gaps; don’t fill them. A section with nothing under it gets omitted — the shape is a scaffold, not a checklist. For one that clearly should have content, most often the non-goals section, it keeps the heading with a short <!-- TODO: … --> and calls it out. An honest hole beats invented content.

Mark anything inferred. If it guesses a title, or files a loose sentence under a heading it picked, it flags that so you can confirm or correct.

What counts as formatting

More than moving paragraphs. Within and beneath the shape’s sections it will:

• Break rich content out of a single line — a data model into a table, a sequence into a numbered list.
• Add #### sub-headings inside a section that has internal structure.
• Keep checkable statements short, pointing at a table or sub-section for the detail rather than cramming it onto one line.
• Turn references to other blueprints into markdown links, in the framework’s naming convention. Converting a name into a link is formatting rather than adding content, so it’s squarely in scope.

Not this

Developing new content is eidos. Thinking an idea through before anything is written is iterate. format is a moving-and-shaping pass within a single file.