Skip to content

2001105254-netizen/RacePulsePH / .agents/skills/racepulse-release-engineering

racepulse-release-engineering

Verified

Manage RacePulsePH build pipelines, generated Firestore rules, rollout flags, staged deployments, rollbacks, versioning and dependency lockfiles. Use when preparing releases, editing firebase.json, running deploy scripts or updating dependencies.

RacePulse release engineering and staged rollout

Ship changes safely across Firebase Hosting, Cloud Functions (default and rbac codebases), Firestore and Storage rules, the Android Capacitor shell (android/) and the Windows Timing Station (rfid-station/).

Load with: racepulse-access-validation. Rules upheld: C-2, C-4, C-5, R-02, R-33, R-35, R-36. Detail: release, flag and rollback checklist.

Checklist

CheckReasonEvidence
Run npm run generate:access whenever src/lib/access-presets.json or scripts/firestore-base.rules changesKeeps firestore.rules, functions/access-policy.js and functions/rbac/access-policy.js synchronized from one source of truthRun node scripts/build-access-rules.cjs and verify zero uncommitted drift in generated files
Gate access enforcement activation behind accessSystem/rollout.enforcementReady and a fresh output/rbac-verification.json hashPrevents premature activation before rules, Functions, Storage and LAN paths are verified togetherInspect scripts/verification-hash.cjs, scripts/verify-rbac.cjs and scripts/migrate-access.cjs
Deploy backend rules and Functions before or alongside the frontend bundle that relies on them (scripts/build-access-deploy.cjs)Prevents a live browser bundle from calling missing Functions or hitting stale rules during rolloutInspect scripts/build-access-deploy.cjs and docs/PAYMONGO_SETUP.md deploy order
Preserve backward compatibility in HTTP and bridge payloads (server.ts, src/lib/preciseTime.ts, src/lib/offlineScanQueue.ts)Existing Timing Station binaries and browser queues may send legacy event shapes after an upgradeConfirm server.ts accepts legacy bridge messages and formatRaceTime normalizes legacy time strings
Keep package-lock.json and functions/package-lock.json committed and aligned across Node 22 runtimes (firebase.json)Prevents dependency drift ("dependency hell") between local builds and Cloud Functions nodejs22Inspect firebase.json lines 5 and 14 and check lockfiles in root and functions/
Document and rehearse rollback paths for accessSystem/rollout, Hosting releases and scripts/migrate-access.cjsOperators need an immediate recovery command if a pre-race deployment regressions occursInspect rollback steps in docs/rbac-operations.md and docs/access-control-plan.md

Stack mapping

  • Infrastructure as Code in this repository consists of firebase.json (Hosting, Functions default and rbac codebases, Firestore, Storage, emulators), firestore.indexes.json, storage.rules and scripts/build-access-rules.cjs.
  • Feature flags include accessSystem/rollout.enforcementReady (global rollout flag) and per-race registrationOpen and onlinePaymentEnabled (functions/index.js line 154).

Not covered

  • Access policy design belongs to racepulse-access.

Verify

  1. Run npm run lint, npm run build and node .agents/skills/racepulse-skill-maker/scripts/validate-skill-library.cjs.
  2. Output the PASS/FAIL report with exit codes for each build and verification command.
writing-skillsobra/superpowersUse when creating new skills, editing existing skills, or verifying skills work before deploymentStars: 322kUpdated Claude CodeCodexVerifiedInstall
xlsxanthropics/skillsUse this skill any time a spreadsheet file is the primary input or output. This means any task where the user wants to: open, read, edit, or fix an existing .xlsx, .xlsm, .xltx, .csv, or .tsv file (e.g., adding columns, computing formulas, formatting, charting, cleaning messy data); create a new spreadsheet from scratch or from other data sources; or convert between tabular file formats. Trigger especially when the user references a spreadsheet file by name or path — even casually (like "the xlsx in my downloads") — and wants something done to it or produced from it. Also trigger for cleaning or restructuring messy tabular data files (malformed rows, misplaced headers, junk data) into proper spreadsheets. The deliverable must be a spreadsheet file. Do NOT trigger when the primary deliverable is a Word document, HTML report, standalone Python script, database pipeline, or Google Sheets API integration, even if tabular data is involved.Stars: 197kUpdated Claude CodeCodexVerifiedInstall
shipping-and-launchaddyosmani/agent-skillsPrepares production launches. Use when preparing to deploy to production, or when asking what needs to be in place before shipping. Use when you need a pre-launch checklist, when setting up monitoring, when planning a staged rollout, or when you need a rollback strategy.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
childhoodthedotmack/claude-memBabysit a shipped release after merge, publication, or deployment. Verify published packages, production behavior, installed plugins, and late CI or user reports until the observation window is clean; use babysit for PR readiness before release.Stars: 118kUpdated Claude CodeCodexVerifiedInstall