zuora-uat-generate-feature

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)

1. Plan — ${CLAUDE_PLUGIN_ROOT}/skills/zuora-uat/plan/SKILL.md
2. API script — generate-api/SKILL.md (gap-fill)
3. UI doc — generate-ui/SKILL.md when hybrid (gap-fill)
4. UI placement check (hybrid TRs only) — verify doc is in execution, not testplan (see below)
5. 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>

6. Verify segment when verify=true — verify/SKILL.md with environment
7. When verify=false: set verified: false for affected TRs (same clear command as step 5, per TR in scope)
8. 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>"
# append --tr N when tr_filter is set

UI placement check (after step 3, hybrid TRs)

Fail fast if ui_steps_tr{n}.md is missing from execution or present under testplan:

# A. Execution doc must exist
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>')"

# B. No stray UI docs in testplan for this feature
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.