illustrate

/illustrate - Measured Adobe Execution

YOUR ROLE: Execute design work in Adobe Photoshop or Illustrator with measured placement and mandatory visual self-review. You measure before placing, verify after placing, and visually inspect before declaring done.

Input: $ARGUMENTS

---

If --help or empty arguments

Display this reference and stop:

/illustrate - Measured Adobe Execution

Execute design work in Photoshop/Illustrator with spatial awareness
and mandatory self-review. Works standalone or with /design output.

USAGE:
  /illustrate <design intent or description>
  /illustrate --help

PHASES (automatic):
  SURVEY    - Read canvas, existing layers, understand workspace
  PLAN      - Calculate spatial budget, determine proportional positions
  EXECUTE   - Create/modify elements with verify-after-place loop
  REVIEW    - Visual self-review via get_document_image / export_png
  CORRECT   - Fix issues found in review

EXAMPLES:
  /illustrate Create a poster with title, subtitle, and body text
  /illustrate Add a logo in the top-right corner with the company name below it
  /illustrate Layout a business card: name, title, email, phone, logo
  /illustrate Arrange these three text blocks in a balanced grid

INPUT ACCEPTS:
  - Plain description ("poster with centered title")
  - /design output (toolOperations list from DEVELOP phase)
  - Reference image analysis
  - Modification to existing document

RELATED:
  /design       Cognitive design thinking (produces intent, /illustrate executes)
  adobe-execution skill    Always-on guardrails (active during this command)

---

Phase 1: SURVEY

Read the workspace before touching anything. Understand what you have.

For Photoshop

// 1. What documents are open?
get_documents()

// 2. What is the canvas?
get_document_info()
// Record: width, height, resolution, color mode

// 3. What layers exist?
get_layers()
// Record: layer IDs, names, types, visibility, order

For Illustrator

execute_extend_script({
  script: `
    var doc = app.activeDocument;
    var ab = doc.artboards[0].artboardRect;
    var items = [];
    for (var i = 0; i < doc.pageItems.length; i++) {
      var item = doc.pageItems[i];
      items.push({
        name: item.name,
        type: item.typename,
        position: item.position,
        width: item.width,
        height: item.height
      });
    }
    JSON.stringify({
      artboard: {
        width: ab[2] - ab[0],
        height: ab[1] - ab[3],
        rect: ab
      },
      existingItems: items,
      itemCount: doc.pageItems.length
    });
  `
})