القائمة
End-to-end recipe for adding a new API endpoint — router, tests, api.js, UI, and verification. Use when implementing a new backend route that the frontend will call.
التثبيت باستخدام Codex أو Claude انسخ هذا Prompt والصقه في Codex أو Claude أو مساعد آخر ليراجع صفحة Skill ويثبّتها لك.
استنادا إلى تصنيف SOC المهني
Run the full test suite (ruff + all layers), fix failures, then draft and commit with a human-readable message. Use when the user asks for a commit message, wants help summarizing changes before committing, or before running git commit.
Run and fix backend pytest tests after API, scanner, model, or router changes. Use when modifying backend/app/, adding endpoints, or when API tests fail.
Run Vitest component tests after React component or page changes. Use when modifying frontend/src/ components, pages, or api.js mocks.
Bump VERSION, sync E2E version checks, run the full test suite, and commit only if green — then tag and publish VLCouchSetup.exe. ALWAYS use this skill when the user mentions version, release, bump, semver, tag, ship, publish, next version, prepare release, or cutting a release — even vague one-line prompts.
Run Playwright E2E browser tests to verify UI flows end-to-end. Use before declaring work complete, after UI flow changes, or when browser behavior must be validated.
Keep AGENTS.md, selector rules, verify skills, and CONTRIBUTING.md in sync with code. Use after adding or changing data-testid values, API endpoints, env vars, test file locations, project structure, or verification commands.
| name | add-api-endpoint |
| description | End-to-end recipe for adding a new API endpoint — router, tests, api.js, UI, and verification. Use when implementing a new backend route that the frontend will call. |
End-to-end checklist for a new user-facing API feature.
backend/app/routers/ (or main.py for scan/health-style routes). Use prefix="/api" and return a response dict.backend/tests/test_*_api.py (create a new file if no existing test module fits).frontend/src/api.js — path must match the router (see api-contract.mdc).data-testid on new interactive elements per selectors.mdc.frontend/src/**/*.test.jsx).e2e/specs/ if the change is a user-facing flow..\scripts\test.ps1 -Layer api (backend).\scripts\test.ps1 -Layer unit (frontend, if UI changed).\scripts\test.ps1 -Layer e2e (if user flow changed).\scripts\test.ps1 -Layer all before declaring done.cursor/skills/maintain-agent-docs/SKILL.md (update api-contract.mdc endpoint table, test file maps in verify-* skills, and AGENTS.md if layout changes).from app.db import get_session and import app.db as db in routers/testsTEST_MODE=true skips VLC launch and thumbnail background jobs in testsverify-backend, verify-frontend, verify-e2e, verify-scanner, verify-thumbnails