From f701c951e4dd7bf06a731579d15da762fd3bd1f5 Mon Sep 17 00:00:00 2001 From: Prad Nukala Date: Tue, 30 Jun 2026 13:05:12 -0400 Subject: [PATCH] docs(ui): add AGENTS.md files for component documentation --- src/components/AGENTS.md | 43 +++++++++++++++++++++++ src/components/TagList.astro | 27 ++++++++++++++ src/components/blog/AGENTS.md | 32 +++++++++++++++++ src/components/blog/webmentions/AGENTS.md | 26 ++++++++++++++ src/components/layout/AGENTS.md | 30 ++++++++++++++++ src/components/project/AGENTS.md | 25 +++++++++++++ src/components/project/Project.astro | 12 +++++-- src/layouts/AGENTS.md | 26 ++++++++++++++ src/layouts/BlogPost.astro | 2 +- src/styles/AGENTS.md | 31 ++++++++++++++++ 10 files changed, 250 insertions(+), 4 deletions(-) create mode 100644 src/components/AGENTS.md create mode 100644 src/components/TagList.astro create mode 100644 src/components/blog/AGENTS.md create mode 100644 src/components/blog/webmentions/AGENTS.md create mode 100644 src/components/layout/AGENTS.md create mode 100644 src/components/project/AGENTS.md create mode 100644 src/layouts/AGENTS.md create mode 100644 src/styles/AGENTS.md diff --git a/src/components/AGENTS.md b/src/components/AGENTS.md new file mode 100644 index 0000000..2e8f300 --- /dev/null +++ b/src/components/AGENTS.md @@ -0,0 +1,43 @@ + + + +# components + +## Purpose +Reusable `.astro` components for layout, content rendering, theming, search, and SEO. + +## Key Files +| File | Description | +|------|-------------| +| `BaseHead.astro` | All `` tags: title, meta, canonical, Open Graph/Twitter, favicons, RSS auto-discovery, webmentions. | +| `ExperienceTags.astro` | Renders linked chips for an entry's `experiences` refs; resolves them with `getEntries` and links to `/experience/`. Used by Masthead, Project, and the speaking page. | +| `StreamPlayer.astro` | Cloudflare Stream embed — an iframe at `${streamOrigin}/${videoId}/iframe`. Used on speaking detail pages. No external player dependency. | +| `FormattedDate.astro` | `