Skip to content

docs: add golden context files for AI agent navigation [TRANS-13]#114

Merged
david-shibley-contentful merged 1 commit into
mainfrom
chore/add-golden-context
May 7, 2026
Merged

docs: add golden context files for AI agent navigation [TRANS-13]#114
david-shibley-contentful merged 1 commit into
mainfrom
chore/add-golden-context

Conversation

@david-shibley-contentful

Copy link
Copy Markdown
Contributor

Summary

  • Adds AGENTS.md, ARCHITECTURE.md, and CONTRIBUTING.md to make this repo navigable for AI agents and new engineers without a human guide
  • AGENTS.md covers the zero-dependency library design, dual App Router/Pages Router exports, and JWT validation logic
  • ARCHITECTURE.md documents the Vercel bypass secret flow, CONTENTFUL_PREVIEW_SECRET fallback, and the two-export structure
  • CONTRIBUTING.md documents the dev/test/release workflow

Test plan

  • Verify files render correctly on GitHub
  • Spot-check that repo paths and commands referenced in the docs are accurate

Generated with Claude Code

Adds AGENTS.md, ARCHITECTURE.md, and CONTRIBUTING.md to make this repo
navigable for AI agents and new engineers without a human guide.

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
@david-shibley-contentful
david-shibley-contentful requested a review from a team as a code owner May 6, 2026 19:01

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This is very useful 👏

@david-shibley-contentful david-shibley-contentful changed the title docs: add golden context files for AI agent navigation docs: add golden context files for AI agent navigation [TRANS-00] May 7, 2026
@david-shibley-contentful
david-shibley-contentful merged commit 30eaa8d into main May 7, 2026
9 checks passed
@david-shibley-contentful
david-shibley-contentful deleted the chore/add-golden-context branch May 7, 2026 21:05
@david-shibley-contentful david-shibley-contentful changed the title docs: add golden context files for AI agent navigation [TRANS-00] docs: add golden context files for AI agent navigation [TRANS-13] May 7, 2026
@github-actions

Copy link
Copy Markdown

🎉 This PR is included in version 1.6.1 🎉

The release is available on:

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants