form

draft 1.0.0
  status draft
  title form — sensorimotor layer
  date 2026-05-24
  license Open

---

spec form

  section purpose
    title Purpose
    level 1

    prose
      value
        form is the sensorimotor layer for any interface. One spec,
        every modality — visual, auditory, tactile, manual. A button
        is a button on a touchscreen, a robot arm panel, or a
        submarine dashboard. The spec doesn't know or care what
        renders it.

    requirement F-001
      level MUST
      value
        Channel-based. Every interface property belongs to a channel
        — visual, auditory, tactile, manual. Modality is first-class,
        not an afterthought.

    requirement F-002
      level MUST
      value
        Cognitive-cycle MUST. Every state transition must produce a
        perceivable response in at least one channel. Silence is
        never a valid response.

    requirement F-003
      level MUST
      value
        Medium-agnostic. The same form document must be projectable
        onto any channel without modification to its semantic
        content. Channels are projections, not authoring targets.

    requirement F-004
      level SHOULD
      value
        Cross-channel signals. Channels SHOULD be able to share
        signals. A haptic pulse and a sound MAY be the same semantic
        event, specified once, bound to many modalities.

  section concepts
    title Core concepts
    level 1

    prose
      value
        A form declares roles (who is operating the surface), input
        streams (how their intent reaches the system), attention
        concepts (named regions of meaning), affordances (named
        actions), and state dimensions (named modes the surface can
        be in).