Claude Code Plugins

Community-maintained marketplace

Feedback

oe-hil-and-billing-triage

@shami-ah/OpenEvent-AI
0
0

Debug common manager/HIL + billing/deposit regressions: tasks not appearing in the panel, approve/reject button failures, billing capture loops, and “deposit paid but workflow stuck”. Produces a targeted repro + test run and points to the likely faulty layer (frontend vs backend).

Install Skill

1Download skill
2Enable skills in Claude

Open claude.ai/settings/capabilities and find the "Skills" section

3Upload to Claude

Click "Upload skill" and select the downloaded ZIP file

Note: Please verify skill by going through its instructions before using it.

SKILL.md

name oe-hil-and-billing-triage
description Debug common manager/HIL + billing/deposit regressions: tasks not appearing in the panel, approve/reject button failures, billing capture loops, and “deposit paid but workflow stuck”. Produces a targeted repro + test run and points to the likely faulty layer (frontend vs backend).

oe-hil-and-billing-triage

Fast signal: run the dedicated approve path tests

  • pytest backend/tests/agents/test_manager_approve_path.py -v
  • pytest tests/specs/gatekeeping/test_hil_gates.py -v

If “Approve” fails (500 or missing attribute)

  1. Confirm the handler symbol exists and is exported from the canonical step module.
  2. Confirm any deprecated wrapper modules re-export the symbol used by backend/workflow_email.py.
  3. Use docs/guides/TEAM_GUIDE.md (“HIL Approve Button Fails - Missing Export”) as the exact checklist.

If HIL tasks don’t appear in the frontend “Manager Tasks” panel

  1. Confirm the task payload uses the same thread_id as the frontend session id.
  2. Confirm the frontend is not appending the API response directly into chat (bypassing task rendering).
  3. Use docs/guides/TEAM_GUIDE.md (“HIL Task Not Appearing in Tasks Panel After Deposit Payment”) for known root causes and files:
    • atelier-ai-frontend/app/page.tsx
    • backend/workflows/steps/step1_intake/trigger/step1_handler.py

If billing/deposit flow is stuck (accept → billing → deposit → HIL)

  1. Re-test in UI with a fresh session (reset client / new email) to avoid stale session artifacts.
  2. Verify the gate checks use fresh deposit status (reload from DB for deposit; in-memory for billing):
    • backend/workflows/common/confirmation_gate.py
  3. Use docs/guides/TEAM_GUIDE.md (“Frontend Billing Capture Intermittent Failure”) for the suspected frontend/backend boundary issue and involved files:
    • backend/api/routes/messages.py
    • backend/api/routes/events.py