assistant-architect

Assistant Architect

Create valid JSON import files for PSD AI Studio's Assistant Architect system.

Spec Reference: See references/json-spec.md for complete field definitions and validation rules.

---

Input Modes

From Screenshot

When the user provides a screenshot, extract:

Element	Maps To
Text input boxes	short_text (single line) or long_text (multi-line)
Dropdowns/select menus	select with choices from visible options
Checkboxes/multi-select	multi_select
File upload areas	file_upload
Field labels	label property
Placeholder text	options.placeholder
Visible instructions	system_context or prompt content
Step numbers/tabs	Multiple prompts in sequence

Also infer:

• Assistant name from title/header
• Description from any visible purpose text
• Prompt content from visible instructions or "what this does" text

Handling Collapsed Dropdowns

CRITICAL: When you see a dropdown in a screenshot but can't see its options (e.g., shows "Select subject" or has a dropdown arrow but options aren't expanded), you MUST resolve the options before generating JSON.

Resolution order:

1. Check if it matches a Common Field Library (see below)

   • "Grade", "Grade Level" → Use Grade Levels library
   • "Subject", "Content Area" → Use Subjects library
   • "State" → Use US States library
   • "Language" → Use Language library
   • "Tone", "Style" → Use Writing Tone library
   • "Format", "Output Format" → Use Output Format library

2. If no library match, ASK the user:

   I see a dropdown for "[Field Name]" but can't see the options.
   
   Options:
   a) Provide a screenshot with the dropdown expanded
   b) List the values that should appear (comma-separated)
   c) Describe the type of options (e.g., "departments in our district")
   

3. Never leave a select field without choices - this will cause import errors

Visual indicators of dropdowns:

• Dropdown arrow (▼ or chevron) on right side
• "Select..." placeholder text
• Bordered box that looks clickable but isn't a text input
• Different styling from text inputs (often lighter/grayed placeholder)