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.

FileKindSize
SKILL.mdskill md3.4 KB
references/checklist.mdmarkdown3.1 KB
---
name: racepulse-release-engineering
description: 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](references/checklist.md).

## Checklist

| Check | Reason | Evidence |
| --- | --- | --- |
| Run `npm run generate:access` whenever `src/lib/access-presets.json` or `scripts/firestore-base.rules` changes | Keeps `firestore.rules`, `functions/access-policy.js` and `functions/rbac/access-policy.js` synchronized from one source of truth | Run `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` hash | Prevents premature activation before rules, Functions, Storage and LAN paths are verified together | Inspect `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 rollout | Inspect `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 upgrade | Confirm `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 `nodejs22` | Inspect `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.cjs` | Operators need an immediate recovery command if a pre-race deployment regressions occurs | Inspect 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: 198kUpdated 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