visual-intelligence-system-vislisted

# Visual Intelligence System (VIS) ## What VIS Does VIS is the visual asset management layer for ACOS. It ensures every image across your site is: - **Tagged** — auto-detected mood, theme, color palette, placement suitability - **Audited** — placeholders, duplicates, orphans, and oversized images detected - **Mapped** — every page linked to its images with coverage status - **Brand-aligned** — validated against your brand visual DNA ## Core Workflow ### 1. Always Query Registry First Before generating ANY new image, query the visual registry: ```bash # Find dark, atmospheric music images suitable for homepage jq '[.[] | select(.tags | contains(["music"])) | select(.mood == "atmospheric")]' data/visual-registry.json ``` If a suitable image exists, USE IT. Only generate new images when nothing fits. ### 2. Scan Images Rebuild the registry after adding new images: ```bash node scripts/scan-visual-registry.mjs # Full rebuild node scripts/scan-visual-registry.mjs --diff # Only new images node scripts/scan-visual-registry.mjs --report # Health summary ``` ### 3. Audit Visual Health Run automated quality checks: ```bash node scripts/audit-visual-health.mjs # Full audit with score node scripts/audit-visual-health.mjs --json # JSON for n8n/Slack ``` **Health Score Interpretation:** - 90-100: EXCELLENT — no action needed - 70-89: GOOD — minor issues to address - 50-69: NEEDS ATTENTION — several issues - 0-49: CRITICAL — immediate action required ### 4.