CLAUDE.md@skills/edge-esmeralda git:20260522.7e7c69dA

Immutable. This exact content is served forever at /api/v1/blob/71ac56ce5e1438cd.

# Edge Esmeralda 2026 Skill — Contributor Notes

This directory is the **popup-specific knowledge layer** for Edge Esmeralda 2026 (May 30 – Jun 27, Healdsburg, CA). The agent-facing content is `SKILL.md`. The Bun project alongside it (`scripts/`, `references/`) regenerates the wiki / website / newsletter references that `SKILL.md` §5 points at.

For backend-agnostic EdgeOS API recipes, see the sibling `../edgeos/SKILL.md`. For Index Network discovery, see `../index-network/SKILL.md`. Do not duplicate either backend's content here.

## Project Structure
- `SKILL.md` — Popup-specific agent skill: popup constants (popup id, week dates, themes), attendee-directory field semantics, the curated wiki/website/newsletter references, and the "how to obtain EdgeOS tokens" pointer.
- `references/` — Preprocessed content from the Edge Esmeralda Notion wiki, the Edge City website, and the Edge Esmeralda Substack newsletter. Regenerated by `scripts/index.ts`.
- `scripts/index.ts` — Indexer that fetches and preprocesses static sources into `references/*.md`.

## Commands
- `bun install` — Install indexer dependencies.
- `bun run scripts/index.ts` — Regenerate `references/` markdown.

The upstream CI workflow (`.github/workflows/index-references.yml`) that regenerates these files automatically has not been set up yet — the `references/` directory does not exist in the repo. Run the indexer locally to generate the files, or wait for the workflow to be created. Local runs are also useful when iterating on the indexer itself.

## Key Data
- **Popup id**: `43746fd0-bce2-472b-93e4-a438177b2dff` (UUID; the agent passes this to `edgeos`-skill recipes that need a `popup_id`).
- **Notion wiki page id**: `317d45cdfc5981d2a571f52b024c5141`.
- **Newsletter RSS**: `edgeesmeralda2026.substack.com/feed`.
- **Edge City website**: `edgecity.live`.

## When updating `SKILL.md`
- Bump `version` in the frontmatter (semver: patch for content tweaks, minor for new sections, major for breaking the cross-skill contract with `edgeos`/`index-network`).
- Keep this file scoped to popup-specific knowledge. EdgeOS API recipes belong in `../edgeos/SKILL.md`; cross-skill orchestration logic belongs in `../../workspace/`.
- The two `<EDGECITY-ONBOARDING-URL>` placeholders in §2 are intentional — they get substituted once EdgeCity publishes the operator onboarding page.

Default to using Bun instead of Node.js.