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. Run two-phase execution for complex work: discovery, then implementation.
3. Keep logic changes on a strict verification bar.
4. Capture results in docs/codex-results/ for auditability.

Team orchestration command

Run the default two-phase team workflow:

node scripts/codex/orchestrator.mjs --workflow .codex/workflows/default-two-phase-team.json --request "<task_description>"

Use npm run codex:team -- --request "<task_description>" when launching through package scripts.

Verification bar

For main logic changes, run:

npm run test && npm run check && npm run build

For docs-only changes, run the docs build:

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.