unic / unic/unic-agents-plugins

feat(unic-archon-dlc): an annotation must reach a criterion or be refused

Open
#444 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

app:unic-archon-dlc feature needs-specs p2
Dominant language
JavaScript
Stars
1
Forks
0
Avg merge
16h 43m
Merged PRs (30d)
19

Description

The worked example

The card's variant=default, state=default cell (189:5267) carries a fade animation annotation. docs/agents/figma.md records it. Both runs' contracts record it. Neither run implemented it. No .tsx or .css in either build carries a transition, an animation or a keyframe.

Nothing in the chain turns a recorded annotation into a criterion, a ticket, or code. It is written down and then dropped.

And nothing says what fade means, which is why neither run could act on it even in principle. That half is now a design question in the Consumer's tracker.

The general shape

A fact reaching a contract is not a fact reaching anything.

The same applies to arrangement: both contracts record the card's layout with y-coordinates — slot at 16, text frame at 104 — and the badge and icon position was wrong in both runs, with no check comparing the two.

The open question

When /specs reads something it cannot turn into a code shape, what should happen? Candidates, none decided:

  • Refuse it — a run stops and asks what the annotation specifies, the way it stops for a missing focus value.
  • Carry it forward as an open item — the contract records it as owed, and /tickets must give it a criterion or explicitly waive it.
  • Route it to the design tracker — the same path the unbacked-literal finding takes.

The refuse option has precedent in the command already. The carry-forward option needs a reader, and this repository has just learned what happens to records with no reader.

Full evidence: docs/research/2026-08-31-dlc-run-2-findings.md.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with docs/research/2026-08-31-dlc-run-2-findings.md and docs/agents/figma.md, then inspect the /specs and /tickets paths and both run contracts. Trace how the fade annotation and recorded coordinates are handled, and define the missing behavior and acceptance criteria before implementation. Done means unsupported annotations and arrangement facts no longer disappear without an explicit outcome.

Written by the indexing model from the issue text.

Assessment

Tech stack
javascript, typescript
Domain
tooling
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Active
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.