Parent epic: #768 — Documentation epic
Base branch: theme-elementary-v2. Cover its functionality and subsequent changes based on it. Verify against the latest relevant v2 implementation and record the tested commit in the documentation PR.
Problem and scope
Developers cannot easily distinguish project acquisition from initialization or predict what cleanup changes. Create docs/initialization.md around the decisions and results of init.
Proposed structure
- Before init: dependency prerequisites, intended theme directory, and clean-tree requirement.
- Entry points: acquisition via Composer/clone, CLI init, AI /init, and whether /setup applies to this skeleton.
- What the prompts mean: name and derived identity, example selection, optional features, and cleanup.
- What changes: a compact table of identity fields, affected files, retained/removed content, and generated configuration.
- Review the result: verify identity, retained examples, and cleanup output; suggest a baseline commit before adding features.
- Change something later: supported identity/feature management versus one-time example removal, based on verified behavior.
- Troubleshooting: failed install, incomplete init, or missing retained functionality; give a check and recovery action.
Boundaries
This page owns skeleton-specific initialization and toggle commands. Link to the tooling reference for exhaustive engine flags and to the feature catalogue for descriptions. Explain any differences between CLI and AI behavior without duplicating AI skill instructions.
Verify cleanup behavior before documenting it. File separate implementation dependencies for broken cleanup or removed AI files with remaining references; do not make script repair an implicit documentation deliverable.
Acceptance criteria
Parent epic: #768 — Documentation epic
Base branch:
theme-elementary-v2. Cover its functionality and subsequent changes based on it. Verify against the latest relevant v2 implementation and record the tested commit in the documentation PR.Problem and scope
Developers cannot easily distinguish project acquisition from initialization or predict what cleanup changes. Create
docs/initialization.mdaround the decisions and results of init.Proposed structure
Boundaries
This page owns skeleton-specific initialization and toggle commands. Link to the tooling reference for exhaustive engine flags and to the feature catalogue for descriptions. Explain any differences between CLI and AI behavior without duplicating AI skill instructions.
Verify cleanup behavior before documenting it. File separate implementation dependencies for broken cleanup or removed AI files with remaining references; do not make script repair an implicit documentation deliverable.
Acceptance criteria