# The files that make a portfolio readable to agents

> Day 6 of the AI Agent Field Notes traffic experiment.

Format: Reusable Template
Target reader: Developers adding llms.txt, JSON-LD, and agent discovery manifests to public sites.
Primary channel: LinkedIn
Secondary channel: GitHub
Canonical URL: https://zack-dev-cm.github.io/docs/field-notes/agent-discovery-files-that-crawlers-can-read.md

## Reader Win
A minimal file map for homepage HTML, llms.txt, geo.txt, schema JSON-LD, and agent-discovery.json.

## Evidence To Use
Generated crawlable files in the portfolio build pipeline.

## Thumbnail Direction
File map screenshot with five linked public files and one highlighted crawl path.

## Writer Brief
Teach the reader where each file sits and what citation job it handles.

## Call To Action
Open agent-discovery.json

## Public-Surface Rules
- Use real screenshots, generated public files, or dated public marketplace data as evidence.
- Do not include credentials, private account identifiers, unpublished analytics, or client-specific operational details.
- Treat marketplace downloads as listing-download evidence, not user-count proof.