Schema Design Phase

Use Skill("ct") for ct CLI documentation when running commands.

Schema Design Phase

Goal

Create schemas.tsx with all data types and Input/​Output types BEFORE any pattern code.

Read First

• docs/​common/​concepts/​types-and-schemas/​default.md
• docs/​common/​concepts/​types-and-schemas/​writable.md
• docs/​common/​concepts/​pattern.md (Input/​Output section)

Rules

1. ALWAYS use pattern<Input, Output>() - Never use single-type pattern<State>(). Single-type patterns cannot be tested via .send().
2. Every editable field needs Writable<> in Input type (for write access)
3. Output types never use Writable<> - they reflect returned data shape
4. Fields that could be undefined initially: use Default<T, value>
5. Actions in Output type: Stream<T> (enables testing and linking)
6. Sub-patterns need [NAME]: string and [UI]: VNode in Output type

Template

import { Default, NAME, Stream, UI, VNode, Writable } from "commontools";

// ============ DATA TYPES ============
export interface Item {
  name: Default<string, "">;
  done: Default<boolean, false>;
}

// ============ PATTERN INPUT/​OUTPUT ============
export interface ItemInput {
  item: Writable<Item>;  // Writable in Input = pattern will modify
}

export interface ItemOutput {
  [NAME]: string;        // Required for sub-patterns
  [UI]: VNode;           // Required for sub-patterns
  item: Item;            // No Writable in Output
  toggle: Stream<void>;  // Actions as Stream<T>
}

Done When

• All data types defined with correct Writable/​Default wrapping
• All Input/​Output types defined for each sub-pattern
• No TypeScript errors: deno task ct check schemas.tsx --no-run