# 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 *previous* Edge City popup. The current event is Edge City India (Mandrem, Goa, Oct 11 – Nov 1 2026); `SKILL.md` frames everything here as past background, and agents must not present it as current. 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.
- `prompts/` — Cron job prompts (`brief.md`, `opportunity-drop.md`, `negotiation-summary.md`, `ask-questions.md`, `memory-signals.md`). The proactive ones only render the Script Output of their pre-run trigger (`skills/index-network/scripts/proactive.ts`, DATA-314) and never ask for a tool. Stored in each cron job by the installer; the agent does not read them at runtime.
- `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.

`references/` is a frozen snapshot of the Esmeralda sources, last refreshed 2026-10-01. On that day the upstream indexer (`aromeoes/edge-agent-skill`) moved to Edge City India and now keeps its Esmeralda copies under `archives/edge-esmeralda-2026/`; this repo's sync workflow feeds `skills/edge-india/references/` instead and never writes here. Run the indexer locally only if the Esmeralda snapshot ever has to be regenerated.

## 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.