unic / unic/unic-agents-plugins
bug(unic-archon-dlc): the design contract's reads lost four findings between two runs at identical measurement density
Nobody has claimed this yet.
- Dominant language
- JavaScript
- Stars
- 1
- Forks
- 0
- Avg merge
- 16h 43m
- Merged PRs (30d)
- 19
Description
What the two runs' contracts show
Same component, same command version, six days apart. Measurement density is identical — 28 node ids, 15 hex values, 4 pixel figures, 92 bullets in both card contracts. Run 2 lost no facts.
It lost four findings.
| Run 1's card contract records | Run 2 |
|---|---|
a badge text node renders typo/p-tiny with an 11px fallback while the token resolves to 12 |
absent |
the hover badge text node carries a raw hex #01013b typed beside the token-bound colour |
absent |
a font style reads Inter:Regular where siblings read Inter:regular |
absent |
the card's width is a drawn 356 with min-width: 356 and no binding behind either number |
absent |
Run 1 scoped its four to "inside the has badge cells" — it read into the nested instance layers. Run 2 recorded those same cells and did not read into them. All four have since been filed as design questions in the Consumer's tracker.
Both contracts name the same reads in their prose, and figma.md does list get_design_context. So this is not a missing entry in the read table. It is a missing depth.
The uncomfortable half
The one case where run 2 explains itself is the animation annotation. Its contract says:
"Read 2026-08-26 and recorded in
docs/agents/figma.md; not re-measured on 2026-08-31. None of this run's reads surfaced an annotation."
The document existing is why the observation was not repeated. That is the cost side of writing facts down, and it is the only self-explained instance — the other four are unexplained.
The open question
Should the contract's read list require a nested-layer pass explicitly, and how does a run know it has read deeply enough rather than merely read the named surfaces?
And separately: when a fact is already recorded in a Consumer document, should a run re-measure it or cite it? Run 2 cited, said so honestly, and lost the measurement.
Full evidence: docs/research/2026-08-31-dlc-run-2-findings.md.
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
Start with docs/research/2026-08-31-dlc-run-2-findings.md and compare its evidence with docs/agents/figma.md, especially the get_design_context read entry. Trace how the contract handles nested instance layers and previously recorded facts. Done means the required read depth and the re-measure-versus-cite behavior are explicitly resolved and documented.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- figma
- Domain
- documentation, tooling
- Issue type
- Bug
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Active
- Clarity
- Needs clarification
- Newbie friendliness
- 35/100