workshop-page-process.md 5.0 KB
Page Process Workshop
Purpose: Intelligent sketch analysis with context detection - handles both new and updated sketches
CONTEXT
This workflow activates when: User has a sketch/visualization ready to analyze.
Intelligence: Detects if this is a new page or update to existing specification.
Behavior:
- New page → Full analysis
- Updated page → Change detection, incremental update
- Partial completion → Specify ready sections, mark TBD
STEP 1: CONTEXT DETECTION
Determine page context:
- Read current page specification (if exists)
- Check for existing sketch versions
- Identify project structure (scenarios, pages)
- Store context information
This is the first sketch for this page!
Let me analyze what you've drawn and create the initial specification.
Route to: ../../steps-k/step-01-sketch-analysis.md (existing workflow)
I see we already have specifications for this page.
Let me compare this sketch to what we have...
Proceed to STEP 2: Change Detection
STEP 2: CHANGE DETECTION (For Existing Pages)
Compare new sketch to existing specifications:
- Load existing specification document
- Identify which sections are already specified
- Analyze new sketch for:
- Unchanged sections
- Modified sections
- New sections added
- Removed sections
- TBD sections now complete
- Complete sections now TBD
- Calculate confidence for each comparison
STEP 3: UPDATE STRATEGY
How would you like to proceed?
[A] Update all changed/new/completed sections [B] Pick specific sections to update [C] Show me detailed comparison first [D] Actually, this is the same - cancel
Choice:
Store user_choice
STEP 4A: UPDATE ALL (If user chose A)
**Updating all changed sections:** I'll process all modified, new, and completed sections while preserving unchanged sections. Ready to analyze sections?
For each section in (modified_sections + new_sections + completed_sections): Run 4b-sketch-analysis.md workflow for that section only Update specification document Preserve unchanged sections End
STEP 4B: SELECTIVE UPDATE (If user chose B)
Which sections should I update?
[List numbered sections with change type]
Enter numbers separated by commas (e.g., 1,3,5):
Parse selected_sections For each selected section: Run 4b-sketch-analysis.md workflow for that section Update specification document End
STEP 4C: DETAILED COMPARISON (If user chose C)
**Detailed Section-by-Section Comparison:** **See:** [page-process-templates.md](page-process-templates.md) for comparison template Display for each modified section: - Current specification summary - New sketch interpretation - Detected changes - Confidence level After reviewing, what would you like to do? [A] Update all [B] Pick specific sections [C] Cancel
Return to STEP 3 with user's choice
STEP 5: COMPLETION
✅ **Page specification updated!** **Summary:** - [X] sections updated - [X] sections added - [X] sections preserved (unchanged) - [X] sections removed **Updated file:** `{{page_spec_path}}` **Sketch saved to:** `{{sketch_path}}` Would you like to: [A] Generate HTML prototype [B] Add another page [C] Update another section [D] Done with this page Choice:ROUTING
Based on user choice:
- [A] → Load prototype generation workflow
- [B] → Return to page-init/step-01-page-context.md
- [C] → Return to STEP 3 (pick sections)
- [D] → Return to main UX design menu
KEY FEATURES
✅ Intelligent Context Detection
- Automatically knows if new or update
- Compares sketches to existing specs
- Identifies unchanged sections
✅ Incremental Updates
- Only updates what changed
- Preserves existing work
- No data loss
✅ Flexible Control
- Update all or select specific
- See detailed comparison
- Cancel anytime
INTEGRATION
This workshop uses:
- 4b-sketch-analysis.md - For actual section analysis
- guides/SKETCH-TEXT-ANALYSIS-GUIDE.md - For reading text markers
- page-specification.template.md - For document structure
- object-types/*.md - For component specifications
Created: December 28, 2025 For: Iterative page specification workflow Status: Ready to test with WDS Presentation page