@flood-md/agent 0.2.10 → 0.2.12

package/references/spacing.md

@@ -41,6 +41,9 @@ the relationship between indicator and label, and independent form semantics.
 Avoid negative margins or transforms that conceal a layout problem or overlap
 click targets. For nested surfaces, compare inner radius with outer radius minus
 padding and stroke; independent controls retain their own radius recipe.
+When a circular avatar sits against the rounded end of a pill control, use the
+same inset at the top, bottom and avatar-side edge. Keep the label gap and the
+trailing action inset separate from that geometry.
 
 ## Check the composition
 
@@ -59,3 +62,30 @@ host's verification workflow; add a regression check for a repeated failure rath
 than a test that merely repeats a CSS declaration. Report what was measured and
 what remains unverified. See [accessibility](accessibility.md) and
 [verification](verification.md) for related contracts.
+
+## Judge the space you can see
+
+1. Name what should read together, what starts a new group, and what should
+   catch the eye first. Start with shared edges and the actual reading order.
+2. Inspect the screen at its working size. Compare the painted edges of text,
+   icons, fills and rules as well as their layout boxes. Line boxes, internal
+   padding and hit areas already contribute space. A strong fill or divider
+   also changes how much separation the eye sees.
+3. Compare two plausible treatments with the same content and viewport.
+   Change one lever at a time: space, measure, weight, tone or a boundary.
+   Pick the token that makes the intended grouping read clearly, then recheck
+   with the actual token applied. Keep stable alignment for repeated elements.
+4. Compare short and wrapped content and the presence or absence of optional
+   content. Recheck narrow layouts, enlarged text and text spacing overrides.
+   Keep focus visible, hit areas usable and reading order intact.
+
+For example, if a heading appears closer to the previous section than to its
+own controls, inspect the heading line box and the first control's top inset
+before increasing the section gap. If an icon looks off-center inside a
+centered slot, compare its visible outline with a sibling icon before adjusting
+the icon artwork. Keep the slot and click area on the shared track.
+
+In review notes, name the visual problem, the competing treatments and the
+reason one reads better. A passing geometry check supports that judgment.
+For text beside an icon, inspect the actual baseline and visible glyphs,
+including accents and wrapped labels. [CSS Inline Layout](https://www.w3.org/TR/css-inline-3/#leading-trim)

package/rules.json

@@ -2,6 +2,15 @@
   "schemaVersion": 1,
   "scope": "Installed Flood React/Next.js projects",
   "rules": [
+    {
+      "id": "motion.state",
+      "when": "Adding or changing animation or transitions",
+      "for": ["designer", "developer", "agent"],
+      "requires": ["Installed motion tokens", "Component state and focus contract"],
+      "sourceOfTruth": "references/flood-motion/SKILL.md",
+      "guide": "references/flood-motion/SKILL.md",
+      "verify": ["Reduced motion", "Keyboard and pointer behavior", "Interrupted or reversed transitions"]
+    },
     {
       "id": "api.installed",
       "when": "Importing or changing Flood APIs",
@@ -102,6 +111,7 @@
       "verify": [
         "Resolved scoped semantic values",
         "Text and non-text contrast",
+        "For tinted themes, compare closed fields and open floating layers on canvas and filled surfaces, including the opaque fallback",
         "No parallel raw palette"
       ]
     },
@@ -121,6 +131,7 @@
       "verify": [
         "320px width",
         "Root 24px and increased text spacing",
+        "Record workspace keeps table edges and document width stable across full, filtered and empty views with classic scrollbars",
         "No glyph shrink or unintended page overflow"
       ]
     },
@@ -140,7 +151,9 @@
       "guide": "references/verification.md",
       "verify": [
         "Commands and actual results recorded",
+        "For a new task screen, exercise the accepted result and applicable recovery path, including retained user state and focus",
         "Manual checks distinguished",
+        "For visual layout changes, compare settled renders and state the reason for the chosen treatment",
         "Untested behavior stated"
       ]
     },
