reference

Document domain vocabulary, API surfaces, and data semantics for the Cambridge Beer Festival app.

2|3|Updated Nov 28, 2025
One-click install
npx skills add https://github.com/richardthe3rd/cambridge-beer-festival-app --skill reference-richardthe3rd
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reference
Source: https://github.com/richardthe3rd/cambridge-beer-festival-app/tree/main/.claude/skills/reference
Command: npx skills add https://github.com/richardthe3rd/cambridge-beer-festival-app --skill reference-richardthe3rd

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When working on the Cambridge Beer Festival app, you often have to reverse-engineer the meaning of domain-specific fields, data shape quirks, and project jargon from scattered code and comments, which wastes time and leads to incorrect assumptions about how the app is supposed to work.

Core Features & Use Cases

  • Domain Context: Explains the real-world Cambridge Beer Festival operations that drive key app design decisions, like burst usage patterns and patchy venue network.
  • Drink & Data Reference: Defines drink domain vocabulary (categories, dispense methods, ABV, allergens, availability status), explains why data feed fields use union types, and documents festival registry semantics.
  • API & Jargon Guide: Maps the three distinct API surfaces (static feeds, v1alpha Review API, proto CatalogService), and defines project-specific terms like SWR, D1, workerd, and CalVer.
  • Use Case: If you are debugging why a drink's availability status is showing as "unknown" even though the volunteer entered "arrived", or need to understand the difference between the static feeds and the proto API contract, this skill provides the context you need without digging through incident records or scattered docs.

Quick Start

Use the reference skill to look up the meaning of the 'dispense' field in the drink model when you are confused why a cider is listed as being served via "cider tub" instead of the default cask method.

Frequently Asked Questions about reference

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
What does the Cambridge Beer Festival app data feed 'dispense' field mean when it shows 'cider tub'?

The 'dispense' field defines the serving method for a drink. 'Cider tub' is a specific festival operational method for serving ciders instead of the default cask dispense used for ales.

Why does a drink's availability status show 'unknown' even after a volunteer enters 'arrived'?

This discrepancy happens due to festival registry semantics and data feed type union designs. 'Unknown' captures states where the static feed and v1alpha Review API are not yet synchronized.

What is the difference between the static feeds, v1alpha Review API, and proto CatalogService?

These are three API surfaces with distinct maturity levels. Static feeds provide baseline data, v1alpha is an early review endpoint, and proto CatalogService defines the mature contract.

How do I debug Cambridge Beer Festival app data shape quirks without incident records?

You can look up the domain-theory context to understand data shape design decisions. This explains why data feed fields use union types to handle patchy venue networks and burst usage patterns.

What do project jargon terms like SWR, D1, workerd, and CalVer mean in the festival app?

These terms map to project-specific technologies and conventions. SWR handles data fetching, D1 is a database, workerd is the runtime, and CalVer defines the versioning scheme.