Portkey's Pattern: Move Context to Markdown Files in GitHub for Agent Access
Summary
Portkey describes their internal engineering practice: all shared context lives in .md files in a GitHub repo rather than Confluence/Notion, making it accessible to agents across the team. They built a pricing agent on the Claude Agent SDK that monitors 1,600+ LLMs across 80+ providers by reading from these files. The CLAUDE.md pattern is the foundation; the repo becomes the single source of truth that both humans and agents read.
Why this signal
Neo's #4 focus area. Portkey gives a concrete implementation that goes beyond 'use Confluence' — a git-native pattern where context is agent-readable by default. Thomas Engineering already uses Claude Code extensively; adopting a shared context repo could be a near-term low-cost win.
Original email
Engineering Leadership Gregor · 6/1/2026
The Product Engineer Company: How Portkey Works and Builds Its Product