AGENTS.md

AGENTS.md — AI Agent Quick Reference

One-Line Invocation

Read fuji-setup.task.md and install Fujifilm simulation profiles for Lightroom Classic on this machine.

The task file is self-contained. This card is a technical cheat sheet for common issues.

Key Technical Facts

Fact	Detail
Grayscale bug	crs:ConvertToGrayscale="True" in .xmp → Camera Raw grayscales before LUT. Auto-set by dialog, no UI toggle. Fix: change to "False".
Presets panel gap	Look profiles appear in Profile Browser, not Presets panel. Fix: generate stub .xmp with <crs:Look crs:Stubbed="true"> referencing Look UUID.
Adobe Standard Linear	Does NOT exist on macOS CR 18.4. Adding crs:CameraProfile="Adobe Standard Linear" causes the xmp to be silently ignored.
LUT encoding	Adobe's .xmp uses proprietary 85-char base-85 variant. Decoding not required (use pre-built profiles).
Cube axis order	abpy's cubes use standard IRIDAS order (B fast, G med, R slow). Camera Raw reads correctly. No axis swap needed.
AI model prompt	macOS LRC 14.x + CR 18.4 (cracked) may trigger AI download on Presets panel. Profile Browser unaffected.

Execution Flow

Read fuji-setup.task.md
  → Phase 0: Detect OS (macOS/Windows)
  → Phase 1: Acquire cube LUTs (clone abpy or use local)
  → Phase 2: Create Camera Raw profiles (guide user through PS dialog)
  → Phase 3: Fix grayscale bug (python3 scripts/fix_profiles.py)
  → Phase 4: Generate Presets stubs (python3 scripts/generate_stubs.py)
  → Phase 5: Verify (python3 scripts/install.py --verify)

OS Paths

Platform	Settings Directory
macOS	~/Library/Application Support/Adobe/CameraRaw/Settings/
Windows	%AppData%\Adobe\CameraRaw\Settings\

Quick Diagnostics

Symptom	Command	Fix
Profiles missing	ls <dir>/Fuji*.xmp	Delete Index_*.dat, restart LRC
Still gray	grep ConvertToGrayscale <dir>/Fuji*.xmp	Re-run fix_profiles.py
Stubs missing	ls <dir>/*LUT.xmp	Re-run generate_stubs.py
Permission denied	ls -la <dir>/Fuji*.xmp	chmod 644