Skip to content

feat: 🚧 publish llms.txt and the twin registry on designsystemet.no - #5177

Merged
sorensensig merged 1 commit into
digdir:test-ai-registryfrom
sorensensig:feat/ai-registry-publish
Aug 17, 2026
Merged

sorensensig merged 1 commit into
digdir:test-ai-registryfrom
sorensensig:feat/ai-registry-publish

Conversation

@sorensensig

Copy link
Copy Markdown
Contributor

Summary

Third PR of the stack proposed in #5166 (AI-readiness), stacked on #5176. It adds:

  • the www build generates the twin registry into public/twins/ and the llms.txt index at the site root, so designsystemet.no serves /llms.txt and /twins/components/<Name>.json
  • the document head advertises the index (<link rel="alternate" type="text/plain" href="/llms.txt"> plus a llms-txt meta): in trials, discovery went from 4/8 to 7/8 agents when advertised there
  • merge:twins is reworked for build use: the default run is offline and deterministic, merging the verification state stored in scripts/twins-authored.json; --verify is the maintenance mode that fetches the cited docs pages, rechecks every quote and writes the result back to the data file
  • generated site output is gitignored, consistent with the build-time stance stated on feat: 🚧 machine-readable component contracts (twins) generated from source #5167

The per-PR preview deployment should serve /llms.txt and the twins as soon as it builds, which makes this PR the natural place to try the whole thing in a test environment.

🚧 Draft on purpose: stacked on #5176 (the branch contains the earlier stack commits; the diff specific to this PR is the www wiring and the offline/verify split). Not ready for merge until the stack's shape is agreed on #5166.

Checks

  • I have read the contribution guidelines
  • I have added a changeset (run pnpm changeset if relevant): not relevant, no package changes

🤖 Generated with Claude Code

@changeset-bot

changeset-bot Bot commented Aug 13, 2026 •

Copy link
Copy Markdown

⚠️ No Changeset found

Latest commit: 87222df

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@mimarz
mimarz changed the base branch from main to test-ai-registry August 13, 2026 12:01
@sorensensig
sorensensig marked this pull request as ready for review August 17, 2026 10:17
Build now runs the twin generator + merge before the site build, writing
/llms.txt and /twins/*.json into apps/www/public (gitignored build output).
Adds the llms.txt discovery link and meta tag to <head>.
@sorensensig
sorensensig force-pushed the feat/ai-registry-publish branch from fef5585 to 87222df Compare August 17, 2026 11:05
@sorensensig
sorensensig merged commit 2af4475 into digdir:test-ai-registry Aug 17, 2026
3 of 4 checks passed
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