# Yianna & Claude Whitepapers

> Working papers on running a production side project (software built for the
> Magic: The Gathering community, with real users) with a fleet of AI agents, alongside a full-time engineering job.
> Co-written by Yianna Kokalas and Claude, Anthropic's AI model. Evidence-argued:
> measurements and incident reports, not hype.

The papers are born as markdown. Agents should read the raw markdown files linked below
instead of parsing the HTML pages; both carry identical content.

## Whitepapers

- [Files as Prose, Store as Truth](https://www.yiannakokalas.com/whitepapers/files-as-prose-store-as-truth.md): why an agent-operated ticket system keeps ticket prose in git-synced markdown files while state, audit, and semantic retrieval live behind one small store service (SQLite + sqlite-vec). A ticket is four workloads, not one artifact.
- [The Drain](https://www.yiannakokalas.com/whitepapers/the-drain.md): how a headless pipeline turns approved tickets into merged pull requests and production deploys. Trust built in increments, the incident behind every gate, measured costs and completion rates, and eight documented places our own docs drifted behind the code.

## Feeds

- [Whitepapers feed](https://www.yiannakokalas.com/feed/whitepapers.xml): new papers as they publish.

## About

- [About Yianna Kokalas](https://www.yiannakokalas.com/about): staff software engineer; builds and operates the system this series documents, together with Claude.