run-and-operate

What problem does it solve?

This Skill removes the friction of working with the Cambridge Beer Festival app's custom operational setup, which relies on specialized mise tasks, GitHub Actions CI/CD workflows, and Cloudflare deployment infrastructure that are not immediately obvious from the codebase alone. Without this guidance, developers would need to manually piece together commands, workflow triggers, and deployment topology from scattered documentation and configuration files.

Core Features & Use Cases

• Local development and testing workflows: Provides exact, environment-aware commands for running the local dev server, building web and Android artifacts, serving release builds locally, and executing end-to-end Playwright test suites, including nuances for Claude Code Web environments.
• Release and deployment orchestration: Covers the full CalVer release train process, deployment topology for staging, PR preview, and production environments, Android Play Store releases, and Cloudflare Worker deploys, plus documented traps and edge cases like CI not running on release PRs.
• Operational checks and data management: Includes commands to verify worker health, update the festival data registry, and understand where build artifacts and logs are stored, with clear boundaries on what operational checks an agent can perform independently versus what requires human dashboard access. Use case example: If you need to test a bug fix locally, this Skill gives you the correct command to start the dev server for your environment; if you need to cut a production release, it walks you through the full release train process and warns you about common pitfalls like the festival freeze rule.

Quick Start

Use the run-and-operate skill to start the local development server for the Cambridge Beer Festival app and access it at http://localhost:8080 to verify your changes.