@@ -179,6 +192,7 @@
       "guide": "references/spacing.md",
       "verify": [
         "Measure visible gaps and row pitch, including padding and minimum height",
+        "Compare two rendered treatments at the same viewport and name which preserves the intended grouping and visible emphasis",
         "Check wrapping and enlarged text",
         "Check fine/coarse pointers and nonoverlapping interactive targets",
         "Preserve keyboard focus and label activation",
@@ -223,6 +237,9 @@
       "guide": "references/flood-foundations/SKILL.md",
       "verify": [
         "Trace changed roles to their actual consumers",
+        "Compare actions, fields, choice/selection, supporting elements and indicators on canvas/default/raised/modal/floating materials",
+        "Nearest nested material resets context; transparent wrappers and picker bodies inherit it",
+        "Opaque/reduced-transparency and forced-colors paths retain readable content and reachable focus",
         "Distinguish decoration, necessary boundaries, selection and accent focus",
         "Check explicit icon sizing, heading semantics, long text and enlarged root geometry"
       ]
@@ -284,7 +301,8 @@
       "verify": [
         "Inspect actual FormData and field ownership",
         "Exercise accepted/refused controlled updates and incomplete drafts",
-        "Defaults match representation; no defaultValue-as-update or invented save guarantee"
+        "Defaults match representation; no defaultValue-as-update or invented save guarantee",
+        "Verify submitted free text versus selected IDs and reject options belonging to an older manual query."
       ]
     },
     {
@@ -303,6 +321,7 @@
       "guide": "references/flood-forms/SKILL.md",
       "verify": [
         "Normal and prevented reset preserve documented ownership",
+        "A settings reset restores the last accepted values, including after a successful save",
         "Minute/second defaults match selected precision",
         "Advisory messages remain valid; native errors and disabled/read-only retain distinct semantics"
       ]
@@ -343,6 +362,7 @@
       "guide": "references/flood-overlays/SKILL.md",
       "verify": [
         "Check used sides, viewport edges, resize, long content and RTL",
+        "Select fits ordinary option labels even when the trigger is narrow, and stays within the viewport with long labels",
         "No drawer gap caused by page scrollbar gutter",
         "Header, footer and padding leave a useful body reading area at enlarged narrow sizes; fitting rectangles alone is insufficient",
         "Popup remains distinguishable with no rail-covered or clipped essential content"
@@ -365,7 +385,21 @@
       "verify": [
         "Native link behavior and current destination preserved",
         "Selection, focus and expansion remain distinct",
-        "Long labels and final sidebar items remain usable in actual supported orientations"
+        "Long labels and final sidebar items remain usable in actual supported orientations",
+        "Check sidebar width in both directions and with reduced motion; omit visible group titles that repeat context",
+        "Compare top header anchors across short/long routes and check focus when an action moves into overflow.",
+        "Global module, contextual page, disclosure and context visibility have separate owners",
+        "Modifier clicks preserve the current tab; location versus page current semantics are accurate",
+        "Validate complete route identity; invalid extra segments cannot produce unnamed destinations",
+        "Scoped filters/search do not leak between modules; disappearing focus has a stable fallback after row/pane/dialog removal",
+        "Collapsed hints appear on hover and keyboard focus without replacing native links or competing with an open flyout",
+        "Disclosure glyphs remain subordinate to destination icons while hit areas and shared trailing centers remain intact",
+        "Pane toggle artwork, accessible name and aria-expanded reflect the accepted visible state",
+        "Scrollbars use a deliberate edge budget without permanent unused document strips or shifting navigation tracks",
+        "NavigationItem is the shared row owner for NavigationList and NavigationTree; split selection spans both link and disclosure",
+        "Disclosure-only rows have one full-row button; link-plus-disclosure keeps separate native targets and independent accepted state",
+        "Configurable group headings, separators and collapse preserve accessible names and reachable compact destinations",
+        "Measure actual account/profile trigger centers with header and body in every compact profile, not only decorative glyph centers"
       ]
     },
     {
@@ -385,7 +419,11 @@
       "verify": [
         "Caption, headers and named-value relationships preserved",
         "Row actions remain independent named controls",
-        "File metadata/status/progress reuse their existing primitives"
+        "When users need column visibility, the table has one layout control in its tool row or existing view settings",
+        "If enabled, column resizing works by pointer and keyboard, pinned edges leave the middle reachable, and resetting layout preserves the query",
+        "Expanded detail remains associated with its parent record and preserves native table semantics",
+        "File metadata/status/progress reuse their existing primitives",
+        "Test one supplied server page without local slicing/sorting; declare and validate page/dataset selection scope."
       ]
     },
     {
@@ -425,7 +463,8 @@
       "verify": [
         "Pending/success/error/cancel/local state is truthful",
         "Unknown progress never fabricates a percentage",
-        "Empty content explains its cause and appropriate next action"
+        "Empty content explains its cause and appropriate next action",
+        "Distinguish missing, malformed and unreadable persistence; retain data/draft after refused writes and require explicit replacement."
       ]
     },
     {
@@ -545,10 +584,12 @@
       "verify": [
         "Changed copy has a necessary role or is removed",
         "Titles, subtitles and hints do not repeat obvious context",
+        "Compare copy across the shell, list and opened record; keep a repeated fact only when it changes scope, action or comprehension in its location",
         "Accessible names, needed constraints and recovery remain available",
         "Each supporting sentence serves a specific decision or recovery need in the current state, not a hypothetical future risk",
         "No standing implementation/storage caption merely because the data has a retention limitation",
-        "Prototype provenance stays in README/test handoff unless it changes a current record/choice/action; no automatic permanent environment badge"
+        "Prototype provenance stays in README/test handoff unless it changes a current record/choice/action; no automatic permanent environment badge",
+        "Review canonical previews and copied recipes: optional descriptions are absent unless they add a real distinction."
       ]
     },
     {
@@ -606,7 +647,7 @@
       "guide": "references/flood-hierarchy/SKILL.md",
       "verify": [
         "Task, group and field roles are distinguishable without redundant headings",
-        "Label is closer to its control than independent fields/groups",
+        "Labels and controls read as groups after accounting for line height, fill and adjacent boundaries",
         "Related rows share measured control edges; width exceptions have a content reason",
         "Dialog title/body inset is owned once; actions remain reachable at enlarged text",
         "Calendar content remains readable inside viewport collision limits"
@@ -632,7 +673,10 @@
         "Field to decision and list/detail placement choices recorded outside UI",
         "Identity and summary remain readable with long and missing metadata",
         "Stable scan positions or real named comparison columns, not drifting pseudo-columns",
-        "List, details, first-use and filtered empty states reviewed separately"
+        "List, details, first-use and filtered empty states reviewed separately",
+        "A short mutually exclusive filter for one table uses a selection control; verify keyboard selection, surviving search/sort and focused control",
+        "Record edits preserve applied filters and list position; focus returns to the opener or a surviving list control",
+        "For a row opening in-place details, compare title-to-metadata rhythm and the shared table edge; exercise row activation, keyboard entry and independent nested controls"
       ]
     },
     {
@@ -653,7 +697,53 @@
         "Category/state/urgency distinguished with names where needed, not color alone",
         "Essential triage/comparison fields retained; optional attributes do not compete equally",
         "Dates identify useful events with suitable precision; formatted equality is not event equality",
-        "Counts and supporting text add current value; necessary announcements remain"
+        "Compare filter and footer count scope before keeping both; show missing evidence where it changes a decision",
+        "Necessary announcements remain"
+      ]
+    },
+    {
+      "id": "composition.family",
+      "when": "Adding a reusable component or changing its visual contract",
+      "for": [
+        "designer",
+        "developer",
+        "agent",
+        "reviewer"
+      ],
+      "requires": [
+        "Closest existing component contracts",
+        "Actual host interaction requirements"
+      ],
+      "sourceOfTruth": "Matching source/installed declarations and semantic tokens",
+      "guide": "references/component-families.md",
+      "verify": [
+        "Closest siblings rendered at the same size, surface and root text scale",
+        "Shape, nested inset and content-box overflow budget checked together",
+        "Read-only editing restrictions kept separate from focus and disabled semantics",
+        "Another consumer checked after a shared primitive correction"
+      ]
+    },
+    {
+      "id": "spacing.shared-tracks",
+      "when": "Composing repeated navigation or record rows with headers, groups or fixed footers",
+      "for": [
+        "designer",
+        "developer",
+        "agent",
+        "reviewer"
+      ],
+      "requires": [
+        "Rendered role anatomy",
+        "Declared leading/text/trailing tracks and nested-indent rule"
+      ],
+      "sourceOfTruth": "Shared rendered content tracks, including scroll gutter budget",
+      "guide": "references/flood-spacing/SKILL.md",
+      "verify": [
+        "Measure glyph centers and text starts across header, peer rows, groups and footer",
+        "Compare badge and disclosure centers; reserve missing peer icon slots",
+        "Check tracks with and without overflow, nested rows, RTL and enlarged text",
+        "Repair the owning component/shared grid rather than applying per-item offsets",
+        "Compare outer start/end clearance in expanded and compact states; internally aligned content must not drift to one edge"
       ]
     }
   ],

