diff --git a/conductor/product-guidelines.md b/conductor/product-guidelines.md index ab615a21..c717e49f 100644 --- a/conductor/product-guidelines.md +++ b/conductor/product-guidelines.md @@ -66,16 +66,7 @@ The canonical home (with code examples, the 5 patterns, the audit-script enforce ## Data Structure Conventions -The codebase follows the "names for shapes" pattern: every `dict[str, Any]` -or `list[dict[...]]` should use a `TypeAlias` from `src/type_aliases.py`. -The core aliases (`Metadata`, `CommsLogEntry`, `CommsLog`, `HistoryMessage`, -`History`, `FileItem`, `FileItems`, `ToolDefinition`, `ToolCall`, -`CommsLogCallback`) plus the extended per-aggregate dataclasses -(`SessionInsights`, `DiscussionSettings`, `CustomSlice`, `MMAUsageStats`, -`ProviderPayload`, `UIPanelConfig`, `PathInfo`, `FileItemsDiff`, plus -the `JsonPrimitive`/`JsonValue` pair) cover the common patterns. The canonical -reference is in -[`conductor/code_styleguides/type_aliases.md`](code_styleguides/type_aliases.md). +The canonical home (with the 10 `TypeAlias` definitions + 11 per-aggregate dataclasses + the 5-pattern decision tree) is [`conductor/code_styleguides/type_aliases.md`](code_styleguides/type_aliases.md). This section is a 1-line pointer to that canonical home. **Field-level schema information is in `docs/type_registry/`.** This is auto-generated by `scripts/generate_type_registry.py` (runs as part of