create-doc

Create a new documentation file in .chalk/docs/.

Workflow

1. Parse the request — Identify the target vertical and topic from $ARGUMENTS.
2. Check existing docs — Read filenames in the target directory to find the highest numbered file. The next doc number is highest + 1.
3. Draft the doc — Write substantive content, not stubs. Use the structure and tone guidelines below.
4. Write the file — Save to .chalk/docs/<vertical>/<number>_<slug>.md.
5. Confirm — Tell the user the doc was created with its path and a brief summary.

Verticals

If the user specifies a vertical ("engineering doc about..."), use it. If ambiguous, infer from content: technical architecture -> engineering, product strategy -> product, agent context -> ai.

Filename Convention

<number>_<snake_case_slug>.md

• Number is sequential within the vertical directory (profile docs are always 0_)
• Slug is a short snake_case summary

Doc File Structure

# <Doc Title>

Last updated: <YYYY-MM-DD> (<brief change note>)

## <First Section>

Content...

## <Next Section>

Content...

• No YAML frontmatter (docs are plain markdown)
• First # Heading is the title
• "Last updated" line immediately after the title
• Use ## Heading for sections
• All GFM features supported: tables, checkboxes, strikethrough, code blocks, Mermaid diagrams

Content Guidelines