Skip to content

feat: add agent-ready-content starter - #47

Merged
nkgentile merged 1 commit into
mainfrom
add-agent-ready-content
Jul 31, 2026
Merged

nkgentile merged 1 commit into
mainfrom
add-agent-ready-content

Conversation

@kmelve

@kmelve kmelve commented Jul 24, 2026

Copy link
Copy Markdown
Contributor

What

Adds the agent-ready-content starter: serve HTML to humans and markdown to agents from the same URLs. One Sanity dataset, two frontends (Next.js 16 and Astro 7) implementing the same delivery pattern through shared workspace packages:

  1. Explicit markdown URLs — append .md to any docs URL
  2. Content negotiation — the same URL returns markdown on Accept: text/markdown
  3. Agent discovery — /llms.txt (per llmstxt.org) and /sitemap.md

Everything defining the markdown output lives in packages/agent-markdown (serializers, builders, typed GROQ queries); the apps contribute routing only. Ships with a skills/agent-ready-content skill for porting the pattern onto existing projects, seed content, and a pnpm bootstrap script.

Conventions

Brought up to the repo's starter conventions:

  • pnpm monorepo with catalog: for shared dep versions (Sanity v6, React 19)
  • packages/@starter/ shared eslint + tsconfig packages
  • .npmrc, .oxfmtrc.json, AGENT.md + CLAUDE.md symlink
  • Passes sanity-template-validate, standalone CI workflow, root CI job + README row
  • Generated artifacts (schema.json, sanity.types.ts) gitignored; pretypecheck and pnpm bootstrap regenerate them

CI note

No GitHub Environment needed: nothing deploys, so the workflow uses a hardcoded placeholder project ID — sanity schema extract and sanity manifest extract only require a non-empty value to load the Studio config (verified locally).

Verified

  • pnpm run lint, format:check, typecheck (all 5 workspaces, typegen included), validate, and manifest extract all pass with the same placeholder env CI uses

🤖 Generated with Claude Code

Serve HTML to humans and markdown to agents from the same URLs:
explicit .md routes, Accept-header content negotiation, and discovery
via llms.txt and sitemap.md — one Sanity dataset rendered by both
Next.js and Astro through shared schema and markdown packages.

Follows the starter conventions: pnpm catalog, @starter shared configs,
oxfmt/eslint, AGENT.md + CLAUDE.md symlink, template validation, and a
standalone CI workflow. CI uses a placeholder project ID since nothing
deploys — schema/manifest extract only need a non-empty value.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@vercel

vercel Bot commented Jul 24, 2026 •

Copy link
Copy Markdown

The latest updates on your projects. Learn more about Vercel for GitHub.

Project Deployment Actions Updated (UTC)
agentic-localization Ready Ready Preview, Comment Jul 24, 2026 6:20pm
ai-shopping-assistant Ready Ready Preview, Comment Jul 24, 2026 6:20pm

Request Review

@nkgentile
nkgentile merged commit fea0027 into main Jul 31, 2026
7 of 11 checks passed
@nkgentile
nkgentile deleted the add-agent-ready-content branch July 31, 2026 18:53

This branch was successfully deployed

2 active and 2 inactive deployments
Preview – ai-shopping-assistant — d5e9b1b7 Deployed Jul 24, 2026 by vercel[bot]
Preview – agentic-localization — d5e9b1b7 Deployed Jul 24, 2026 by vercel[bot]
knowledge-base — d5e9b1b7 Deployed Jul 24, 2026 by kmelve via knowledge-base (Node 20) #182
ai-shopping-assistant — d5e9b1b7 Deployed Jul 24, 2026 by kmelve via ai-shopping-assistant #182
agentic-localization — d5e9b1b7 Deployed Jul 24, 2026 by kmelve via agentic-localization (Node 20) #182
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants