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

This commit is contained in:
Prad Nukala
2026-06-30 11:24:15 -04:00
parent 3985b9bd8d
commit cc14c6e2e2
5 changed files with 171 additions and 7 deletions
+6 -7
View File
@@ -1,5 +1,5 @@
<!-- Parent: ../AGENTS.md -->
<!-- Generated: 2026-06-25 | Updated: 2026-06-25 -->
<!-- Generated: 2026-06-25 | Updated: 2026-06-30 -->
# docs
@@ -7,15 +7,14 @@
Structured YAML source material for the résumés — the canonical, role-agnostic record of Prad's career. The `src/*.tex` variants are hand-curated *from* this data; nothing here is generated and nothing generates the `.tex`. Treat these files as the single source of truth: when a fact changes (a date, a metric, a new project), update it here first, then reflect it in the relevant templates.
## Subdirectories
Each subdirectory holds one flat collection of like-shaped YAML files (no nesting, no per-file AGENTS.md — they share a schema described below).
Each subdirectory holds one flat collection of like-shaped YAML files (no nesting). Each has its own AGENTS.md describing its schema.
| Directory | Purpose |
|-----------|---------|
| `experience/` | One file per employer (`sonr`, `leidos`, `britetwist`, `hobsons`, `unissant`). Fields: `title`, `company`, `start`/`end`, `location`, `description` (bullets), `skills`, `projects` (refs). |
| `projects/` | One file per project (16). Fields: `title`, `start`/`end`, `project-url`, `associated-with`, `skills`, `description` (bullets). Sonr-era projects (appchain, beam-chat, cryptography-library, client-sdk, token-economics, decentralized-airdrop, ecosystem-devrel) carry the strongest material. |
| `skills/` | `languages.yml` (expert/strong/familiar tiers), `frameworks.yml` (grouped flat list), `methodology.yml` (flat list). These feed the Skills column in the templates. |
| `recognition/` | `honors.yml` (e.g. MIT Sloan guest lecture) and `organizations.yml` (W3C, DIF working groups). Feed the Honors/Organizations blocks. |
| `information/` | `profile.yml` (name, contact, role summaries) and `education.yml` (VCU, Applied Math). |
| `experience/` | One file per employer `sonr`, `leidos`, `britetwist`, `hobsons`, `unissant` (see `experience/AGENTS.md`). |
| `projects/` | One file per project, 16 total (see `projects/AGENTS.md`). Sonr-era projects carry the strongest material. |
| `skills/` | `languages.yml`, `frameworks.yml`, `methodology.yml` feed the Skills column (see `skills/AGENTS.md`). |
| `about/` | `profile.yml`, `education.yml`, `honors.yml`, `organizations.yml` — identity, contact, and the Honors/Organizations blocks (see `about/AGENTS.md`). |
## For AI Agents