@event4u/agent-config 14.18.0 → 14.19.0

package/dist/agent-src/skills/adversarial-review/SKILL.md

@@ -142,14 +142,6 @@ logic, ≥ 3 explicit must/must-not constraints, stateful operations,
 irreversibility} **and** estimated work ≥ ~1k tokens. Token length alone never
 triggers it. See [`rdp-gate`](../../contexts/execution/rdp-gate.md) (L12).
 
-## Auto-trigger keywords
-
-- adversarial review
-- self-review
-- challenge plan
-- review my approach
-- sanity check
-
 ### Validate
 
 - Confirm each identified risk has a concrete mitigation or explicit acceptance.

package/dist/agent-src/skills/canvas-design/SKILL.md

@@ -1,7 +1,7 @@
 ---
 model_tier: inherit
 name: canvas-design
-description: "Use when creating static visual art — posters, marketing visuals, brand assets, PDF/PNG design pieces — even if the user just says 'design a poster' or 'mach uns ein Visual'."
+description: "Creating static visual art — posters, marketing visuals, brand assets, PDF/PNG design pieces — on 'design a poster' or 'mach uns ein Visual'. Grounded by design-intelligence."
 domain: product
 workspaces:
   - small-business

package/dist/agent-src/skills/design-intelligence/SKILL.md

@@ -1,7 +1,7 @@
 ---
 model_tier: inherit
 name: design-intelligence
-description: "Grounded design brief from the adopted corpus — style, WCAG-checked color tokens, typography, layout pattern, anti-patterns. Use on ui-design-brief or any which-style/palette/font/chart decision."
+description: "Grounded design brief from the corpus — style, WCAG color tokens, typography, layout, anti-patterns. Use on ui-design-brief or any which-style/palette/font/chart call; feeds fe-design."
 domain: engineering
 personas:
   - frontend-engineer

package/dist/agent-src/skills/design-intelligence/data/app-interface.csv

@@ -21,7 +21,7 @@ No,Category,Issue,Keywords,Platform,Description,Do,Don't,Code Example Good,Code
 20,Performance,Virtualize Long Lists,FlatList SectionList virtualization,iOS/Android/React Native,Use FlatList/SectionList for lists over ~50 items,Use keyExtractor and initialNumToRender appropriately,Render hundreds of items with ScrollView,"<FlatList data={items} renderItem={...} />","<ScrollView>{items.map(renderItem)}</ScrollView>",High
 21,Performance,Image Size & Cache,Image resize cache,iOS/Android/React Native,Use correctly sized and cached images,Use Image component with proper resizeMode and caching,Load full-resolution images everywhere,"<Image source={{uri}} resizeMode=""cover"" />","<Image source={require('4k.png')} /> // small avatar",Medium
 22,Performance,Debounce High-Freq Events,debounce scroll search,iOS/Android/React Native,Debounce scroll/search callbacks to avoid jank,Wrap handlers with debounce/throttle,Run heavy logic on every event,"onScroll={debouncedHandleScroll}","onScroll={handleScrollHeavy}",Medium
-23,Animation,Duration & Easing,animation duration easing,iOS/Android/React Native,Micro-interactions should be 150–300ms with native-like easing,Use ease-out for enter/ease-in for exit,Use long or linear animations for core UI,"Animated.timing(..., { duration: 200, easing: Easing.out(Easing.quad) })","Animated.timing(..., { duration: 800, easing: Easing.linear })",Medium
+23,Animation,Duration & Easing,animation duration easing,iOS/Android/React Native,"Micro-interactions follow the per-interaction bands in design-patterns.md § Motion, with native-like easing",Use ease-out for both enter and exit,Use long or linear animations for core UI,"Animated.timing(..., { duration: 200, easing: Easing.out(Easing.quad) })","Animated.timing(..., { duration: 800, easing: Easing.linear })",Medium
 24,Animation,Respect Reduced Motion,reduced motion accessibility,iOS/Android/React Native,Respect OS reduced-motion accessibility setting,Check reduceMotionEnabled and simplify animations,Ignore user motion preferences,"if (reduceMotionEnabled) skipAnimation()","Always run complex parallax animations",Critical
 25,Animation,Limited Continuous Motion,loop animation loader,iOS/Android/React Native,Reserve infinite animations for loaders and live data,Use looping only where necessary,Keep decorative elements looping forever,"Animated.loop(loaderAnim) for ActivityIndicator","Animated.loop(bounceAnim) on background icons",Medium
 26,Typography,Base Font Size,fontScale dynamic type,iOS/Android/React Native,Body text must be readable and support Dynamic Type,Use platform fontScale and at least 14–16pt base,Render critical text below 12pt,"<Text style={{ fontSize: 16 }}>Body</Text>","<Text style={{ fontSize: 10 }}>Body</Text>",High

package/dist/agent-src/skills/design-intelligence/data/motion.csv

