docs(AGENTS.md): add detailed documentation for AGENTS.md files in subdirectories

docs/experience/AGENTS.md

@@ -0,0 +1,50 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-06-30 | Updated: 2026-06-30 -->
+
+# experience
+
+## Purpose
+One YAML file per employer — the canonical record of each role Prad has held. Templates draw experience bullets from here; nothing is generated.
+
+## Key Files
+| File | Description |
+|------|-------------|
+| `sonr.yml` | Co-Founder / CEO at Sonr (2021–). Richest entry — DIDs, WebAuthn, Matrix, Cosmos L1, fundraising. Lists 7 project refs. |
+| `britetwist.yml` | Consumer mobile work (1M+ downloads era). |
+| `leidos.yml` | Defense/government engineering. |
+| `hobsons.yml` | Earlier engineering role. |
+| `unissant.yml` | Earlier engineering role. |
+
+## Schema
+```yaml
+title: Co-Founder / CEO          # role title
+company: Sonr
+start: 2021-03-01                # ISO YYYY-MM-DD; omit end: for Present
+end: 2020-12-01                  # optional
+location: New York, USA
+profile-heading: ...             # optional one-liner
+description: |                   # block scalar of "- " bullets
+  - Bullet…
+skills:                          # canonical names, reused across files
+  - React Native
+projects:                        # relative refs into ../projects/
+  - ../projects/beam-chat.yml
+```
+
+## For AI Agents
+
+### Working In This Directory
+- `projects:` and any cross-refs use relative paths (`../projects/<name>.yml`). Keep valid on rename/move.
+- Skill names must match the canonical spelling used elsewhere (`Decentralized Identifiers (DIDs)`, `WebAssembly (WASM)`) so they dedupe across files.
+- `description` bullets are the raw pool; templates condense them to fit one page — do not assume verbatim use.
+
+### Testing Requirements
+```bash
+python3 -c "import yaml; yaml.safe_load(open('<file>.yml'))"
+```
+
+## Dependencies
+### Internal
+- Referenced by `../projects/*.yml` via `associated-with`; consumed by `../../src/*.tex` by hand.
+
+<!-- MANUAL: Any manually added notes below this line are preserved on regeneration -->