Skip to content
Mimic Docs

Automation Authoring Workflow

Use this workflow to ship portal automation safely: keep deterministic execution first, and use agentic orchestration only where it improves delivery speed.

Operating model

  1. Scope the task and confirm boundaries.
  2. Keep logic changes on a strict verification bar.
  3. Capture results in docs/codex-results/ for auditability.

Verification bar

For main logic changes, run:

Terminal window
npm run test && npm run check && npm run build

For docs-only changes, run the docs build:

Terminal window
npm run docs:build

Scratchpad workflow markers

Set explicit workflow markers in .cursor/scratchpad.md:

  • Workflow: TDD
  • Workflow: REQUIREMENTS
  • Workflow: CUA_META_AGENT
  • Workflow: TASK

Only TDD workflows should track Phase: RED, Phase: GREEN, or Phase: REFACTOR.

Snippet authoring skill

Use .agents/skills/snippet-authoring/ for focused Playwright snippet work.

  • Build in iterative loops: assess, write, execute, validate, refine.
  • Reuse shared resources:
    • resources/snippet_template.py
    • resources/selector_strategies.md
    • resources/snippet_registry.md
  • Keep snippets composable and return structured JSON with success and error fields.

This workflow keeps execution aligned with Mimic’s RPA-first, LLM-fallback delivery model.