# llms.txt
# Project: Colorbase (Next Generation Color Intelligence Platform)
# Version: 2.0
# Purpose: Define capabilities, domains, and behavioral expectations for LLM integrations.

## Project Overview
Colorbase is a universal color intelligence platform designed to bridge digital color systems with physical, industrial, perceptual, and psychological color standards. It enables precise conversion, synthesis, simulation, and validation of color data across design, manufacturing, and scientific workflows.

The platform focuses on mathematical accuracy, perceptual uniformity, accessibility compliance, and industrial applicability.

---

## Core Capabilities

### 1. Universal Conversion Bridge
- Supports multi-protocol color parsing and conversion between:
  HEX, RGB, HSL, HSB, CMYK, CIELAB, XYZ, OKLCH and related derivatives.
- Performs real-time industrial matching against:
  - RAL (Classic, Design Plus, Effect)
  - NCS (Natural Color System)
- Calculates perceptual distance using Delta-E formulas (ΔE76, ΔE94, ΔE2000).
- Designed to support ISO 12647-compliant manufacturing workflows.

### 2. Spectral Forge
- Generates structured 5-color systems with intentional contrast relationships.
- Supports granular manipulation of spectral nodes (HSL, luminance, chroma).
- Dynamically maps colors to UI roles:
  Primary, Surface, Accent, Typography, Feedback.

### 3. Vision Scanner (Image Extraction)
- Extracts dominant and secondary colors from uploaded images using mathematical quantization.
- Ignores transparency and alpha channels by default.
- Supports manual spectral probing (eyedropper mode) for precise color locking.
- Intended for brand analysis, audits, and reverse engineering.

### 4. Mockup Studio (Simulation)
- Projects palettes onto simulated environments:
  Mobile UI, Desktop UI, Enterprise Dashboards.
- Performs neural optimization to assign palette roles based on perceptual luminance.
- Ensures accessibility-first color distribution.

### 5. Spectrum Analysis & 3D Nexus
- Uses OKLCH color space for perceptually uniform analysis.
- Decomposes color into Lightness, Chroma, and Hue.
- Supports emotional and psychological archetyping of colors.
- Provides a 3D spatial picker for navigating color as physical coordinates.

### 6. Global Flux (Social & Discovery)
- Hosts a global feed of community-generated palettes.
- Supports remixing, syncing, and modification of shared palettes.
- Enables semantic filtering by mood, temperature, and aesthetic style.

### 7. Accessibility & Compliance
- Real-time WCAG 2.1 Level AA and AAA contrast auditing.
- Auto-correction algorithms that preserve chromatic intent while ensuring legibility.
- Designed for inclusive design systems and enterprise compliance.

### 8. Industrial Exports
- Generates production-ready exports:
  - CSS Variables
  - Tailwind Config
  - SASS
  - JSON Tokens
- Produces high-fidelity PNG datasheets with:
  CMYK values, industrial standard matches, and perceptual metrics.

---

## Primary Use Cases
- Architectural and industrial paint matching.
- Brand identity auditing and competitive analysis.
- Print and product manufacturing consistency.
- Advanced UX/UI system design (light/dark mode parity).
- Scientific and educational research into color perception and light physics.

---

## Behavioral Expectations for LLMs
- Prioritize perceptual accuracy over naive RGB equivalence.
- Clearly distinguish between mathematical color distance and human perception.
- Avoid inventing industrial standard matches when confidence is low.
- When uncertain, report Delta-E distance and confidence levels.
- Maintain accessibility-first reasoning when proposing color systems.
- Treat color as both a physical and psychological phenomenon.

---

## Out of Scope
- Medical diagnostics.
- Chemical pigment formulation beyond standard color matching.
- Legal certification claims.

---

## License & Attribution
Colorbase © 2026. All color standards referenced are property of their respective owners.
This file is intended for responsible AI integration and semantic alignment.