package/workflows.json

@@ -2,6 +2,11 @@
   "schemaVersion": 1,
   "scope": "Task routing for the existing Flood dark base; applicability is not test evidence",
   "workflows": [
+    {
+      "id": "motion",
+      "guide": "references/flood-motion/SKILL.md",
+      "all": true
+    },
     {
       "id": "composition",
       "guide": "references/flood-composition/SKILL.md",
@@ -23,6 +28,7 @@
       ],
       "components": [
         "Card",
+        "PageHeader",
         "Section",
         "EmptyState"
       ]
@@ -52,7 +58,9 @@
         "Button",
         "Label",
         "Fieldset",
-        "ErrorSummary"
+        "ErrorSummary",
+        "CollectionToolbar",
+        "CollectionViewSwitcher"
       ]
     },
     {
@@ -65,12 +73,17 @@
         "Select",
         "Combobox",
         "MultiSelect",
+        "FilterCondition",
+        "FilterGroup",
         "TreeSelect",
         "DatePicker",
         "DateRangePicker",
         "TimePicker",
         "DateTimePicker",
-        "DateTimeRangePicker"
+        "DateTimeRangePicker",
+        "CollectionToolbar",
+        "CollectionViewSwitcher",
+        "Sidebar"
       ]
     },
     {
@@ -88,7 +101,15 @@
         "ToggleGroup",
         "SegmentedControl",
         "Accordion",
-        "Collapsible"
+        "Collapsible",
+        "CollectionViewSwitcher",
+        "NavigationItem",
+        "NavigationGroup",
+        "NavigationTree",
+        "NavigationList",
+        "AppShell",
+        "AppTopBar",
+        "Sidebar"
       ]
     },
     {
@@ -98,6 +119,8 @@
         "content"
       ],
       "components": [
+        "FilterCondition",
+        "FilterGroup",
         "UploadItem",
         "UploadList",
         "EmptyState",
@@ -112,6 +135,8 @@
         "DataListItem",
         "Table",
         "DataTable",
+        "SegmentedControl",
+        "CollectionToolbar",
         "DescriptionList",
         "Card",
         "Section",