@@ -1,17 +1,17 @@
-No,Category,Intensity Tier,Keywords,Trigger,Duration,Easing,GSAP Snippet,Framework Notes,Do,Don't,Performance Notes
-1,Hover Micro-interaction,Subtle,"hover, button, opacity, lift, press feedback",hover,150-200ms,power1.out,"gsap.to(el, { y: -1, opacity: 0.9, duration: 0.15, ease: 'power1.out' });",Bind on mouseenter/mouseleave; in React wrap in a ref + useEffect (or onMouseEnter/onMouseLeave props directly calling gsap.to),Keep displacement under 2px so it reads as feedback not motion,Don't animate layout-affecting props (width/height/margin) on hover,Runs on transform/opacity only so it stays on the compositor thread
-2,Hover Micro-interaction,Standard,"hover, card, scale, tilt, cursor feedback",hover,200-300ms,power2.out,"gsap.to(el, { y: -4, scale: 1.02, boxShadow: '0 12px 24px rgba(0,0,0,0.12)', duration: 0.25, ease: 'power2.out' });","Use gsap.quickTo(el, 'y') for cards with many hover targets to avoid re-creating tweens every event",Pair with a matching mouseleave tween that reverses the same properties,Don't leave the hover state stuck if the pointer leaves fast; always attach the reverse tween,quickTo() avoids GC churn on lists with 20+ hoverable cards
-3,Hover Micro-interaction,Complex,"hover, magnetic, cursor follow, 3d tilt",hover + mousemove,300-500ms,"elastic.out(1,0.4)","const xTo = gsap.quickTo(el, 'x', { duration: 0.4, ease: 'elastic.out(1,0.4)' }); const yTo = gsap.quickTo(el, 'y', { duration: 0.4, ease: 'elastic.out(1,0.4)' }); el.addEventListener('mousemove', (e) => { const r = el.getBoundingClientRect(); xTo((e.clientX - r.left - r.width/2) * 0.3); yTo((e.clientY - r.top - r.height/2) * 0.3); });",Debounce is not needed since quickTo interpolates; remove listeners on component unmount in React/Vue to avoid leaks,Clamp the pull strength (e.g. * 0.3) so the element never fully leaves its hit box,Don't apply magnetic effect to more than 1-2 focal elements per screen; it becomes noisy,Use will-change: transform on the target element for smoother compositing
-4,Scroll Reveal,Subtle,"scroll, fade in, reveal, on view",scroll (viewport enter),300-400ms,power1.out,"gsap.from(el, { opacity: 0, y: 12, duration: 0.35, ease: 'power1.out', scrollTrigger: { trigger: el, start: 'top 90%', toggleActions: 'play none none reverse' } });",Requires the ScrollTrigger plugin registered once via gsap.registerPlugin(ScrollTrigger),"Keep the y offset small (8-16px) so it reads as a fade, not a slide",Don't reveal below-the-fold content needed for SEO/crawlers as invisible-by-default without a no-JS fallback,toggleActions 'play none none reverse' avoids re-triggering on every scroll direction change
-5,Scroll Reveal,Standard,"scroll, slide up, staggered section, reveal",scroll (viewport enter),400-600ms,power2.out,"gsap.from(el.children, { opacity: 0, y: 24, duration: 0.5, stagger: 0.08, ease: 'power2.out', scrollTrigger: { trigger: el, start: 'top 85%' } });","In React use useGSAP(() => {...}, { scope: containerRef }) from @gsap/react to auto-cleanup on unmount",Scope the ScrollTrigger to the section container so it doesn't re-scan the whole page,Don't stagger more than ~8 children; beyond that the last items feel laggy,Set scroller/markers: false in production; markers is dev-only
-6,Scroll Reveal,Complex,"scroll, pin, scrub, storytelling, scrollytelling",scroll (continuous scrub),tied to scroll position,none (scrub-driven),"gsap.timeline({ scrollTrigger: { trigger: section, start: 'top top', end: '+=150%', scrub: 1, pin: true } }).from('.headline', { opacity: 0, y: 40 }).to('.bg-layer', { yPercent: -20 }, '<');",Pinning needs the section to have deterministic height; recalc ScrollTrigger.refresh() after images/fonts load,Use scrub: true or a small number (0.5-1.5) instead of instant jumps so it feels tied to the scrollbar,Don't pin more than 1-2 sections per page; excessive pinning fights native scroll feel and hurts mobile UX,"Pinning forces layout reflow; test on mid-tier mobile devices, not just desktop"
-7,Stagger List,Subtle,"list, stagger, cards, grid entrance",load or scroll,250-350ms,power1.out,"gsap.from('.list-item', { opacity: 0, y: 8, duration: 0.3, stagger: 0.03 });",Select items with a stable class/data-attribute (not array index) so re-renders in React don't break targeting,Keep per-item stagger delay small (0.02-0.04s) for lists longer than 10 items,Don't stagger by more than 0.1s per item on long lists; total reveal time becomes sluggish,"For virtualized lists, only animate items currently mounted in the DOM"
-8,Stagger List,Standard,"grid, bento, cards, staggered scale",load or scroll,300-450ms,back.out(1.4),"gsap.from('.grid-item', { opacity: 0, scale: 0.92, y: 16, duration: 0.4, stagger: { each: 0.06, from: 'start', grid: 'auto' }, ease: 'back.out(1.4)' });",grid: 'auto' lets GSAP infer rows/columns from a CSS grid layout for a natural wave stagger,Combine with from: 'center' for a bento-grid layout to draw the eye inward first,Don't use back.out on dense data tables; the overshoot reads as sloppy on informational UI,Group DOM writes; avoid interleaving layout reads (getBoundingClientRect) between staggered tweens
-9,Stagger List,Complex,"stagger, wave, text reveal, split text",load or scroll,400-700ms,expo.out,"const split = new SplitText(headline, { type: 'chars' }); gsap.from(split.chars, { opacity: 0, y: 20, rotateX: -40, duration: 0.6, stagger: 0.015, ease: 'expo.out' });",SplitText is a GSAP Club/paid plugin; confirm license before shipping and provide a plain fade fallback if unavailable,Revert SplitText on unmount/cleanup (split.revert()) to restore original text nodes for accessibility tools,Don't split-animate long paragraphs; reserve for short headlines (under ~8 words),Splitting text creates one element per character; keep it to headline-length copy only for DOM size
-10,Page Transition,Subtle,"route change, fade, page transition",route change,200-300ms,power1.inOut,"gsap.to(main, { opacity: 0, duration: 0.2, onComplete: () => { navigate(); gsap.fromTo(main, { opacity: 0 }, { opacity: 1, duration: 0.2 }); } });","Pair with the router's transition hooks (Next.js App Router transitions, React Router's useNavigate, Vue Router's beforeEach/afterEach)",Preload the destination route's critical assets before the exit tween finishes,Don't block navigation on animation; cap exit duration at ~250ms so the app never feels unresponsive,Exit animation should always resolve faster than entrance (asymmetric timing) so back/forward feels snappy
-11,Page Transition,Standard,"route change, slide, overlay wipe",route change,400-600ms,power2.inOut,"const tl = gsap.timeline(); tl.to('.transition-overlay', { yPercent: 0, duration: 0.4, ease: 'power2.inOut' }).call(navigate).to('.transition-overlay', { yPercent: -100, duration: 0.4, ease: 'power2.inOut', delay: 0.1 });",Keep the overlay element mounted at the layout root (outside the page component) so it survives the route swap,Show a lightweight loading indicator if the destination route's data fetch outlasts the overlay,Don't tie the overlay's reveal directly to data-fetch completion without a max-wait timeout; a slow API stalls the whole transition,Prefer CSS transform (yPercent) over top/left to keep the overlay animation on the compositor thread
-12,Page Transition,Complex,"shared element, morph, hero transition",route change,500-800ms,expo.inOut,"const state = Flip.getState('.hero-image'); navigate(); Flip.from(state, { duration: 0.6, ease: 'expo.inOut', absolute: true, zIndex: 100 });",Requires the GSAP Flip plugin; the 'from' and 'to' route must render the same element with a shared data-flip-id,Verify the shared element exists in both DOM states before calling Flip.from to avoid a silent no-op,Don't use shared-element transitions across more than one element pair per navigation; compounding Flips are hard to time correctly,Flip recalculates layout (FLIP technique) so test on low-end devices for jank
-13,Parallax Scroll,Subtle,"parallax, background, depth, scroll speed",scroll (continuous),tied to scroll position,linear (scrub),"gsap.to('.bg-layer', { yPercent: 10, ease: 'none', scrollTrigger: { trigger: section, scrub: true } });","Apply parallax to background/decorative layers only, never to text or interactive controls",Keep the yPercent delta small (5-15) so foreground and background never desync distractingly,Don't parallax body copy; it hurts reading comfort and can trigger motion sickness,will-change: transform on the parallax layer only; remove it after scroll settles to free GPU memory
-14,Parallax Scroll,Standard,"multi-layer parallax, depth, hero background",scroll (continuous),tied to scroll position,linear (scrub),"gsap.utils.toArray('.parallax-layer').forEach((layer, i) => { gsap.to(layer, { yPercent: (i + 1) * -8, ease: 'none', scrollTrigger: { trigger: layer.parentElement, scrub: 0.5 } }); });",Layer count beyond 3-4 has diminishing visual return and multiplies scroll-listener cost,"Vary speed per layer (background slowest, foreground fastest) to sell the depth illusion",Don't let parallax layers overflow their container; clip with overflow: hidden on the wrapper,Batch all layers under one ScrollTrigger container where possible instead of one per layer
-15,Loading / Skeleton,Subtle,"loading, skeleton, shimmer, pulse",on mount / async wait,1200-1600ms loop,sine.inOut,"gsap.to('.skeleton', { backgroundPosition: '200% 0', duration: 1.4, ease: 'sine.inOut', repeat: -1 });",Kill the loop tween (tween.kill()) as soon as real content mounts to avoid orphaned repeating animations,Use a CSS gradient background-position sweep rather than opacity pulsing; reads as 'loading' more clearly,Don't run more than one shimmer loop per skeleton group; sync them under one timeline so the wave reads as a single unit,repeat: -1 tweens are cheap but must be explicitly killed on unmount or they leak in SPA route changes
-16,Loading / Skeleton,Standard,"progress, spinner, morphing loader",on mount / async wait,800-1200ms loop,power1.inOut,"gsap.timeline({ repeat: -1 }).to('.loader-dot', { y: -8, duration: 0.4, stagger: { each: 0.15, yoyo: true, repeat: 1 } });",Wrap the whole loop timeline in useGSAP with { revertOnUpdate: false } in React so it isn't rebuilt every render,Cap total loop duration under ~1.5s so long waits don't feel like the UI froze on a single beat,Don't use elaborate loaders for sub-300ms waits; they flash and feel worse than no indicator,Pause the timeline (tl.pause()) when the loading tab/view is not visible to save CPU on background tabs
+No,Category,Intensity Tier,Keywords,Trigger,Duration,Easing,GSAP Snippet,Framework Notes,Do,Don't,Performance Notes,Override Condition
+1,Hover Micro-interaction,Subtle,"hover, button, opacity, lift, press feedback",hover,100-160ms,power1.out,"gsap.to(el, { y: -1, opacity: 0.9, duration: 0.15, ease: 'power1.out' });",Bind on mouseenter/mouseleave; in React wrap in a ref + useEffect (or onMouseEnter/onMouseLeave props directly calling gsap.to),Keep displacement under 2px so it reads as feedback not motion,Don't animate layout-affecting props (width/height/margin) on hover,Runs on transform/opacity only so it stays on the compositor thread,
+2,Hover Micro-interaction,Standard,"hover, card, scale, tilt, cursor feedback",hover,200-300ms,power2.out,"gsap.to(el, { y: -4, scale: 1.02, boxShadow: '0 12px 24px rgba(0,0,0,0.12)', duration: 0.25, ease: 'power2.out' });","Use gsap.quickTo(el, 'y') for cards with many hover targets to avoid re-creating tweens every event",Pair with a matching mouseleave tween that reverses the same properties,Don't leave the hover state stuck if the pointer leaves fast; always attach the reverse tween,quickTo() avoids GC churn on lists with 20+ hoverable cards,
+3,Hover Micro-interaction,Complex,"hover, magnetic, cursor follow, 3d tilt",hover + mousemove,300-500ms,"elastic.out(1,0.4)","const xTo = gsap.quickTo(el, 'x', { duration: 0.4, ease: 'elastic.out(1,0.4)' }); const yTo = gsap.quickTo(el, 'y', { duration: 0.4, ease: 'elastic.out(1,0.4)' }); el.addEventListener('mousemove', (e) => { const r = el.getBoundingClientRect(); xTo((e.clientX - r.left - r.width/2) * 0.3); yTo((e.clientY - r.top - r.height/2) * 0.3); });",Debounce is not needed since quickTo interpolates; remove listeners on component unmount in React/Vue to avoid leaks,Clamp the pull strength (e.g. * 0.3) so the element never fully leaves its hit box,Don't apply magnetic effect to more than 1-2 focal elements per screen; it becomes noisy,Use will-change: transform on the target element for smoother compositing,"M1 override — declared playful register: the magnetic pull is the affordance itself, not decoration on a state change"
+4,Scroll Reveal,Subtle,"scroll, fade in, reveal, on view",scroll (viewport enter),300-400ms,power1.out,"gsap.from(el, { opacity: 0, y: 12, duration: 0.35, ease: 'power1.out', scrollTrigger: { trigger: el, start: 'top 90%', toggleActions: 'play none none reverse' } });",Requires the ScrollTrigger plugin registered once via gsap.registerPlugin(ScrollTrigger),"Keep the y offset small (8-16px) so it reads as a fade, not a slide",Don't reveal below-the-fold content needed for SEO/crawlers as invisible-by-default without a no-JS fallback,toggleActions 'play none none reverse' avoids re-triggering on every scroll direction change,
+5,Scroll Reveal,Standard,"scroll, slide up, staggered section, reveal",scroll (viewport enter),400-600ms,power2.out,"gsap.from(el.children, { opacity: 0, y: 24, duration: 0.5, stagger: 0.08, ease: 'power2.out', scrollTrigger: { trigger: el, start: 'top 85%' } });","In React use useGSAP(() => {...}, { scope: containerRef }) from @gsap/react to auto-cleanup on unmount",Scope the ScrollTrigger to the section container so it doesn't re-scan the whole page,Don't stagger more than ~8 children; beyond that the last items feel laggy,Set scroller/markers: false in production; markers is dev-only,
+6,Scroll Reveal,Complex,"scroll, pin, scrub, storytelling, scrollytelling",scroll (continuous scrub),tied to scroll position,none (scrub-driven),"gsap.timeline({ scrollTrigger: { trigger: section, start: 'top top', end: '+=150%', scrub: 1, pin: true } }).from('.headline', { opacity: 0, y: 40 }).to('.bg-layer', { yPercent: -20 }, '<');",Pinning needs the section to have deterministic height; recalc ScrollTrigger.refresh() after images/fonts load,Use scrub: true or a small number (0.5-1.5) instead of instant jumps so it feels tied to the scrollbar,Don't pin more than 1-2 sections per page; excessive pinning fights native scroll feel and hurts mobile UX,"Pinning forces layout reflow; test on mid-tier mobile devices, not just desktop",
+7,Stagger List,Subtle,"list, stagger, cards, grid entrance",load or scroll,250-350ms,power1.out,"gsap.from('.list-item', { opacity: 0, y: 8, duration: 0.3, stagger: 0.03 });",Select items with a stable class/data-attribute (not array index) so re-renders in React don't break targeting,Keep per-item stagger delay small (0.02-0.04s) for lists longer than 10 items,Don't stagger by more than 0.1s per item on long lists; total reveal time becomes sluggish,"For virtualized lists, only animate items currently mounted in the DOM",
+8,Stagger List,Standard,"grid, bento, cards, staggered scale",load or scroll,300-450ms,back.out(1.4),"gsap.from('.grid-item', { opacity: 0, scale: 0.92, y: 16, duration: 0.4, stagger: { each: 0.06, from: 'start', grid: 'auto' }, ease: 'back.out(1.4)' });",grid: 'auto' lets GSAP infer rows/columns from a CSS grid layout for a natural wave stagger,Combine with from: 'center' for a bento-grid layout to draw the eye inward first,Don't use back.out on dense data tables; the overshoot reads as sloppy on informational UI,Group DOM writes; avoid interleaving layout reads (getBoundingClientRect) between staggered tweens,"M1 override — declared playful register: the overshoot is the bento-grid entrance affordance; refused on data tables, per this row's Don't"
+9,Stagger List,Complex,"stagger, wave, text reveal, split text",load or scroll,400-700ms,expo.out,"const split = new SplitText(headline, { type: 'chars' }); gsap.from(split.chars, { opacity: 0, y: 20, rotateX: -40, duration: 0.6, stagger: 0.015, ease: 'expo.out' });",SplitText is a GSAP Club/paid plugin; confirm license before shipping and provide a plain fade fallback if unavailable,Revert SplitText on unmount/cleanup (split.revert()) to restore original text nodes for accessibility tools,Don't split-animate long paragraphs; reserve for short headlines (under ~8 words),Splitting text creates one element per character; keep it to headline-length copy only for DOM size,
+10,Page Transition,Subtle,"route change, fade, page transition",route change,200-300ms,power1.inOut,"gsap.to(main, { opacity: 0, duration: 0.2, onComplete: () => { navigate(); gsap.fromTo(main, { opacity: 0 }, { opacity: 1, duration: 0.2 }); } });","Pair with the router's transition hooks (Next.js App Router transitions, React Router's useNavigate, Vue Router's beforeEach/afterEach)",Preload the destination route's critical assets before the exit tween finishes,Don't block navigation on animation; cap exit duration at ~250ms so the app never feels unresponsive,Exit animation should always resolve faster than entrance (asymmetric timing) so back/forward feels snappy,
+11,Page Transition,Standard,"route change, slide, overlay wipe",route change,300-500ms,power2.inOut,"const tl = gsap.timeline(); tl.to('.transition-overlay', { yPercent: 0, duration: 0.4, ease: 'power2.inOut' }).call(navigate).to('.transition-overlay', { yPercent: -100, duration: 0.4, ease: 'power2.inOut', delay: 0.1 });",Keep the overlay element mounted at the layout root (outside the page component) so it survives the route swap,Show a lightweight loading indicator if the destination route's data fetch outlasts the overlay,Don't tie the overlay's reveal directly to data-fetch completion without a max-wait timeout; a slow API stalls the whole transition,Prefer CSS transform (yPercent) over top/left to keep the overlay animation on the compositor thread,
+12,Page Transition,Complex,"shared element, morph, hero transition",route change,300-500ms,expo.inOut,"const state = Flip.getState('.hero-image'); navigate(); Flip.from(state, { duration: 0.45, ease: 'expo.inOut', absolute: true, zIndex: 100 });",Requires the GSAP Flip plugin; the 'from' and 'to' route must render the same element with a shared data-flip-id,Verify the shared element exists in both DOM states before calling Flip.from to avoid a silent no-op,Don't use shared-element transitions across more than one element pair per navigation; compounding Flips are hard to time correctly,Flip recalculates layout (FLIP technique) so test on low-end devices for jank,
+13,Parallax Scroll,Subtle,"parallax, background, depth, scroll speed",scroll (continuous),tied to scroll position,linear (scrub),"gsap.to('.bg-layer', { yPercent: 10, ease: 'none', scrollTrigger: { trigger: section, scrub: true } });","Apply parallax to background/decorative layers only, never to text or interactive controls",Keep the yPercent delta small (5-15) so foreground and background never desync distractingly,Don't parallax body copy; it hurts reading comfort and can trigger motion sickness,will-change: transform on the parallax layer only; remove it after scroll settles to free GPU memory,
+14,Parallax Scroll,Standard,"multi-layer parallax, depth, hero background",scroll (continuous),tied to scroll position,linear (scrub),"gsap.utils.toArray('.parallax-layer').forEach((layer, i) => { gsap.to(layer, { yPercent: (i + 1) * -8, ease: 'none', scrollTrigger: { trigger: layer.parentElement, scrub: 0.5 } }); });",Layer count beyond 3-4 has diminishing visual return and multiplies scroll-listener cost,"Vary speed per layer (background slowest, foreground fastest) to sell the depth illusion",Don't let parallax layers overflow their container; clip with overflow: hidden on the wrapper,Batch all layers under one ScrollTrigger container where possible instead of one per layer,
+15,Loading / Skeleton,Subtle,"loading, skeleton, shimmer, pulse",on mount / async wait,1200-1600ms loop,sine.inOut,"gsap.to('.skeleton', { backgroundPosition: '200% 0', duration: 1.4, ease: 'sine.inOut', repeat: -1 });",Kill the loop tween (tween.kill()) as soon as real content mounts to avoid orphaned repeating animations,Use a CSS gradient background-position sweep rather than opacity pulsing; reads as 'loading' more clearly,Don't run more than one shimmer loop per skeleton group; sync them under one timeline so the wave reads as a single unit,repeat: -1 tweens are cheap but must be explicitly killed on unmount or they leak in SPA route changes,
+16,Loading / Skeleton,Standard,"progress, spinner, morphing loader",on mount / async wait,800-1200ms loop,power1.inOut,"gsap.timeline({ repeat: -1 }).to('.loader-dot', { y: -8, duration: 0.4, stagger: { each: 0.15, yoyo: true, repeat: 1 } });",Wrap the whole loop timeline in useGSAP with { revertOnUpdate: false } in React so it isn't rebuilt every render,Cap total loop duration under ~1.5s so long waits don't feel like the UI froze on a single beat,Don't use elaborate loaders for sub-300ms waits; they flash and feel worse than no indicator,Pause the timeline (tl.pause()) when the loading tab/view is not visible to save CPU on background tabs,

