๐Ÿ““ journal April 23, 2026 sat singh

guide operating system + dcf and cv giving day drafted

Shipped the production schema, redesigned authoring template, draft/placeholder system, and noindexed the Mesquite placeholder. Drafted Desert Community Foundation and CV Giving Day, both held pending executive director review.

what shipped today

Today was less about adding visible content and more about getting the SunshineFM Guide ready to scale to 300 entries without falling over. The schema, the template, and the publishing workflow all reached production-readiness in a single commit.

Three new optional fields landed in the Zod schema at guide-builder/src/content/config.ts: schemaTypeOverride for per-entry Schema.org type control (so an NGO entry like Desert Community Foundation can emit NGO instead of the generic Organization default), draft for filtering authored-but-not-shipped entries out of every public query, and placeholder for noindexing sample entries that still need to render visually. The category enum gained event for time-bounded entities like CV Giving Day, and the city enum gained valley-wide for entries that genuinely span the region.

The authoring template at _TEMPLATE.md was redesigned to function as a working document rather than a form โ€” ordered the way an entry actually gets written (identity โ†’ voice โ†’ facts โ†’ schema), with inline guidance at each field, an authoring-notes block at the top for working notes that don't ship, and the Parker reference register inline at the voice section so the aspirational voice is visible at the moment of writing.

two entries drafted, both held for review

Desert Community Foundation and CV Giving Day were drafted to production quality and committed as draft: true entries โ€” meaning the MDX files exist in the content directory but no public pages render. Both ship next week after Executive Director Mary Panesar reviews them. This is the courtesy pattern the Guide will extend to every entry that profiles a real institution where SunshineFM has a relationship.

The DCF entry takes the position that the foundation has been the hub of philanthropy for the Coachella Valley since April 1999 and that anyone newly arrived in the desert with serious philanthropic intent should make it their first stop. It discloses, in the editorial note, that AI Coachella Valley is DCF's first fiscal sponsorship in the foundation's 27-year history. The CV Giving Day entry breaks out as its own concierge-tier event entry rather than being folded into DCF โ€” different reader, different moment, different Schema.org type. The 2026 edition crossed $1 million raised in a single day for the first time in the event's history.

the mesquite placeholder is now noindexed

The Mesquite has been the only Guide entry rendering on production while the Guide buildout has been underway. As of today's deploy, its frontmatter carries placeholder: true and the rendered page emits <meta name="robots" content="noindex, nofollow">. Crawlers will stop treating it as a canonical Guide entry over the next one to three weeks. When DCF goes live, the Mesquite gets deleted entirely.

the deferred-roadmap problem, solved

Until today, deferred Guide work lived only in Claude memory and conversation context โ€” easy to lose, hard to surface when picking up the project weeks later. guide-builder/ROADMAP.md now exists as the durable single source of truth. Every deferred item has an explicit trigger ("when Guide has 20 entries," "when traffic exceeds X," "when the official announcement drops"). No more scoped-but-not-executed drift.

what the guide actually does for discoverability

Worth naming explicitly because this is what the Guide is being built for. Every entry now ships with three layers working at once: classic SEO (canonical URLs, meta tags within SERP limits, sitemap entries, mobile-fast static HTML, geographic meta), structured data (LocalBusiness JSON-LD with the right Schema.org subtype per entity, FAQPage from the FAQ field, BreadcrumbList, sameAs entity-graph linking), and agentic discoverability (llms.txt declarations, agent-context HTML comments matching the sunshine.fm convention, machine-readable JSON endpoints, AICV cross-references via aicvNodeSlug, AI crawler allow-lists in robots.txt).

The result is a Guide entry that Google indexes as a rich result, that LLMs can parse without HTML gymnastics, and that's part of a larger intelligence graph through AICV. Visit Greater Palm Springs has 3,000 partnership pages built for Google's classic algorithm โ€” and almost none of the structured-data or agent-readability work that the Guide does on every entry. The two-year head start the Guide has been positioned to capture is structural, not cosmetic.

tomorrow and beyond

Mary returns Tuesday, April 28. DCF and CV Giving Day get sent for review then, ship Wednesday or Thursday, and the Mesquite finally exits the directory. Concurrent thread of work: an AICV Node for CV Giving Day so it has the same analytical-structured presence DCF already does, with reciprocal cross-references between the Guide and AICV's intelligence layer. The pattern that gets established with these first two entries โ€” draft, courtesy review, ship, cross-reference โ€” is the pattern for the next 298.

Tools: Claude (Claude Project โ€” strategy, voice, schema design, MDX drafting), Claude Code (execution layer โ€” schema conflicts caught, JSON-LD wiring, build verification, deploy), web_fetch (DCF and CV Giving Day source material), Wrangler (Cloudflare Pages deploy), Astro (build system) ยท Commits: 1 in sunshine-fm at 4d03c13 ยท Deploy: sunshine.fm ยท Est. tokens: ~120,000