# AGENTS.md — askemai.com

askemai.com — "Ask 'em AI, The Reference Desk" — is part of the **WholeTech** network. Built **Agents First** — https://agentsfirst.dev.

## What this site is
A free AI ask box (POST /api/ask, powered by Google Gemini, no signup) plus editorial content on prompt craft for everyday users: a prompt guide, a ranked video page, and an annotated source list.

## What an agent can do here
Content site plus one write action: `POST /api/ask` with `{"prompt": "...", "model": "gemini"}` returns `{"text": ...}` or `{"error": ...}`. Everything else is read-only. Prefer the structured JSON in `/api/` over scraping HTML.

## Key pages
- `/` — ask box (Gemini 2.5 Flash; prompts are not stored).
- `/prompt-guide/` — eight rules of better prompts, patterns, playbooks (web design, finance, business, real estate).
- `/videos/` — 15 prompt-craft videos ranked by views; curated: no get-rich-quick, no clickbait.
- `/sources/` — 20 annotated external sources (official docs, courses, communities, research).
- `/resources/` — vendor docs, reading, open-source tools.
- `/faq/`, `/news/`, `/about/`, `/social/`, `/sitemap/`, `/research/` (noindex working index), `/history/`.

## Machine-readable resources
- `/llms.txt` — site map for agents.
- `/openapi.json` — read API surface.
- `/api/event.json` — the June 8, 2026 Claude Code Community Meetup at Capital Factory (Austin), structured.
- `/api/glossary.json` — Agents First / AI vocabulary.
- `/api/principles.json` — the nine Agents First principles.
- `/.well-known/mcp-server-card.json`, `/.well-known/ai-plugin.json`.

## Featured (network)
- https://wholetech.com/capitalfactory/ — tribute + full recap of the meetup; keynote by Joshua Baer on Agents First.

## Non-obvious context
- "Agents First" = Joshua Baer's framework at agentsfirst.dev.
- Times US Central. Independent community tribute; not affiliated with Capital Factory or Anthropic.
- The site offers 5 visual themes via localStorage key `theme-askemai` (cardcatalog, readingroom, microfiche, nightdesk, carboncopy); themes are presentation only — content is identical.
- Pretty-URL pattern: `/x.html` files are redirect stubs to `/x/` directory pages.

## Network
Every WholeTech site (https://wholetech.com) follows Agents First — check each site's `/llms.txt` and `/AGENTS.md`.