package/dist/agent-src/skills/design-intelligence/data/ux-guidelines.csv

@@ -6,13 +6,13 @@ No,Category,Issue,Platform,Description,Do,Don't,Code Example Good,Code Example B
 5,Navigation,Deep Linking,All,URLs should reflect current state for sharing,Update URL on state/view changes,Static URLs for dynamic content,Use query params or hash,Single URL for all states,Medium
 6,Navigation,Breadcrumbs,Web,Show user location in site hierarchy,Use for sites with 3+ levels of depth,Use for flat single-level sites,Home > Category > Product,Only on deep nested pages,Low
 7,Animation,Excessive Motion,All,Too many animations cause distraction and motion sickness,Animate 1-2 key elements per view maximum,Animate everything that moves,Single hero animation,animate-bounce on 5+ elements,High
-8,Animation,Duration Timing,All,Animations should feel responsive not sluggish,Use 150-300ms for micro-interactions,Use animations longer than 500ms for UI,transition-colors duration-200,transition-all duration-1000,Medium
+8,Animation,Duration Timing,All,Animations should feel responsive not sluggish,Use the per-interaction bands in design-patterns.md § Motion,Use animations longer than 500ms for UI,transition-colors duration-200,transition-all duration-1000,Medium
 9,Animation,Reduced Motion,All,Respect user's motion preferences,Check prefers-reduced-motion media query,Ignore accessibility motion settings,@media (prefers-reduced-motion: reduce),No motion query check,High
 10,Animation,Loading States,All,Show feedback during async operations,Use skeleton screens or spinners,Leave UI frozen with no feedback,animate-pulse skeleton,Blank screen while loading,High
 11,Animation,Hover vs Tap,All,Hover effects don't work on touch devices,Use click/tap for primary interactions,Rely only on hover for important actions,onClick handler,onMouseEnter only,High
 12,Animation,Continuous Animation,All,Infinite animations are distracting,Use for loading indicators only,Use for decorative elements,animate-spin on loader,animate-bounce on icons,Medium
 13,Animation,Transform Performance,Web,Some CSS properties trigger expensive repaints,Use transform and opacity for animations,Animate width/height/top/left properties,transform: translateY(),top: 10px animation,Medium
