# Repository Instructions

This repo is the public motion-agent discovery and authority layer for FrankX, Starlight, and Arcanea.

## Scope

- Maintain curated rankings, playbooks, skills, MCP notes, and rubrics for AI agents doing motion design.
- Prefer official sources, active repos, clear licenses, and examples that improve shipped output.
- Keep this repo public-safe: no private brand strategy, internal credentials, paid assets, client work, or non-public memory.

## Quality Bar

- Rank by usefulness to real agent workflows, not by hype or stars alone.
- Separate product UI motion, creative web motion, interactive assets, video generation, capture/QA, and MCP/design-tool context.
- Every new tool entry should answer: when to use it, why it matters, agent fit, risk, and source/license notes.
- Avoid giant unsorted lists. Curate aggressively.

## Maintenance

- Refresh external links and rankings at least monthly.
- Prefer primary links: official docs, official GitHub repos, vendor MCP docs, and standards.
- Keep `skills-lock.json` aligned with third-party skills actually referenced by the repo.
- Do not commit installed third-party skill folders unless the source license and purpose are explicit.

## Verification

- Before publishing, scan for broken Markdown links, stale dates, placeholders, and private/internal paths.
- If adding setup commands, verify they are current and make clear whether they are global, repo-local, or agent-environment-specific.

## Design Taste Kernel

For any site, app, landing page, dashboard, visual identity, brand, motion, media, social, or frontend task, apply the shared Design Taste Kernel before handoff:

- C:\Users\frank\starlight\repos\DESIGN_TASTE.md
- C:\Users\frank\starlight\repos\WEB_EXPERIENCE_STANDARD.md
- C:\Users\frank\starlight\repos\MOTION_TASTE_RUBRIC.md
- C:\Users\frank\starlight\repos\MULTI_AGENT_DESIGN_COUNCIL.md
- C:\Users\frank\starlight\repos\VISUAL_QA_GATE.md

When motion, scroll, generated media, GIF/video, or premium polish matters, route through the Motion Design Studio plugin/skills and verify the result visually.


<!-- PREMIUM-WEB-OS:START -->
## Premium Intelligence Web OS Adoption

This repo participates in the Starlight Premium Intelligence Web OS.

For any website, app, landing page, dashboard, brand surface, visual asset, motion system, 3D/WebGL scene, generated media, or public-facing UI work:

- Read the estate OS first: `C:\Users\frank\starlight\repos\_intelligence\README.md`.
- Use the activation contract: `C:\Users\frank\starlight\repos\_intelligence\adoption\activation-contract.md`.
- Treat `C:\Users\frank\starlight\repos\_intelligence\` as the source of truth for premium web taste, design, motion, WebGL, copy, assets, and quality gates.
- Use `/pwo` or the `premium-web-os` skill for full builds; use `/mad` for a design council pass.
- Use `/pwo review-pr` before absorbing another agent's PR or branch.
- Use `/pwo absorb-assets` before using external, generated, scientific, audio, video, or 3D assets.
- Use `/pwo motion-score` before shipping cinematic scroll, sound-paired motion, or complex choreography.
- Build static composition first, add Track A local motion second, add Track B GSAP/Lenis scroll only when earned, and add 3D only with fallback and reduced-motion behavior.
- Use VIS through `C:\Users\frank\starlight\repos\visual-intelligence` for asset provenance, curation packets, rights, and publication records.
- Use `C:\Users\frank\starlight\repos\_intelligence\visual-worlds\neural-cosmos.md` for neuroscience, cerebrum, spine, electron, signal, or golden spiral direction.
- Do not copy reference sites or agencies. Deconstruct principles and create original execution.
- Do not ship without responsive, accessibility, performance, reduced-motion, and visual QA checks appropriate to the change.

Repo-local instructions remain authoritative when stricter.
<!-- PREMIUM-WEB-OS:END -->