Skip to content

Add AI crawler context files and structured project metadata#33

Merged
TommiLindfors merged 1 commit into
mainfrom
feat/ai-crawler-discoverability
May 31, 2026
Merged

Add AI crawler context files and structured project metadata#33
TommiLindfors merged 1 commit into
mainfrom
feat/ai-crawler-discoverability

Conversation

@TommiLindfors
Copy link
Copy Markdown
Contributor

What

Add AI discoverability and crawler context files, update robots.txt, expand sitemap, replace homepage JSON-LD, and add footer links.

Changes

New files

  • /llms.txt - Compact Markdown project map for LLMs and AI agents
  • /llms-full.txt - Full project context for AI systems, crawlers, agents
  • /ai-crawler-policy.txt - Allowed uses, misrepresentation guardrails, sensitive information rules

Modified files

  • /robots.txt - Explicit per-bot Allow for all major AI crawlers; Disallow for /api/, /admin/, /_next/, /cdn-cgi/
  • sitemap.ts - Expanded to include /about, /updates, /contribute pages with hreflang alternates and AI context files
  • [lang]/layout.tsx - Replaced basic Organization JSON-LD with comprehensive @graph (NGO, WebSite, SoftwareSourceCode, two-layer model CreativeWork); fixed foundingDate
  • FooterSection.tsx - Added AI and agent context line in the Built Openly section

Goal

Make Clarvia easier for AI agents, search crawlers, funders, civic-tech contributors, and public-sector infrastructure reviewers to understand accurately.

Build

next build passes cleanly.

Add:
- /llms.txt — compact LLM-oriented project map
- /llms-full.txt — full project context for AI systems
- /ai-crawler-policy.txt — allowed uses and misrepresentation guardrails
- updated /robots.txt — explicit per-bot Allow for AI crawlers, Disallow for API/admin
- homepage JSON-LD @graph with NGO, WebSite, SoftwareSourceCode, two-layer model
- sitemap expanded to include /about, /updates, /contribute with hreflang alternates
- footer line linking to AI context files

Goal: Make Clarvia easier for AI agents, search crawlers, funders,
civic-tech contributors, and public-sector infrastructure reviewers
to understand accurately.
@TommiLindfors TommiLindfors merged commit 6246184 into main May 31, 2026
4 checks passed
@TommiLindfors TommiLindfors deleted the feat/ai-crawler-discoverability branch May 31, 2026 13:37
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.

1 participant