-14,Animation,Easing Functions,All,Linear motion feels robotic,Use ease-out for entering ease-in for exiting,Use linear for UI transitions,ease-out,linear,Low
+14,Animation,Easing Functions,All,Linear motion feels robotic,Use ease-out in both directions entering and exiting,Use linear for UI transitions,ease-out,linear,Low
 15,Layout,Z-Index Management,Web,Stacking context conflicts cause hidden elements,Define z-index scale system (10 20 30 50),Use arbitrary large z-index values,z-10 z-20 z-50,z-[9999],High
 16,Layout,Overflow Hidden,Web,Hidden overflow can clip important content,Test all content fits within containers,Blindly apply overflow-hidden,overflow-auto with scroll,overflow-hidden truncating content,Medium
 17,Layout,Fixed Positioning,Web,Fixed elements can overlap or be inaccessible,Account for safe areas and other fixed elements,Stack multiple fixed elements carelessly,Fixed nav + fixed bottom with gap,Multiple overlapping fixed elements,Medium

package/dist/agent-src/skills/design-intelligence/references/context-and-registers.md

@@ -78,6 +78,23 @@ config, not a vibe — never re-infer when `DESIGN.md` already sets them
 | default / unstated | 5–6 | 3–4 | 4–5 |
 | data-dense / dashboard / admin / cockpit | 4–6 | 2–3 | 7–9 |
 | bold / playful / expressive / awards / Dribbble | 8–10 | 7–10 | 3–5 |
