draft-add-dimension

name	draft-add-dimension
description	Scaffold a new context dimension. Creates context/<name>/index.md with standard frontmatter and context/<name>/log/. Works on brand-new dimensions and on existing folders that are missing an index.md (orphaned dimensions).

/draft:add-dimension — Scaffold a Context Dimension

This command initializes a new context dimension so Draft can load it every session.

---

Usage

/draft:add-dimension <name>

Where <name> is the dimension to create or scaffold (e.g. research, decisions, legal).

---

Steps

1. Validate the name

The dimension name must be:

• Lowercase letters, numbers, hyphens only
• No spaces, slashes, or dots

If invalid, tell the user and stop.

2. Check current state

python3 -c "
import os
from pathlib import Path
ws = os.environ.get('DRAFT_WORKSPACE', '')
ctx = Path(ws) / 'context' / '<name>'
has_dir = ctx.is_dir()
has_index = (ctx / 'index.md').exists()
print('dir=' + str(has_dir))
print('index=' + str(has_index))
"

Three cases:

• Folder + index.md exist → "Dimension <name> is already initialized. Run /draft:setup re-run to refresh its content." Stop.
• Folder exists, no index.md → scaffold mode: create index.md + log/ without touching existing files. Tell the user: "Scaffolding <name>/ — folder already exists, just adding the missing index."
• Folder does not exist → create folder + index.md + log/

3. Write context/<name>/index.md

Use @draft-learner to write the file with this exact frontmatter:

---
name: <name>
description: >
  No information recorded yet.
last_updated: ""
source: ""
---

4. Create context/<name>/log/

Create the log directory (empty). This is where the daemon writes change history entries.

mkdir -p "$DRAFT_WORKSPACE/context/<name>/log"

5. Confirm and optionally seed

Tell the user:

"Dimension <name> is ready. Draft will load it every session starting now. Want to add some initial context? (Tell me what <name> tracks and I'll write it.)"

If yes: ask one question — "What does this dimension track? Give me a few sentences." — then call @draft-learner to update the description field in context/<name>/index.md.

If no: done.

---

Rules

• Never overwrite an existing index.md — if one already exists, stop with an informative message
• log/ creation is always safe (idempotent)
• One question max when seeding initial content — do not run a full interview