Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
30 KiB
Interview project audit (read-only)
Source: PaperCraft 0.6.1, project Interview (fileName confirmed). Date 2026-10-23. Only read tools used. Screenshots in specs/interview-cleanup/audit/. Full old->new colour map: specs/interview-cleanup/variable-mapping.csv (161 rows).
Page ids: Design System 64e1d4aaf56fe6a4, Admin 96e0de09bfd69d1e, Candidate 943a1809e1077b81. Node id prefixes: 64e1d4:, 96e0de:, 943a18:.
0. Headline numbers
| Design System | Admin | Candidate | |
|---|---|---|---|
| nodes | 4358 | 7699 | 5886 |
| top-level frames | 232 (211 components, 6 sections, 15 label stubs) | 236 (232 components, 4 sections) | 266 (262 components, 4 sections) |
| main components | 211 | 232 (211 copies + 21 local) | 262 (211 copies + 51 local) |
| components with 0 instances | 15 | 171 | 195 |
| real screens | n/a | 39 | 40 |
| lint (whole page): contrast / hard-coded / layer-name / spacing / touch / type | 128 / 11 / 7 / 57 / 16 / 42 | 217 / 49 / 9 / 102 / 39 / 105 | 261 / 19 / 47 / 170 / 24 / 152 |
| lint (screens only) | n/a | 86 / 35 / 0 / 37 / 22 / 67 | 17 / 8 / 0 / 0 / 0 / 24 |
Reading: the "236 artboards" are 98 percent main components parked as top-level frames. Real screens: 4 sections per page. Most lint noise sits in the component copies (Candidate-local IDE components: 244 contrast, 170 spacing, 47 layer-name), not in screens. Admin Entry Approval v3 and Candidate Join v3 are clean (0 lint issues, mostly instances) and are the quality reference.
Annotations: get_annotations returns [], get_feedback count 0. Only business notes are Route text labels on Admin screen slots (e.g. /sessions (create failed)), 27 loose Text labels on DS, 12 on Candidate.
lint_design truncates its issue list at 200; counts above come from byRule totals, per section for screens.
1. Work package A: Design system (do first)
A1. Variables, collection Colors (161 vars, 1 mode Default)
Findings:
- 0 groups (flat
color-*), 0 descriptions, 0 aliases, 1 mode. Every name carries a redundantcolor-prefix. - 38 hex values are shared by 2 to 4 variables (44 redundant vars). Examples:
color-ide-card=color-ide-code-pane=color-ide-input#161616;color-syntax-*(7) vscolor-tok-*(6) identical values;color-wb-*(10) vscolor-ide-wb-*(5) identical;color-brand-primary=color-info=color-text-link#1677ff;color-bg-elevated=color-text-inverse#ffffff;color-cam-hint=color-cam-label=color-login-card-head=color-login-desc#ffffff99. - 114 near-duplicate pairs (RGB distance <= 12, same alpha). Worst:
ide-card-bordervside-panel(1.0),ide-chipvside-toolbar(1.0),brand-secondaryvswb-blue(1.4),button-dark/code-bg/ide-rail(1.7),diagram-bg/login-bg/ide-preview(2.0), seven near-black IDE surfaces#161616 #181818 #1a1a1a #1f1f1f(3.5 to 8.7). - Family sizes:
ide46,tag18 (6 hues x bg/bd/fg),login12,wb10,sidebar8,syntax7,syscheck6,text6,tok6,avatar5. Domain families are 55 percent of the set; the core palette is about 30. - Contrast defect at the root:
color-brand-primary #1677ffwith white text is 4.1:1 (needs 4.5). It causes most "contrast" errors on buttons and sidebar active item.color-brand-action #0958d9passes; use it (or darken primary) for filled buttons and text-on-white links. Also failing:#8c8c8con white 3.4 (placeholders),#5a5a5aon#1e1e1e2.4 and#484848on#1616162.0 (IDE gutter/labels),#888on#2525264.3, white on#bfbfbf1.8 (disabled button). - Binding gap (matters for A and for B/C): in screens, text
coloris hard-coded on every node (Admin 692 local text nodes, Candidate 348), borders hard-coded (317 / 94). Onlybackground-coloris bound (645 / 271). Of 1030 / 458 hard-coded colours, 1019 / 442 equal an existing variable exactly. Exceptions kept on purpose: Candidate Google logo colours (#4285f4 #34a853 #fbbc05 #ea4335 #f25022 #7fba00 #00a4ef #ffb900, 2 nodes each).
Target structure and exact names:
- Collection
Colors, modeLight(renameDefault). Add modeDarkonly if the product wants a dark theme; sidebar, IDE, whiteboard, auth surfaces are fixed-dark domain sets, not modes. Do not add a mode without defining every variable in it. - Groups with
/(exact, Figma style, nocolor-prefix):brand/{primary,pressed,hover,secondary,focus-ring},text/{primary,secondary,disabled,placeholder,inverse,link},bg/{layout,surface,subtle,selected,overlay,tooltip},border/{default,subtle,strong,hover},status/{success,success-text,warning,warning-text,error,info,star,score-poor,score-warn},tag/{blue,cyan,gold,green,purple,red}/{bg,border,text},avatar/{indigo,orange,pink,purple,teal},sidebar/{bg,border,hover,text,text-muted,text-faint,badge,tag-bg},ide/*(31 after merge),syntax/*(7),whiteboard/*(9),diff/{added,removed},code/{bg,fg},auth/*(12, fromlogin-*),camera/{label,ring},syscheck/*(6),hero/{chip,text},button/dark,control/switch-off. - Result: 161 -> 136 variables (25 merged). Full mapping in
variable-mapping.csv. Samples:
| old | new | note |
|---|---|---|
| color-text-primary | text/primary | #000000e0 |
| color-bg-elevated | bg/surface | same hex as text/inverse; keep both, role differs |
| color-bg-sider | bg/subtle | |
| color-brand-action | brand/pressed | use for filled buttons (contrast) |
| color-button-primary-hover | brand/hover | |
| color-info | status/info | alias of brand/primary if aliases work, else keep |
| color-tag-blue-bd | tag/blue/border | 18 tag vars |
| color-login-* | auth/* | 12 |
| color-tok-* | syntax/* | merge into color-syntax-* (6 identical) |
| color-ide-wb-* / color-wb-* | whiteboard/* | merge, 5 identical |
| color-ide-fail / color-ide-pass | diff/removed / diff/added | merge, same hex |
| color-cam-hint | camera/label | merge with cam-label |
| color-diagram-bg | ide/preview | merge, #0d1117 |
- Aliases: not exposed by
get_variables(no alias field). Agent A tests once on a throwaway variable; if unsupported, merge duplicates and repoint instead. - Renaming:
set_variableswrites by name, so rename = create new name with same value, repoint everyvar(--old)(usefind_nodes+update_styles), then delete old. Never delete before repointing. Repointing is project-wide: coordinate so B and C start after A is finished.
A2. Collection Tokens (32 vars) -> split into number collections
Findings:
- Mixed types: 26
number, 7string(shadow-sm/md/lg,z-base/dropdown/modal/toast). Shadows are unsupported in PaperCraft (reported asignoredStyles): delete 3. Z-index strings: make number or delete (no z-index in canvas). - Duplicate values:
page-max-width-default=-lg=900,-md=-narrow=720,-wide=-xl=1100 (3 redundant). - Scale gaps: spacing has 4, 8, 16, 24, 32, 48 but no 12 (used constantly in
gap/padding);font-size-lg=18 is off the lint scale (12,14,16,20,24,32,40,48,64); no 32/40/48/64; no line-height tokens; radius has 4, 8, 12 only while screens use 99 (Admin 51x), 999 (Candidate 9x), 5, 6, 7, 32. - Tokens are substituted at write time (not live), so they only guide new work.
Target collections (all number, mode Default):
Spacing:space/1=4,space/2=8,space/3=12,space/4=16,space/6=24,space/8=32,space/12=48,space/16=64 (fromspacing-xs..xxl;xs->space/1,sm->space/2,md->space/4,lg->space/6,xl->space/8,xxl->space/12).Radius:radius/sm=4,radius/md=8,radius/lg=12,radius/xl=16,radius/pill=999.Typography:text/xs=12,text/sm=14,text/md=16,text/lg=20 (drop 18),text/xl=24,text/2xl=32,text/3xl=40,text/4xl=48 (old:font-size-xs..xxl;font-size-lg18 ->text/mdor 20, decide once). Addleading/*in px (16, 20, 24, 28, 32, 40).Layout:page/padding=24,page/padding-lg=48,page/max-width/{xs=480,sm=420,md=720,lg=900,xl=1100}; drop-default,-narrow,-wide.- Colour vs number groups: slash-grouped names collide with colour group
text/; to avoid confusion name typography tokensfont-size/*instead if the app lists collections together.
A3. Components (Design System page: 211)
Findings (counts from get_components):
- No group: 25 names (
Avatar,Card,Search Input,Donut,Spin,Loading Block,Empty State,Page Header,Admin Shell Header,Candidate Shell Header,Section Title,Pagination,Input,Input Number,Date Picker,Textarea,Select,Form Field,Modal,Drawer,Tooltip,Skeleton,Admin Sidebar,Candidate Sidebar,Link Field). Base variant is unnamed while siblings areGroup / Variant. - Two parallel systems:
Button / *(16: Primary, Default, Ghost, Danger, Dark x Small/Large + Notification Bell) heights 34/28/40 vsAnt Button / *(15: Primary, Default, Danger, Text, Text Danger x 3 sizes) heights 32/24/40. Same forTag(7)+Tag Dot(7) vsAnt Tag(5);Segmented(9) vsAnt Segmented(3);Data Table(5) vsAnt Table(2). Admin uses both (Ant Button / Primary16x,Button / Primary7x). - Combinatorial variants:
Segmented / 4 Options Active 1..4(9+3),Tabs / Bar 5 Large Active 1..5+Bar 3 Active 1..3(8),Score Dots / 0..5,Stars / 0..5,Stat / Blue..Orange Down(6, 208x132),Sparkline(6),Admin Sidebarx8 andCandidate Sidebarx3 (full 248x900, about 58 nodes each, one per active item, e.g.64e1d4:6906..7312,7370..7422). - Content baked into names:
Challenge Option / Two Sum On,... / URL shortener Off,... / JavaScript closures On(6),Timeline / Step 1..3,Syscheck Row,Tip Card / Read carefully. - Inconsistent naming: size as suffix word (
Primary Small,Input / Large Filled), size as number (Avatar / 30,/ 34,/ 36,/ 40),Empty / SimplevsEmpty State,Spin/Spin / Small/Spin / Large,Alert / Info With Icon,Input / FocusvsSearch Input / Focused,Tabs / Tab Active Large. - Overlap:
Page Header(64e1d4:6476) andAdmin Shell Header(6480) both 1192x102. - Suspect geometry:
Candidate Shell Header64e1d4:6489height 0 (6 instances on Candidate);Alert / *heights 456, 478, 522 for a one-line alert (6710,6716,6728) probably include a long text or a fixed height. - Missing states (interactive parts with only default/some states): Button (no hover, pressed, focus, disabled, loading), Tabs (no hover/disabled), Checkbox and Radio (no disabled, focus, indeterminate), Switch (no disabled), Select (no focus/error/disabled), Textarea (no focus/error/disabled), Input Number and Date Picker (no states), Pill (no hover/disabled), Data Table Row (no selected), Pagination (no current/disabled), Modal/Drawer (no variants), Tag (no closable).
- Not in DS at all: 21 Admin-local (
T Hdr,T Donut,T Spark,T Stat,Funnel Row,Funnel Row / Inverse,Challenge Usage Row,Review Item,Upcoming Row / *,Donut / Score Distribution,Legend Row,Criterion Row / Weight,Setting Row / On|Off,ATS Tile / *,Pipeline Row / Dark,Message / Success|Error,Admin Shell Header / With Action) and 51 Candidate-local (IDE Toolbar4,File Tree2,Editor Tabs2,Code Editor3,Console4,Problem Rail2,Diagram Toolbar4,Whiteboard Toolbar3,Theory Toolbar/Chip/Button/Answer13,Progress Tracker2,Check Item2,Tip Card3,Syscheck Row/Step6,Message / Success). Violates "add to the system first".T Hdr/Donut/Spark/Statare template stubs (names without group). - Copy drift:
Timeline / Step 3is 194 tall on DS, 216 on Admin and Candidate. DS-only components with 0 instances (15):Link Field,Entry Request,Device Preview,Challenge Option,Timelinefamilies (64e1d4:9635..9858). - Hoisted copies: Admin has 171 unused copies of 232, Candidate 195 of 262 (parked top-level frames, about 3000 nodes each). They are stale risk. Only 61 (Admin) and 67 (Candidate) components are placed at all.
Target component naming (rule Group / Variant or Group / Variant / Size; sizes SM|MD|LG):
- Merge Ant and plain sets into one:
Button / Primary,Button / Secondary(oldDefault/Ant Button / Default),Button / Ghost,Button / Text,Button / Danger,Button / Danger Text,Button / Dark, each with/ SMand/ LG(md is the unsuffixed);Button / Icon / Bell. Decide one height set (recommend MD 40, SM 32, LG 48; touch rule 44 on touch only; admin desktop 32-40 ok, state it). - Add
Button / <Variant> / Disabledand/ Loading;Input / Default|Focus|Error|Disabled|FilledxMD|LG; same forSelect,Textarea. - Rename mapping (sample):
Button / Primary Small->Button / Primary / SM;Ant Button / Text Danger Large->Button / Danger Text / LG;Avatar->Avatar / 32;Avatar / 30->Avatar / 30(keep numeric, all numeric);Search Input->Input / Search / Default,Search Input / Focused->Input / Search / Focus;Input / Large Filled->Input / Filled / LG;Empty / Simple->Empty / Simple,Empty State->Empty / Illustrated;Spin->Spin / MD;Candidate Shell Header->Header / Candidate;Admin Shell Header->Header / Admin,Admin Shell Header / With Action->Header / Admin / With Action;Page Headermerge intoHeader / Admin. - Replace 8
Admin Sidebar / X Active+ 3Candidate Sidebar / X ActivewithSidebar / Admin(shell, 248x900) composed ofNav item / DefaultandNav item / Activeinstances; or keep as text-override-free single component and document active item as an override. Cuts about 600 nodes. - Replace
Segmented / N Options Active KandTabs / Bar ...withSegmented / Item Active|DefaultandTab / Active|Default(+Tab / Disabled) building blocks; bars are screen-level compositions. - Replace content-baked
Challenge Option / <title> On|OffwithOption Row / On|Off;Timeline / Step NwithTimeline Step / Done|Current|Upcoming. - Replace colour-named
Stat / Blue..,Sparkline / Blue..byStat Card / Default+ accent override (6 -> 1) unless each colour is semantic. - Move the 72 local components (21 + 51) to the DS page under
Components / AdminandComponents / Candidate, namedGroup / Variant, then re-import (do not leave local mains on feature pages). - DS page: keep
Section / *boards, delete the 15Label / *stubs after re-layout, setSection / Components(1440x14512) to fit-content and re-pack with real heights.
A4. Order of operations inside A
- Variables rename/merge/restructure (A1) and token collections (A2).
- Fix
brand/primarycontrast or switch filled buttons tobrand/pressed; re-check both after A1. - Components rename, merge, add states (A3); fix
64e1d4:6489height 0 and the Alert heights. - Re-import changed components to Admin and Candidate only after B/C owners confirm, because import creates copies and instances lose overrides on re-import (see papercraft-design-system). Publish a list: old name -> new name for
swap_instance. - Write rename mapping files
specs/interview-cleanup/variable-mapping.csv(done) andspecs/interview-cleanup/component-mapping.csv(agent A produces).
2. Work package B: Admin page (after A)
Sections (all 1440 wide screens):
Section / Admin / Sessions96e0de:14778, 10 slots (list, filtered, loading, empty, new, new error, detail, in progress, loading, error), labelled byRoutetext.Section / Admin / Challenges96e0de:15868, 16 screens in unnamed wrappersScreens > Row 1..8(15871, 16182, 16508, 16827, 17344, 17965, 18464, 18873): list x5, new x4 (blank, template applied, validation errors, templates modal), edit x7 (MCQ, MCQ validation, theory, theory empty, SQL, fullstack, loading). Heights up to 1710, no route labels.Section / Admin / Live Session96e0de:19328, 6 screens (diagrams, whiteboard, whiteboard waiting, code, theory, theory waiting).Section / Admin Entry Approval v396e0de:23776, 7 blocks (Block /, 1440x930), 0 lint issues.- Not drawn but present as components: Dashboard, Question bank, Schedule, Configuration, Rubric (sidebar items exist,
Funnel Row,Upcoming Row,Setting Row,ATS Tile,Criterion Row,Pipeline Row,Donutcomponents have no screen on this page).
Findings:
- Flow structure and naming: 4 different conventions (
Screen Slot / ... > Screen /,Screens > Row N > Screen /,Block /,Section / Admin Entry Approval v3). v3 duplicates 3 flows already in Sessions:Block / New sessionvsScreen / New Session(96e0de:15304),Block / Sessions listvsScreen / Sessions List(14782),Block / Session, in progressvsScreen / Session Detail In Progress(15604). Decide canonical (v3 is cleaner) and archive the other. - Hard-coded colours on local nodes (screens, excluding instance internals): 1030 (692 text, 317 border, 21 background); 1019 equal a variable exactly. Top:
rgba(0,0,0,0.878)295 ->text/primary;#f0f0f0214 ->border/subtle;rgba(0,0,0,0.651)137 ->text/secondary;#d4d4d465 ->code/fg;#cf132261 ->status/error;#d9d9d952 ->border/default;#ffffff36;#88888832 ->ide/text-muted;#1677ff17 ->brand/primary;#dddddd12,#5a5a5a12,#1a1a1a8,#5555557. Examples:96e0de:14886,14898(text/primary),14874,14877(border/subtle),14895(brand/primary). No exact match:rgba(255,255,255,0.122)10x (sidebar divider,96e0de:16757,16971; nearestsidebar/border#ffffff12) andrgba(0,0,0,0.059)1x. Rule: text -> bind withcolor:var(); backgrounds -> bind; borders: check whether 0.6.1 acceptsvar()in border; if not, leave and list them. - Contrast (screens): 86 errors. Sessions 9 (
#1677ffon white 4.1 x8 e.g.96e0de:14895; on#e6f4ff3.715083); Challenges 33 (#8c8c8con white 3.4 x1016821; white on#bfbfbf1.8 x617027; white on#1677ff4.1 x417057); Live 44 (#888on#2525264.3 x1819402;#5a5a5aon#1e1e1e2.4 x1219771;#484848on#1616162.0 x319886;#555on#2525262.1 x219419). - Spacing off 4px grid (screens): 84 values.
padding 2px37 (tag/pill internals,96e0de:14888),padding 10px22 (17944),gap 6px11 (17584),padding 6px6,padding 1px4,padding 7px4. Lint: 37 warnings (Sessions 9, Challenges 28). - Type: off-scale sizes in text nodes:
13px66 (Live,96e0de:19393),15px1 (19587). Distribution of text sizes: 12px 219, 13px 66, 14px 353, 15px 1, 16px 14, 20px 11, 24px 27, 32px 1. Lint 67type-scale(info). Radii in use: 4x40, 5x5, 6x2, 8x110, 12x95, 32x2, 99x51 (pill should be 999 viaradius/pill). - Touch/size: 22
touch-targetwarnings, all in Challenges:Button / Add file32px x10 (96e0de:16800),Button / Add testx5 (16809),Button / Add questionx4 (17918). Decide: 32px accepted on dense desktop admin, or grow to 40. Document in DS. - Detached copies that should be instances (frames carrying a component name but not linked), Admin:
Card4:96e0de:15375, 15467, 15564, 15675->Card / Default(new name).Alert / Error1:15470->Alert / Error.Page Header6:23841, 23959, 24051, 24195, 24333, 24525->Header / Admin.Form Field3:23847, 23851, 23885->Form Field / Default;Input / Large1:23849.Button / Primary Large5:23893, 23987, 24215, 24337, 24455->Button / Primary / LG.Button / Default Large5:23895, 23983, 24219, 24453, 24552->Button / Secondary / LG.Button / Danger1:24554->Button / Danger. All 26 are in the v3 section. Replace withswap/new<x-paper-instance>and override text.
- Repeated local structure that should be components (not in DS): sessions and challenges tables built from locals (
Td36,Cell / Type/Cell / Status/Cell / Actions15 each,Data Table / Rowhas 0 instances on Admin); form fields in Challenge New/Edit repeated 10x (Field / Title,Field / Type,Field / Prompt,Field / Time limit,Field / Memory) instead ofForm Fieldinstances;Card Header44,Card Body48,Divider44,Card / Editor/Card / Prompt/Card / Type & details10 each (Card has no header/body slots);Markdown Editor10 with 11 toolbar icons x10 (text-b,text-italic,link,quotes...);Tag14 local;Toolbar15. Instance totals: 357 instances across 54 components on screens, 2277 local nodes. - Naming: vector icons named
Path202; table partsTd36; icon buttonsClose26,Remove25,Plus22;Row 1..8wrappers; v3 title text node namedText(96e0de:23777,24451); default-named Line/Arrow:96e0de:117..137(6),760; section name... v3. Lintlayer-name9 (all in component copies). - Content inconsistency: sidebar user footer is
Elena Vasquez / elena@netcracker.comon14782(email wraps to a second line and clips:elena@netcracker./com) butAdmin / admin@test.localon24133; table on14782has 1px cell borders and an empty header cell for Actions. - Missing annotations (business rules visible in the designs, none documented): session status lifecycle (Draft, Open, In progress, Submitted, Graded, Cancelled) and which actions each allows; entry approval (single-use link, re-entry request, decline dialog, revoke access); live view tabs and the waiting states; challenge types and per-type validation (MCQ, Theory, SQL, Fullstack), archived challenges, templates modal; time limit and memory limit units. Add
add_feedbacknotes (orNotetext blocks) on each section; create 6 to 8 notes. - Structure: sections sit at world x = 152072 and 156600 (Sessions, Live) and y = 0 / 12000 / 23000; page is not navigable as one board. Re-pack sections in a grid.
Admin tasks (assign to agent B):
- Re-bind colours (item 2) and fix contrast (item 3) after A1 lands.
- Replace the 26 detached frames with instances (item 7); replace local table, form, card structures with instances after A adds
Table / Row,Form Field,Cardslots (item 8). - Normalise names, wrappers, v3 duplicates (items 1, 9); fix sidebar content (item 10).
- Snap spacing and type (items 4, 5) using the new token scale; then delete unused component copies (171) and re-import only the used ones (61) above the page content.
- Add annotations (item 11). Lint target: 0 errors, 0 warnings on screens.
3. Work package C: Candidate page (after A, parallel with B)
Sections:
Section / Candidate Challenge943a18:8084, 15 blocks (Block /, 1440x930): code x5 (idle, running tests, passed, failed low time, submitted), diagrams, whiteboard x2, theory x2, loading, load error, MCQ form, MCQ submit error, text form + status badges. WrapperScreens943a18:8086. Mostly instances (code blocks: 7 local + 7 instances each).Section / Candidate Access943a18:16180, 7 blocks (login, login error, invite, invite loading, invite error, verify, verify error); wrapper943a18:16182.Section / Candidate Session943a18:16508, 9 blocks (session home x3, system check x3, review x3); wrapper943a18:16510.Section / Candidate Join v3943a18:20014, 9 blocks, 0 lint issues; 3 rows20016, 20191, 20354.
Findings:
- Duplicated flow:
Block / Inviteexists in Access (943a18:16411) and Join v3 (943a18:20017);Block / Waiting*,Approved,Declined,Link used/expiredoverlap with Access invite/verify states and with Session system check. Pick canonical (v3 clean), archive others. - Hard-coded colours on local nodes: 458 (348 text, 94 border, 16 background); 442 exact-match a variable. Top:
rgba(0,0,0,0.878)111 ->text/primary(943a18:9863,9879);rgba(0,0,0,0.651)107 ->text/secondary(8089,8312);#f0f0f039 ->border/subtle;#ffffff30;rgba(255,255,255,0.6)20 ->camera/label(16203,16210);#d9d9d914;#d4d4d411;#cf132210;#6666669 /#cccccc9 /#8888887 ->ide/text-faint,ide/text,ide/text-muted;#ffccc77 ->tag/red/border; whiteboard colours (#e0e0e0 #6ab0ff #ff9f43 #c792ea4 each ->whiteboard/*,943a18:9434..9452). Google logo colours stay literal (16 nodes). - Contrast (screens): 17 errors: white on
#1677ff4.1 x13 (login, buttons:943a18:16258,17038,16750,16190); white on white 1.0 x4 (943a18:16566, hidden or invisible text; check); Candidate-local component copies add 244 more (IDE greys on dark, same as Admin Live). - Type: off-scale sizes
13px11,15px2,19px2 (943a18:9670),22px4 (16765),26px1 (16555),30px4 (16243); lint 24 info. Text sizes: 12px 55, 13px 11, 14px 218, 16px 30, 20px 8, 24px 13, 30px 4. Radii: 4x24, 6x9, 7x5, 8x43, 12x21, 32x4, 99x18, 999x9 (mixed pill). - Spacing: 0 off-grid in screens (clean), but component copies on this page carry 170
spacing-gridand 47layer-namewarnings (IDE components). Agent A should fix these in the DS copies, agent C only re-imports. - Detached copies that should be instances (Candidate):
Card21:943a18:16415, 16433, 16452, 16473, 16491, 17035, 17133, 17200, 20030, 20080, 20107, 20146, 20166, 20206, 20224, 20270, 20294, 20332, 20368, 20394, 20420->Card / Default.Alert / Error4:16358, 16465, 16497, 17207.Button / Default Large5:20158, 20252, 20377, 20403, 20429->Button / Secondary / LG;Button / Primary Large2:20063, 20291.Textarea1:10002;Pagination1:17090;Avatar1:20032;Form Field1:20053;Input / Large1:20055. Total 37, 31 of them in Join v3 / Access.
- Repeated local structure:
Block / Loginis 100 local nodes with 4 instances (twinLogin error105 nodes);Brand/Mark14x,Header12,Th12,Td18,Label Row9,Icon Disc8,Feature Icon/Glyph/Text6 each,Icon / phosphor:lifebuoy9x -> new componentsAuth / Brand,Auth / Feature Row,Field / Labelled. Candidate Join v3 blocks have 0-1 instances each and 23-44 local nodes (Link used,Link expired,Declined,Done: 23 local, identical structure -> oneStatus Cardcomponent with 4 variants). - Naming:
Block /with punctuation and colons (Block / Code: idle,Block / Session, request pendingstyle),Screens/Screens Row Nwrappers, section... v3,Block / Invitetwice. Admin usesScreen /; unify across pages (Screen / <Flow> / <State>). Lintlayer-namein screens 0. - Missing annotations: join/entry states (waiting, no response, camera blocked, approved, declined, link used, link expired), time limit and low-time behaviour (
44:12timer,Code: tests failed, low time), theory partial submit vs submit all, system check gating (camera/mic failed), review step empty/error, MCQ submit error; 12 loose Text labels exist, 0 annotations. Add 8 to 10 notes. - Dark IDE surfaces (46
ide-*vars) are used by few screens (Challenge section, 14 blocks); after A, bind IDE text/border/bg toide/*andwhiteboard/*.
Candidate tasks (agent C): same pattern as B: re-bind colours, replace the 37 detached frames, extract login/status/form patterns once A has added them, unify names and flow duplicates, annotate, re-pack, delete unused copies (195 of 262), re-import used ones (67).
4. Execution order and conflict rules
- A first, alone: it changes variable names project-wide, token collections, component names and mains on the DS page. Nothing on Admin or Candidate should be edited before A signs off (rename/repoint is project-wide and would conflict).
- After A: B (Admin page only) and C (Candidate page only) in parallel. They share no nodes. Each may only touch its own page, only call
import_componentsfor its own page, onlyadd_feedbackon its own nodes. Variable and token edits are forbidden for B and C: if a colour is missing, B/C list it in a request file and A adds it before the next pass. - Run
finish_working_on_nodesafter each work package. Expected end state: lint 0 errors / 0 warnings on screens; every hard-coded colour that has a variable exact match bound (text and background); 0 detached frames named after components. - Safety: the user's app is live (see memory: never close it); use
undoonly for the package's own steps; take a screenshot before and after each section.
Screenshots taken (specs/interview-cleanup/audit/): admin-sessions-list.png, admin-challenge-templates-modal.png, admin-live-diagrams.png, admin-v3-session-in-progress.png, cand-diagrams-tab.png, cand-login.png, cand-v3-waiting.png, ds-colors.png, ds-components.png (page-wide, unreadable by design).
Design playbook (user, 2026-10-23)
All packages also follow the design playbook (/Volumes/Storage/Projects/design-playbook, CLI playbook): A uses principles/07 (tokens) and 10 (components); B and C use checklists/design-review.md and checklists/a11y-audit.md per screen, playbook contrast for every text/background pair, and cite rule ids in their reports.
Annotations (decided 2026-10-23)
- Admin and Candidate: page template
Product spec(set_annotation_template {pageId, template: "Product spec", scope: "page"}). Use:rule– eligibility, approval and timing rules, limits (e.g. "Candidate can join 10 min before start", "Admin must approve entry before the session").behaviour– states and transitions: pending / approved / rejected, empty, loading, error, what happens on each action.data– where a field comes from and which role (Admin / Candidate) sees or edits it.content– copy constraints: max length, tone, localisation.
- Design System page: template
Dev handoff:devusage rules (one primary button per screen, which Tag for which status),a11y(contrast pairs, 44 px targets),behaviour(component states),data. - How: one batched
annotatecall per frame (or per section), notes short (first line = label, ≤ 60 chars; body ≤ 2 lines), only where a rule is not obvious from the UI. Read the template first withget_annotation_template. Accessibility defects on screens are fixed, not annotated. - Custom templates cannot be created over MCP in 0.6.1 (no upsert tool), so built-ins are used; a project-specific "Interview flows" template is a 0.6.2 follow-up.
Annotation content rules (user feedback, 2026-10-23)
- Objective and actionable: each note states a rule someone must follow or a fact they need, not history ("Replaces Ant Button" is not a note; put it in the changelog).
- Label = the rule itself, complete, ≤ 60 chars ("One primary button per screen"). Body = condition → outcome with concrete values ("Use Primary for the main action only; others use Secondary or Ghost. Danger only for destructive, irreversible actions."). Values, limits, states, roles; no filler.
- One note per distinct rule, attached to the exact component or element it governs (not the frame), so the line is short.
- Prefer fewer, high-value notes over many: rules that change behaviour, access, data or compliance; skip what the UI already shows.
- After adding notes, run Tidy (re-layout) and check the screenshot: cards next to targets, lines not crossing components, text complete.