+| **DISQUALIFIER** — brief `frequency: high` or `initiation: keyboard` | — | **cap 3** | — |
+
+The Motion row is the one dial with a **disqualifier**, and it outranks the
+brief signal above it rather than averaging with it. The two brief fields it
+reads are `frequency` and `initiation` ([`fe-design`](../../fe-design/SKILL.md)
+§ The loop, step 2): a surface used 100-plus times a day, or reached by
+keyboard, does not get a high Motion dial however expressive the rest of the
+brief reads. A keyboard-initiated surface is reached by someone who already
+knows where they are going, so the animation is latency they pay on every
+invocation — the decision tree in
+[`design-patterns.md`](../../fe-design/references/design-patterns.md) § Motion
+answers "should this animate at all" with *no* for exactly this case, and a
+dial that could still reach 9 would contradict it.
+
+A `bold / playful` brief on a command palette therefore resolves to `V 8–10 ·
+M ≤ 3 · D 3–5`, and the cap is stated in the Design Read line so the user can
+see it fired rather than wondering why the motion is flat.
 
 **Dial → downstream levers** (how a dial value changes generation):
 

package/dist/agent-src/skills/design-intelligence/references/design-rules-checklist.md

@@ -25,7 +25,7 @@
 | 4 | Style Selection | HIGH | `style`, `product` | Match product type, Consistency, SVG icons (no emoji) | Mixing flat & skeuomorphic randomly, Emoji as icons |
 | 5 | Layout & Responsive | HIGH | `ux` | Mobile-first breakpoints, Viewport meta, No horizontal scroll | Horizontal scroll, Fixed px container widths, Disable zoom |
 | 6 | Typography & Color | MEDIUM | `typography`, `color` | Base 16px, Line-height 1.5, Semantic color tokens | Text < 12px body, Gray-on-gray, Raw hex in components |
-| 7 | Animation | MEDIUM | `ux` | Duration 150–300ms, Motion conveys meaning, Spatial continuity | Decorative-only animation, Animating width/height, No reduced-motion |
+| 7 | Animation | MEDIUM | `ux` | Duration within the authority's per-interaction bands, Motion conveys meaning, Spatial continuity | Decorative-only animation, Animating width/height, No reduced-motion |
 | 8 | Forms & Feedback | MEDIUM | `ux` | Visible labels, Error near field, Helper text, Progressive disclosure | Placeholder-only label, Errors only at top, Overwhelm upfront |
 | 9 | Navigation Patterns | HIGH | `ux` | Predictable back, Bottom nav ≤5, Deep linking | Overloaded nav, Broken back behavior, No deep links |
 | 10 | Charts & Data | LOW | `chart` | Legends, Tooltips, Accessible colors | Relying on color alone to convey meaning |
@@ -146,16 +146,16 @@
 
 ### 7. Animation (MEDIUM)
 
-- `duration-timing` - Use 150–300ms for micro-interactions; complex transitions ≤400ms; avoid >500ms (MD)
+- `duration-timing` - Use the per-interaction bands in `design-patterns.md` § Motion; never above 500ms (MD)
 - `transform-performance` - Use transform/opacity only; avoid animating width/height/top/left
 - `loading-states` - Show skeleton or progress indicator when loading exceeds 300ms
 - `excessive-motion` - Animate 1-2 key elements per view max
-- `easing` - Use ease-out for entering, ease-in for exiting; avoid linear for UI transitions
+- `easing` - Use ease-out in both directions, entering and exiting; avoid linear for UI transitions
 - `motion-meaning` - Every animation must express a cause-effect relationship, not just be decorative (Apple HIG)
 - `state-transition` - State changes (hover / active / expanded / collapsed / modal) should animate smoothly, not snap
 - `continuity` - Page/screen transitions should maintain spatial continuity (shared element, directional slide) (Apple HIG)
 - `parallax-subtle` - Use parallax sparingly; must respect reduced-motion and not cause disorientation (Apple HIG)
-- `spring-physics` - Prefer spring/physics-based curves over linear or cubic-bezier for natural feel (Apple HIG fluid animations)
+- `spring-physics` - Prefer critically damped spring curves (no overshoot) over linear for natural feel (Apple HIG fluid animations)
 - `exit-faster-than-enter` - Exit animations shorter than enter (~60–70% of enter duration) to feel responsive (MD motion)
 - `stagger-sequence` - Stagger list/grid item entrance by 30–50ms per item; avoid all-at-once or too-slow reveals (MD)
 - `shared-element-transition` - Use shared element / hero transitions for visual continuity between screens (MD, HIG)

