Traceable sources
Find the origin of design observations and rules.
AI-assisted engineering · Personal project
Give coding agents a memory for design.
I created Designome to give coding agents a lasting design reference. This plugin for Codex and Claude Code analyzes screenshots, structures their rules into a “Design DNA,” and integrates them into the project to guide subsequent interface work.
Evidence taxonomy
Directly visible in supplied evidence.
Derived from visible patterns and relationships.
A design decision offered for explicit acceptance.
Not provable from static screenshots.
A coding agent can produce a convincing first screen from a screenshot, then drift when asked to build another page. Spacing changes, components lose their character, and the hierarchy becomes harder to read.
I designed Designome around this problem: make design decisions explicit and reusable so they can guide work beyond the initial reference.
Designome distinguishes what is visible in a screenshot, what can be inferred, and what is a proposal. Each observation retains its source so the resulting rules can be understood and discussed.
This distinction matters particularly for behavior: an image does not show how a menu opens, how keyboard navigation works, or how a page adapts to mobile. These aspects still need to be checked in a working interface.
The analysis brings typography, colors, spacing, composition, and component rules together in a Design DNA. Once the user accepts it, Designome installs structured documentation that the agent can consult during future tasks.
I separated visual interpretation, handled by the agent, from file operations, handled by the program. Requests and DNA are validated before use, and references can be assigned to a specific need, such as colors or charts.
The workflow saves progress through analysis, DNA acceptance, installation, and audit. It can resume after an interruption while identifying the steps that need input from the user or the agent.
Installation checks the project before writing, records changes, and supports rollback. It separates files managed by Designome from user customizations so the design can continue to evolve.
The fidelity contract identifies the visual qualities to preserve and the criteria to check for each component. It gives the agent concrete guidance for applying the design and evaluating the result.
The audit distinguishes correct rule installation, measurable layout, visual fidelity, and browser behavior. This separation helps locate gaps and guide corrections.
Reconstruction experiments showed that table density, KPI anatomy, and content meaning can get lost despite a polished finish. Detailed documentation also needs to be interpreted and applied correctly.
These observations guide the next steps: refine component rules and check their resilience to content changes. Designome remains in development; documented evaluations help explain its limits and guide improvements.
+ Engineering principles
Find the origin of design observations and rules.
Distinguish what is observed, inferred, proposed, or still unknown.
Verify changes and preserve project customizations.
Give future tasks a shared reference to consult.