Skip to content

Commit ccd6949

Browse files
ijac13claude
authored andcommitted
doc(#99): commission scaffolding mentions folder-per-entity naming
Extend the File Naming section so workflows commissioned after this change know both forms are first-class: flat `{slug}.md` (default) or folder `{slug}/index.md` (when the entity produces per-stage artifacts alongside the tracker). Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
1 parent 7d29fb4 commit ccd6949

1 file changed

Lines changed: 6 additions & 1 deletion

File tree

skills/commission/SKILL.md

Lines changed: 6 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -235,7 +235,12 @@ stages:
235235

236236
## File Naming
237237

238-
Each {entity_label} is a markdown file named `{slug}.md` — lowercase, hyphens, no spaces. Example: `my-feature-idea.md`.
238+
Each {entity_label} lives as either:
239+
240+
- a flat markdown file `{slug}.md` (default — use this unless the entity produces many artifacts), or
241+
- a folder `{slug}/` containing `index.md` as the canonical entity file, when the {entity_label} produces per-stage artifacts (draft versions, transcripts, outputs) that belong alongside the tracker.
242+
243+
Slugs are lowercase, hyphens, no spaces. Example: `my-feature-idea.md` or `my-feature-idea/index.md`. The status scanner recognizes both forms; `--set` and `--archive` resolve the slug either way, and folder entities archive as a whole folder into `_archive/{slug}/`.
239244

240245
## Schema
241246

0 commit comments

Comments
 (0)