package/dist/agent-src/skills/design-review/SKILL.md

@@ -1,7 +1,7 @@
 ---
 model_tier: high
 name: design-review
-description: "When the user says \"review the design\", \"check the UI\", or wants a comprehensive UI/UX review. Uses a 7-phase methodology covering interaction, responsiveness, accessibility and more."
+description: "When the user says \"review the design\", \"check the UI\", or wants a comprehensive UI/UX review. 7 phases: interaction, responsiveness, accessibility. Inventory via existing-ui-audit."
 domain: quality
 enforced_by:
   - "instruction-only: the Phase 4 sweep claims WCAG 2.1 AA and its criteria table is a deliberate SUBSET — depth is delegated to accessibility-auditor, which claims 2.2 AA and carries the resolver. No resolver checks this table against 2.1, so the claim is model-carried and the gap is recorded rather than implied."

package/dist/agent-src/skills/design-variations/SKILL.md

@@ -1,7 +1,7 @@
 ---
 model_tier: inherit
 name: design-variations
-description: "Produce 3+ substantively distinct hi-fi design variations — basic to bold, one file with tweak controls — when the user asks for options, alternatives, or \"show me a few takes\"."
+description: "Produce 3+ distinct hi-fi design variations — basic to bold, one file with tweak controls — when the user asks for options, alternatives, \"show me a few takes\". Extends fe-design."
 domain: product
 personas: []
 workspaces:

package/dist/agent-src/skills/existing-ui-audit/SKILL.md

@@ -1,7 +1,7 @@
 ---
 model_tier: high
 name: existing-ui-audit
-description: "Use BEFORE writing or editing any non-trivial UI — inventories components, design tokens, shadcn primitives, and reusable patterns into state.ui_audit. Hard gate for the ui directive set."
+description: "Use BEFORE writing or editing any non-trivial UI — inventories components, design tokens, shadcn primitives, and reusable patterns into state.ui_audit. Hard gate for fe-design."
 personas:
   - frontend-engineer
 domain: discovery

package/dist/agent-src/skills/fe-design/SKILL.md

@@ -1,7 +1,7 @@
 ---
 model_tier: medium
 name: fe-design
-description: "Frontend design heuristics — and, outside the ticket engine, the loop that applies them: audit, brief, inventory, build, review. Use when building or changing any UI, not only when planning one."
+description: "Frontend design heuristics and the loop applying them: existing-ui-audit, brief, inventory, build, review. Use when building or changing any UI, not only when planning one."
 personas:
   - frontend-engineer
 domain: engineering
@@ -46,10 +46,37 @@ else runs the loop.
 1. **Audit first** — run [`existing-ui-audit`](../existing-ui-audit/SKILL.md).
    What already exists (components, tokens, layout conventions) outranks every
    heuristic below. Reinventing an existing component is the #1 failure mode.
