| name | zuora-uat-generate-feature |
| description | Internal worker — plan + generate-api + generate-ui + optional verify for one feature |
Generate feature worker (internal)
Inputs: feature, optional tr_filter (TR numbers), force_overwrite, verify, environment, max_fix_retries.
Flow (per TR in scope)
- Plan —
${CLAUDE_PLUGIN_ROOT}/skills/zuora-uat/plan/SKILL.md
- API script —
generate-api/SKILL.md (gap-fill)
- UI doc —
generate-ui/SKILL.md when hybrid (gap-fill)
- UI placement check (hybrid TRs only) — verify doc is in execution, not testplan (see below)
- On artifact rewrite: clear verification mark for that TR:
python3 "${CLAUDE_PLUGIN_ROOT}/references/uat-test/execution/scripts/uat_verification.py" clear \
--scenario-dir "$UAT_ROOT/execution/tests/test_scenarios/<folder>" --tr <n>
- Verify segment when
verify=true — verify/SKILL.md with environment
- When
verify=false: set verified: false for affected TRs (same clear command as step 5, per TR in scope)
- Required — finalize verification marks before returning JSON:
python3 "${CLAUDE_PLUGIN_ROOT}/references/uat-test/execution/scripts/uat_verification.py" finalize-generate \
--git-root "$GIT_ROOT" \
--feature "<feature>" \
--verify "<verify>"
UI placement check (after step 3, hybrid TRs)
Fail fast if ui_steps_tr{n}.md is missing from execution or present under testplan:
PYTHONPATH="$UAT_ROOT/execution/tests" python3 -c \
"from test_utils.repo_paths import resolve_ui_steps_doc_path; resolve_ui_steps_doc_path('<feature>', '<TRn>')"
test -z "$(find "$UAT_ROOT/design/testplan" -path '*<feature>*' -name 'ui_steps_tr*.md' -print)"
On failure: move misplaced file from testplan to the resolved execution path (or delete and rewrite), then retry the check once. If still failing, return worker JSON with a failures entry for that TR.
TR list
tr_filter null → all TRs from plan folder
- else → only listed TR numbers
Verification manifest
Path: execution/tests/test_scenarios/test_<feature>/.uat-verification.json
Use uat_verification.py helpers from ${CLAUDE_PLUGIN_ROOT}/references/uat-test/execution/scripts/.
Return contract (JSON only)
{
"feature": "<stem>",
"tr_filter": ["TR1"],
"status": "completed",
"artifacts": { "created": [], "skipped": [] },
"verification": { "TR1": { "verified": true, "artifact_revision": "abc123" } },
"execution": {},
"failures": []
}
Return only this summary to the parent orchestrator.