New Project — Create a Project

Purpose

Create a new project with a standardized scaffold and register it in BRAIN.md. One call does everything — no manual steps.

Base path: {{BRAIN_ROOT}} (set by install.sh).

Steps

Step 1: Ask for project data

Gather (from the call or by asking):

1. Project name — short, descriptive (becomes the folder name)
2. Category — a subfolder under projects/ (e.g. personal, work; free to choose)
3. Goal — one sentence: what should this project achieve?
4. First next step — concrete and immediately actionable

Derive the folder name: lowercase, spaces → hyphens, transliterate non-ASCII (ä→ae, ö→oe, ü→ue, ß→ss).

Step 2: Determine the path

{{BRAIN_ROOT}}/projects/<category>/<folder-name>/

Step 3: Create the folder structure

mkdir -p [path]/notes

Step 4: Create KONTEXT.md

This is the cold context — loaded on demand only, never on session start.

# [Project name]

**Goal:** [goal from step 1]

---

## Status

Active — started YYYY-MM-DD

## Next steps

- [first next step]

## Notes

*(empty)*

Get the date via Bash: date "+%Y-%m-%d"

Step 5: Create MEMORY.md

# MEMORY — [project-name]

Conversation context, decision logic, discarded options.
Extended via /memo — chronological, never overwritten.

---

Step 6: Update BRAIN.md

Read {{BRAIN_ROOT}}/BRAIN.md. Insert a new entry under "Active":

- **[Project name]** — Started; next step: [first next step] · [FOCUS](projects/<category>/<name>/FOCUS.md) · [KONTEXT](projects/<category>/<name>/KONTEXT.md)

Set the Last updated: line to today.

Step 7: Confirm

Project "[Name]" created at projects/<category>/<folder-name>/
BRAIN.md updated.

Special case: code project

If the user mentions it's a code project (Python, scripts, etc.): additionally create input/ and output/, and note it in KONTEXT.md.

Known pitfalls

• Folder name never with spaces or non-ASCII — always normalize
• Always get the date via Bash, not from the conversation
• The relative path in BRAIN.md is computed from {{BRAIN_ROOT}}/ → projects/<category>/<name>/