---
name: Transform
desc: The concept and review neighborhood for movement between Sirno forms.
category:
  - concept
belongs:
  - form
prerequisite:
  - sirno-lake
  - repo
---

A *transform* names a kind of work between Sirno *forms*.

Sirno uses two *transform* names:
`actualize` and `internalize`.
They form the review neighborhood for work across the `lake` and `repo` polarity.

Their direct names are also useful:
`lake-to-repo` and `repo-to-lake`.

The *transforms* are vocabulary for humans, LLMs, skills, CLI interfaces, and MCP tools.
They describe coherent work without requiring every *transform* to be a one-shot command.

The *transform* names make design work easier to request and review.
Instead of saying "update the code, README, or generated documents from the lake",
a user can ask to actualize the *lake* into the *repository*.
Instead of saying "move this repository fact into the canonical design source",
a user can ask to internalize the *repository* into the *lake*.

The polarity is simple.
The *lake* is canonical.
The *repository* is material:
source code, tests, configuration, generated files, README files,
design documents outside the *lake*, and other inspectable artifacts.
Actualization gives those materials shape from the *lake*.
Internalization lets those materials teach the *lake* what durable design knowledge they expose.

A reviewer who touches one direction should visit the other direction through this entry.
The round trip matters because repo material may reveal that the *lake* needs sharper names,
and a sharper *lake* should make later repo material easier to regenerate.

This vocabulary also helps skills stay focused.
An actualization skill should inspect *entries* before editing repository material.
An internalization skill should turn repository material into durable *entries*,
metadata, artifacts, or witness expectations.

---

> **Sirno generated links begin. Do not edit this section.**

- belongs (to):
  - [form](form.md)
- belongs (from):
  - [actualize](actualize.md)
  - [internalize](internalize.md)

> **Sirno generated links end.**
