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

2026-08-02 17:31:41 +00:00 · 2026-06-30 11:24:15 -04:00
parent 3985b9bd8d
commit cc14c6e2e2
5 changed files with 171 additions and 7 deletions
@@ -0,0 +1,50 @@
+<!-- Parent: ../AGENTS.md -->
+<!-- Generated: 2026-06-30 | Updated: 2026-06-30 -->
+
+# projects
+
+## Purpose
+One YAML file per project (16 total) — the portfolio pool the résumé templates select from per role. Each project links back to the experience or education entry it belongs to.
+
+## Key Files
+Sonr-era (strongest material, `associated-with: ../experience/sonr.yml`):
+| File | Description |
+|------|-------------|
+| `appchain.yml` | Layer-1 Cosmos blockchain & DID ecosystem — gasless onboarding, UCAN/DWN, EVM+CosmWasm. |
+| `beam-chat.yml` | Beam — E2EE React Native messaging on the Matrix protocol, WebAuthn passkeys, DIDs. |
+| `cryptography-library.yml` | ZKP (Bulletproofs) & MPC/DKG infrastructure in Go. |
+| `client-sdk.yml` · `motr-sdk` | Client/SDK surface. |
+| `token-economics.yml` · `decentralized-airdrop.yml` · `ecosystem-devrel.yml` | Token design, airdrop, devrel. |
+
+Earlier/consumer apps: `floadt`, `likely`, `pool`, `spacebolt`, `superball`, `swiper-no-mauling`, `timeboard`, `voluntree`, `yue` (several `associated-with: ../about/education.yml`).
+
+## Schema
+```yaml
+title: Beam — Lead Architect | E2EE Messaging · Matrix Protocol · DID
+start: 2022-08-01                # ISO; omit end: for ongoing
+end: 2025-08-01                  # optional
+project-url: https://...         # repo, live demo, or video — proof-of-work link
+associated-with: ../experience/sonr.yml   # required relative ref
+skills:                          # closed set of 4–6 canonical names
+  - React Native
+description: |                   # block scalar of "- " bullets, STAR pattern
+  - Bullet…
+```
+
+## For AI Agents
+
+### Working In This Directory
+- `associated-with` is required and uses a relative path into `../experience/` or `../about/`. Keep valid.
+- `title` follows `[Product] — [Role] | [Tech · Tech · Tech]`; `skills` is a tight closed set reused across siblings for keyword consistency (the `/linkedin-project` skill enforces this).
+- **Never invent metrics.** Bullets carry only user-confirmed numbers; otherwise stay qualitative.
+
+### Testing Requirements
+```bash
+python3 -c "import yaml; yaml.safe_load(open('<file>.yml'))"
+```
+
+## Dependencies
+### Internal
+- Each file points to `../experience/*.yml` or `../about/education.yml`; consumed by `../../src/*.tex` by hand.
+
+<!-- MANUAL: Any manually added notes below this line are preserved on regeneration -->