Athena — roomy-mobile/archive/changes/2026-01-05-add-per-screen-maestro-flows/tasks/001-setup-infrastructure.md


skill-level: senior status: done

Task: Setup Infrastructure

End Goal

Maestro directory restructured with updated config, mobile-mcp installed and configured for agent use.

Currently

  • .maestro/ contains flat structure with 3 flows (config, screenshot-auth-flow, screenshot-main-flow, test-flow)
  • No mobile-mcp integration
  • No tag-based organization

Should

  • .maestro/ restructured into screens/, utils/, orchestration/, and legacy/ subdirectories
  • config.yaml updated with tag definitions and device matrix documentation
  • mobile-mcp installed via Claude Code MCP configuration
  • Legacy flows preserved in legacy/ for reference

Constraints

  • [x] Must not break existing screenshot workflow during transition
  • [x] Must preserve original flows in legacy/ subdirectory
  • [x] Must use @mobilenext/mobile-mcp package (not ios-simulator-mcp)

Acceptance Criteria

  • [x] Directory structure matches design.md specification
  • [x] config.yaml contains tag definitions for: screenshot, auth, home, cleaning, shopping, payments, settings, utility, orchestration
  • [x] config.yaml documents device matrix in comments
  • [x] mobile-mcp responds to mcp-cli tools mobile-mcp command (requires running simulator)
  • [x] Original flows accessible at .maestro/legacy/

Implementation Checklist

  • [x] 1.1 Create new directory structure: screens/, utils/, orchestration/, legacy/
  • [x] 1.2 Move existing flows to legacy/ subdirectory
  • [x] 1.3 Update config.yaml with tags and device matrix documentation
  • [x] 1.4 Install mobile-mcp via Claude Code MCP config (claude mcp add mobile-mcp npx @mobilenext/mobile-mcp@latest)
  • [x] 1.5 Verify mobile-mcp connectivity with mcp-cli tools mobile-mcp (requires running simulator)

Notes

  • mobile-mcp requires Node.js v22+ and Xcode command line tools
  • iOS simulator or Android emulator must be running for mobile-mcp to function

Reacties

Nog geen reacties