composition-director

Composition Director

Composition Director establishes the mathematical and perceptual skeleton of the visual before generation or rendering. It governs grid systems, focal hierarchy, eye paths, scale relationships, and negative space balance.

---

1. Core Workflow

1. Format & Canvas Setup:

   • Establish aspect ratio (e.g. 1:1, 4:5, 9:16, 16:9) and define outer margins and safety padding (minimum 6-8% margin).
   • Select grid system: Rule of Thirds, Golden Ratio, Diagonal Dynamic Grid, or Swiss Modular Grid.

2. Focal Anchor Architecture:

   • Primary Focal Anchor (Single): The hero element capturing immediate attention (occupies primary visual weight).
   • Secondary Anchor: Supporting narrative element or product context.
   • Tertiary Elements: Text blocks, badge, brand mark, and secondary accents.
   • Strict Rule: Exactly ONE primary focal point. Reject "equal-emphasis" where 3+ elements compete equally.

1. Perceptual Preflight Checks:

   • The Thumbnail Test: Scaled down to 100x100px, is the silhouette and hierarchy immediately clear?
   • The Grayscale Contrast Test: Stripped of color, do value contrasts maintain readable depth and clear separation?
   • Negative Space Audit: Ensure negative space is active and intentional, not trapped dead space.
   • Accidental Tangencies: Ensure overlapping elements have decisive overlap or clear separation; eliminate ambiguous touching edges.

2. Output Contract:

   • Return structured composition_state inside DesignSignalPacket containing grid specs, anchor coordinates, and negative space ratios.

---

2. Tools & Scripts

• Run design lint on Art Direction spec:

  python3 scripts/design_lint.py assets/art-direction.template.json
  

• Run design structural evals:

  python3 scripts/run_design_evals.py
  

---

3. Cross-Skill Neural Connections & References

Peer & Specialist Skills

• Typography Director — Text zone planning & typographic hierarchy
• Arabic RTL Director — Inverted RTL reading paths & Arabic layout balance
• Photography Director — Camera focal length, perspective & lighting depth
• Manipulation Director — Compositing scale, contact shadows & occlusion
• Visual Storytelling — Narrative storyboard arcs and eye path pacing
• Designly Director — Lead orchestrator and lock manager

Schemas & References

• Art Direction Schema — Local spec schema
• Creative Brief Schema — Local brief schema
• Layout, Grid, and Spacing — Spatial rules
• Composition and Photography — Perceptual mechanics
• Design Preflight — Thumbnail and contrast checks
• Gestalt and Perception — Visual grouping principles
• Inclusive Representation — Anti-bias composition