Athena — roomy-mobile/archive/changes/2026-01-05-add-per-screen-maestro-flows/tasks/011-create-agent-documentation.md


skill-level: medior status: done

Task: Create Agent Documentation

End Goal

Comprehensive documentation enabling agents to programmatically invoke screen flows and capture screenshots.

Currently

  • instructions/maestro-*.md files document general Maestro usage
  • No documentation for per-screen flow invocation

Should

  • instructions/maestro-screen-flows.md - Per-screen flow reference with invocation examples
  • Updated instructions/maestro-mcp-tools-instructions.md - mobile-mcp integration

Constraints

  • [x] Must follow existing instructions file format
  • [x] Must document all 21 screen flows with parameters
  • [x] Must include device matrix and resolution requirements

Acceptance Criteria

  • [x] maestro-screen-flows.md documents all screen flows with parameters and examples
  • [x] Each flow has CLI invocation example
  • [x] Device matrix documented with exact resolutions
  • [x] mobile-mcp tools documented for agent use
  • [x] Troubleshooting section for common issues

Implementation Checklist

  • [x] 11.1 Create instructions/maestro-screen-flows.md with:
    • [x] Overview of per-screen architecture
    • [x] Directory structure reference
    • [x] Flow invocation examples for each screen
    • [x] Parameter reference table
    • [x] Device matrix (5 devices with resolutions)
  • [x] 11.2 Update instructions/maestro-mcp-tools-instructions.md with:
    • [x] mobile-mcp installation instructions
    • [x] Tool reference (mobile_take_screenshot, mobile_list_devices, etc.)
    • [x] Integration workflow examples
  • [x] 11.3 Add troubleshooting section for common issues

Notes

  • Reference existing maestro instruction files for format consistency
  • Include both Maestro CLI and mobile-mcp MCP invocation patterns

Reacties

Nog geen reacties