-2. **Brief** — cover the same five keys the engine requires before any code:
-   `layout`, `components`, `states`, `microcopy`, `a11y`. `states` means all
-   five of `empty`, `loading`, `error`, `success`, `disabled` — a brief missing
-   one is unfinished, not concise.
+2. **Brief** — seven keys before any code. Five are the ones the engine gates
+   (`REQUIRED_BRIEF_KEYS`): `layout`, `components`, `states`, `microcopy`,
+   `a11y`. `states` means all five of `empty`, `loading`, `error`, `success`,
+   `disabled` — a brief missing one is unfinished, not concise.
+
+   Two more are **declared, not gated**: `frequency` and `initiation`. The
+   engine does not halt on them, and that is stated rather than left to be
+   discovered — adding a required key would halt every brief already written
+   against the five.
+
+   | Key | Values | Why it is declared and never inferred |
+   |---|---|---|
+   | `frequency` | `one-time` · `low` · `medium` · `high` (100+ per day) | How often a surface is used decides whether motion on it reads as polish or as a toll. Nothing in a diff reveals it. |
+   | `initiation` | `keyboard` · `pointer` · `system` | A keyboard-initiated surface is reached by someone who already knows where they are going; an animation there is pure latency. |
+
+   Both are prefilled from the surface's role and overridden only on evidence.
+   There is no resolver and no inference from handlers: a `mousemove` listener
+   is not proof of pointer initiation, and a keyboard shortcut in the code is
+   not proof anyone uses it.
+
+   | Surface role | `frequency` | `initiation` |
+   |---|---|---|
+   | Command palette | `high` | `keyboard` |
+   | Tooltip | `high` | `pointer` |
+   | Modal / sheet | `medium` | `pointer` |
+   | Onboarding flow | `one-time` | `pointer` |
+   | Toast / notification | `medium` | `system` |
+   | Table row action | `high` | `pointer` |
+
+   The default for a role not listed is `medium` / `pointer`, stated in the
+   brief as a default rather than left blank.
 3. **Inventory — only when an artifact was provided, and before you build.**
    List the artifact's **interactions, keyframes, and script includes** from its
    source (`design-fidelity-mechanics` § Data-basis ladder — read it, do not

package/dist/agent-src/skills/fe-design/references/craft-floor.md

@@ -43,6 +43,13 @@ the moment the floor has to be present. Same content, later delivery.
     An undeclared pick is an undeclared choice (T7).
 12. **Zero silent drops.** A mechanic present in a supplied source and absent
     from the output, with no `flagged` entry, is a silent drop.
+13. **Shipped motion carries a `feel` line naming its method.** Duration and
+    easing being inside the bands in
+    [`design-patterns.md`](design-patterns.md) § Motion is a static check, and
+    motion that passes it can still be wrong to watch. The line names one of
+    `slow-motion` · `frame-step` · `device` · `next-day` and its outcome; an
+    outcome of `unbacked` is legal, an absent method is not
+    (`docs/contracts/evidence-artifact-types.md` § `feel`).
 
 ## What is NOT on this page
 

package/dist/agent-src/skills/fe-design/references/design-patterns.md

@@ -152,6 +152,16 @@ Step indicator (1 — 2 — 3)
 
 ## Motion — decision-tree and rationale
 
+This section is the **sole carrier** of motion duration bands, easing choice and
+the bounce prohibition; the five files that restate any of them are bound to the
+values below and are checked against them by
+`src/scripts/lint_motion_authority_drift.ts`:
+`src/skills/design-intelligence/references/design-rules-checklist.md`,
+`src/skills/design-intelligence/data/ux-guidelines.csv`,
+`src/skills/design-intelligence/data/app-interface.csv`,
+`src/skills/design-intelligence/data/styles.csv`,
+`src/skills/design-intelligence/data/motion.csv`.
+
 Before adding any animation to a UI element, run through this decision tree:
 
 **1. Should this animate at all?**
@@ -162,8 +172,8 @@ Before adding any animation to a UI element, run through this decision tree:
 
 **2. Which easing?**
 - Entering (element appearing)? **ease-out** (starts fast, slows to rest). Why: the element arriving quickly signals responsiveness; the deceleration feels natural as it settles.
-- Exiting (element disappearing)? **ease-in** (starts slow, accelerates out). Why: the reverse is true — fast exit signals completion.
-- **Never ease-in for entering elements.** Why: ease-in delays the initial movement — the exact moment the user is watching most closely — making it feel slow even at the same total duration.
+- Exiting (element disappearing)? **ease-out** as well. Why: one curve in both directions is the value a reader can hold and a gate can check; the field has no settled answer on exit easing, so a single shared curve removes the contradiction between carriers instead of propagating it. This line settles the **curve** only — how long an exit runs relative to its enter is a separate question it does not answer.
+- **Never ease-in, in either direction.** Why: ease-in delays the initial movement — the exact moment the user is watching most closely — making it feel slow even at the same total duration.
 - **Never bounce or elastic easing in UI.** Why: bounce draws attention to the animation itself, not the content; it feels dated.
 
 **3. How long?**
@@ -199,6 +209,41 @@ The six interaction states every interactive element must assert are
 [`design-review`](../../design-review/SKILL.md)'s; this entry is the motion half
 of the hover one.
 
+**6. Which mechanism carries it?**
+
+Steps 1-5 decide *whether* and *how much*. This step decides *with what*, and it
+is the step the tree used to skip: a CSS `transition` was the implicit answer to
+everything, which is why an entry animation on a `<dialog>` or a popover
+silently does nothing and a shared-element route change gets hand-rolled.
+
+- **A CSS `transition` on `transform` and `opacity`** is the default and covers
+  most of steps 1-5. Reach past it only for the cases below.
+- **An element entering or leaving the DOM, or the top layer** (`<dialog>`,
+  `popover`) has no "before" state to transition from and is gone before an exit
+  could run. That is what `@starting-style` is for — it supplies the entry's
+  starting values — together with `transition-behavior: allow-discrete` so
+  `display` and `overlay` participate instead of snapping. Without both, the
+  animation is not slow or wrong; it does not happen.
+- **The Web Animations API** (`Element.animate()`) is the mechanism when the
+  values are computed at runtime, when the animation must be interruptible
+  (`Animation.cancel()`, `.reverse()`, `.finished`), or when several elements
+  share one timeline. A keyframe set known at author time does not need it.
+- **A view transition** (`document.startViewTransition()`) is the mechanism for
+  a state or route change where an element persists across the change. It is the
+  first-party form of what a hand-built shared-element transition approximates,
+  and it is the case the 300-500ms page-transition band is for.
+- **`transform-origin`** decides where a `scale()` grows from. A menu or popover
+  scaling in should originate at its trigger, not at its own centre, or it reads
+  as arriving from nowhere. Scale in from ~0.96, never from `scale(0)`: growing
+  from nothing is an entrance, and steps 1-2 asked for feedback.
+- **`@media (hover: hover)`** gates any hover-carried motion. Without it a touch
+  device fires the hover treatment on tap and leaves it stuck, because there is
+  no pointer to leave.
+
+All six still obey step 3's bands, step 2's single `ease-out` curve, and the
+`@media (prefers-reduced-motion: reduce)` requirement above — a newer mechanism
+is not an exemption from the authority, it is another way of spending it.
+
 **4. What to animate?**
 Animate `transform` and `opacity` only. Why: these run on the GPU compositor thread, not the main thread; they never trigger layout or paint.
 `scale(0)` → `scale(1)` is wrong. Why: nothing in the real world appears from nothing. Use `scale(0.95)` + `opacity: 0` → `scale(1)` + `opacity: 1` instead.

package/dist/agent-src/skills/laravel-scheduling/SKILL.md

@@ -118,7 +118,9 @@ Schedule::command('queue:work')->everyMinute()->evenInMaintenanceMode();
 ## Running the scheduler
 
 ```bash
-# The scheduler itself runs every minute via system cron
+# The scheduler itself runs every minute via system cron.
+# cron has no working directory to inherit, and artisan takes no directory
+# flag, so the `cd` is the shape here rather than a habit worth replacing.
 * * * * * cd /path-to-project && php artisan schedule:run >> /dev/null 2>&1
 
 # Test locally

package/dist/agent-src/skills/project-analyzer/SKILL.md

@@ -350,12 +350,6 @@ After detecting **any** match, record the stack in the analysis output and selec
 2. Tech stack inventory with versions and dependencies
 3. Architecture diagram or module map
 
-## Auto-trigger keywords
-
-- project analysis
-- codebase analysis
-- architecture analysis
-
 ## Gotcha
 
 - Full project analysis can take several minutes — warn the user about the time investment.

package/dist/agent-src/skills/react-native-setup/SKILL.md

@@ -113,8 +113,8 @@ Before installing or upgrading anything, inspect what's already there — modify
 - Stuck pods: `pod deintegrate && pod install`.
 
 **Build failures**
-- Clean iOS: `cd ios && rm -rf build Pods Podfile.lock && pod install && cd ..`.
-- Clean Android: `cd android && ./gradlew clean && cd ..`.
+- Clean iOS: `rm -rf ios/build ios/Pods ios/Podfile.lock` then `pod install --project-directory=ios`.
+- Clean Android: `./gradlew -p android clean`.
 - Clear Xcode derived data when stale build artefacts persist.
 
 **New Architecture issues**
@@ -142,7 +142,7 @@ echo $ANDROID_HOME      # non-empty
 ```bash
 npx @react-native-community/cli init MyProject
 cd MyProject
-cd ios && RCT_NEW_ARCH_ENABLED=1 pod install && cd ..
+RCT_NEW_ARCH_ENABLED=1 pod install --project-directory=ios
 npm start                # Metro
 npm run ios              # in a second terminal
 npm run android          # in a third terminal

package/dist/agent-src/skills/react-shadcn-ui/SKILL.md

@@ -1,7 +1,7 @@
 ---
 model_tier: medium
 name: react-shadcn-ui
-description: "Use when building React UI on shadcn/ui primitives + Tailwind — the apply/review/polish skill dispatched by `directives/ui/*` for the `react-shadcn` stack."
+description: "Building React UI on shadcn/ui primitives + Tailwind — the apply/review/polish skill dispatched by `directives/ui/*` for the `react-shadcn` stack; idiom from tailwind-engineer."
 domain: engineering
 workspaces:
   - engineering

package/dist/agent-src/skills/sequential-thinking/SKILL.md

@@ -129,12 +129,22 @@ Explore alternatives when:
 1. Numbered reasoning steps with conclusions
 2. Final answer or recommendation with confidence level
 
-## Auto-trigger keywords
+## Tool availability — this is a procedure, not a tool call
 
-- problem solving
-- step-by-step
-- reasoning
-- decomposition
+Everything above runs **in-session**: it is a way of structuring reasoning, and
+it needs nothing installed.
+
+The wider MCP ecosystem carries a `sequentialthinking` server exposing a tool of
+that name. **This package registers no MCP server** — `mcp.json` ships
+`{"servers": {}}` — so on a default install that tool is not present, and
+nothing here tries to call it. Registering one is a consumer-side install
+decision this package deliberately does not make for you.
+
+So a reader on a default install can answer the question directly: the tool is
+not available to you, and none of this skill depends on it. If you have
+registered such a server yourself, the once-per-task limit below governs that
+call too — the limit is about looping, not about which mechanism does the
+thinking.
 
 ## Gotcha
 
@@ -145,9 +155,9 @@ Explore alternatives when:
 ## Do NOT
 
 - Do NOT use this for simple, well-understood tasks — it adds unnecessary overhead.
-- Do NOT call `sequentialthinking` more than **once per task**. If you're calling it repeatedly,
-  you're looping — stop and act directly instead.
-- Do NOT use `sequentialthinking` as a "thinking proxy" — if the task is "view a file" or
+- Do NOT run this procedure more than **once per task**. If you are reaching for it
+  repeatedly, you are looping — stop and act directly instead.
+- Do NOT use it as a "thinking proxy" — if the task is "view a file" or
   "run a command", just do it. No thinking step needed.
 - Do NOT skip the validation step — always check the solution against the original problem.
 - Do NOT ignore contradictions — they are signals, not noise.

package/dist/agent-src/skills/tailwind-engineer/SKILL.md

@@ -1,7 +1,7 @@
 ---
 model_tier: medium
 name: tailwind-engineer
-description: "Use when writing or reviewing Tailwind CSS — utility-first, design-token discipline, no inline-style drift, responsive variants, dark mode — even on 'style this' or 'mach das hübsch'."
+description: "Writing or reviewing Tailwind CSS — utility-first, design tokens, no inline-style drift, responsive variants, dark mode — 'style this' or 'mach das hübsch'. Pairs with react-shadcn-ui."
 personas:
   - frontend-engineer
 domain: engineering

package/dist/agent-src/skills/ui-apply-generic/SKILL.md

@@ -1,7 +1,7 @@
 ---
 model_tier: medium
 name: ui-apply-generic
-description: "Use when implementing a UI brief on a stack with no framework executor — Svelte, Astro, Angular, plain HTML. Carries the stack-independent contract; idiom comes from the stack corpus."
+description: "Use when implementing a UI brief on a stack with no framework executor — Svelte, Astro, Angular, plain HTML. Stack-independent sibling of react-shadcn-ui; idiom from the stack corpus."
 personas:
   - frontend-engineer
 domain: engineering

package/dist/agent-src/skills/ui-component-architect/SKILL.md

@@ -1,7 +1,7 @@
 ---
 model_tier: high
 name: ui-component-architect
-description: "Use when shaping a UI component tree — composition vs inheritance, slot patterns, prop API design, controlled vs uncontrolled, polymorphic — even on 'split this component'."
+description: "Shaping a UI component tree — composition vs inheritance, slot patterns, prop API design, controlled vs uncontrolled, polymorphic — on 'split this component'. Feeds react-shadcn-ui."
 personas:
   - frontend-engineer
 domain: engineering

package/dist/agent-src/skills/using-git-worktrees/SKILL.md

@@ -105,7 +105,9 @@ Ask format:
 
 > 1. `.worktrees/` — project-local, hidden
 > 2. `worktrees/` — project-local, visible
-> 3. `~/.event4u/agent-config/worktrees/<project>/` — global
+> 3. `~/.event4u/agent-config/worktrees/<project>/` — global, **outside the
+>    repository root**: costs the persistent shell cwd (see below) and requires
+>    declaring the parent in the host's working-directory allowlist
 
 **Recommendation: 1 — `.worktrees/`** — project-local keeps the worktree next to the repo (easy cleanup), and the leading dot keeps it out of `ls`. Caveat: pick 3 if multiple repos must share a single worktree root.
 
@@ -135,9 +137,22 @@ passes. For the global location, skip — path is outside the repo.
 
 ```bash
 git worktree add .worktrees/<branch-name> -b <branch-name>
-cd .worktrees/<branch-name>
 ```
 
+**Then address the worktree by flag, not by `cd`.** Every tool that matters
+takes a directory flag, and the flag survives where a `cd` does not:
+
+```bash
+git -C .worktrees/<branch-name> status
+npm --prefix .worktrees/<branch-name> test
+composer -d .worktrees/<branch-name> install
+```
+
+A `cd X && …` compound re-enters the directory on every single call, and the
+one call that forgets it edits the main checkout silently — the failure is
+invisible because the command succeeds. Where a tool genuinely has no directory
+flag, use a subshell so the change cannot leak: `( cd <path> && <cmd> )`.
+
 Branch names must match the project convention — see
 `commit-conventions` rule.
 

package/dist/agent-src/templates/agents/agent-project-settings.example.yml

@@ -39,7 +39,7 @@ schema_version: 1
 # CI guard: a release bump of `package.json` must update this value
 # in lockstep — see scripts/check_template_pin_drift.ts (road-to-
 # portable-runtime-and-update-check P3.3).
-agent_config_version: "14.18.0"
+agent_config_version: "14.19.0"
 
 # --- Project identity ---
 project:

package/dist/cli/commands/recordTriggerEval.js

@@ -3,7 +3,7 @@
  *
  * Records a live trigger-eval result into a corpus manifest's `upstream`
  * block (the second half of the corpus-refresh DoD, ADR-061 §6). It does
- * NOT run the eval — `skill_trigger_eval.py`'s confirmation gate hard-aborts
+ * NOT run the eval — `skill_trigger_eval`'s confirmation gate hard-aborts
  * under automation by design, so the live run stays a human, interactive
  * step. This command is a *post-processor*: it reads the `EvalResult` JSON the
  * live run wrote (`--output`), enforces a precision/recall floor, and writes
@@ -36,7 +36,7 @@ import { logger } from '../log/logger.js';
 // Floors shared with the weekly canary rotation (ADR-118 §4) — values
 // unchanged, single source of truth.
 import { floor_for } from '../../scripts/_lib/trigger_eval_floors.js';
-/** Subset of `skill_trigger_eval.py`'s `EvalResult` we depend on. */
+/** Subset of `skill_trigger_eval`'s `EvalResult` we depend on. */
 const EvalResultSchema = z.object({
     skill: z.string().optional(),
     model: z.string().optional(),

package/dist/cli/main.js

@@ -83,7 +83,7 @@ async function main(rawArgv) {
     program
         .command('eval:record')
         .description('Record a live trigger-eval result into a corpus manifest (ADR-061 §6 refresh DoD)')
-        .requiredOption('--eval-json <path>', 'EvalResult JSON written by skill_trigger_eval.py --output')
+        .requiredOption('--eval-json <path>', 'EvalResult JSON written by skill_trigger_eval --output')
         .requiredOption('--manifest <path>', 'corpus manifest.json to patch')
         .option('--min-recall <n>', 'Recall floor override (per-skill default otherwise)', (v) => Number.parseFloat(v))
         .option('--min-precision <n>', 'Precision floor override (per-skill default otherwise)', (v) => Number.parseFloat(v))