Skip to content

Commit 46984fb

Browse files
committed
fix(skills): valid YAML enums and stored note_type casing in schema examples
Two Codex review fixes in memory-onboarding's schema guide: - Quote enum field values in the Picoschema YAML example — an unquoted flow list with a trailing description is not valid YAML, so copying the block produced schema notes that fail to parse. - Use the stored lower-case note type in schema_validate/schema_diff/ schema_infer examples: the live API matches Entity.note_type exactly, so note_type="Task" would find none of the seed notes written with note_type="task". Signed-off-by: Cody Faust <cody@luminarysol.com>
1 parent b53b771 commit 46984fb

1 file changed

Lines changed: 5 additions & 5 deletions

File tree

skills/memory-onboarding/references/schema-guide.md

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -68,9 +68,9 @@ Schemas are notes (conventionally in a `Schemas/` folder) whose frontmatter meta
6868

6969
```yaml
7070
schema:
71-
status(enum): [open, in-progress, blocked, done], current state
71+
status(enum): "[open, in-progress, blocked, done], current state"
7272
due?: string, due date if any (Month D, YYYY)
73-
priority?(enum): [low, medium, high], urgency
73+
priority?(enum): "[low, medium, high], urgency"
7474
project?: Project, parent project note
7575
steps?(array): string, ordered sub-steps
7676
```
@@ -120,9 +120,9 @@ Key points:
120120

121121
## Validation & drift
122122

123-
- `schema_validate(note_type="Task")` — check all notes of a type; also works on a single note. Reports missing required fields, unknown fields, type mismatches, invalid enum values.
124-
- `schema_diff(note_type="Task")` — finds drift: fields notes use that the schema doesn't define (candidates to add as optional), and schema fields nobody uses (candidates to drop).
125-
- `schema_infer(note_type="Task")` — when notes of a type already exist without a schema, infer one from their actual structure instead of designing from scratch.
123+
- `schema_validate(note_type="task")` — check all notes of a type; also works on a single note. Reports missing required fields, unknown fields, type mismatches, invalid enum values.
124+
- `schema_diff(note_type="task")` — finds drift: fields notes use that the schema doesn't define (candidates to add as optional), and schema fields nobody uses (candidates to drop).
125+
- `schema_infer(note_type="task")` — when notes of a type already exist without a schema, infer one from their actual structure instead of designing from scratch.
126126

127127
Evolution loop: `schema_diff` → edit the schema note (append changelog row, bump version if breaking) → `schema_validate` → fix outliers. Suggest the user run this monthly-ish once the system has real volume.
128128

0 commit comments

Comments
 (0)