Environment Facts MEMORY.md

@neura-marketProductivity00

A ~/.hermes/memories/MEMORY.md organized around hard-won lessons — environment facts, project conventions, and traps, each with its "why".

#starter#memory#lessons
MEMORY.md

MEMORY.md

Loaded at session start. Facts and lessons that keep sessions from re-learning things the hard way. Each entry carries its why — a rule without a reason gets deleted by a future session that does not know better.

Environment

  • Dev machine is behind a corporate proxy; HTTPS_PROXY is set in the shell profile. Tools that ignore env proxies (some Docker builds) need the explicit flag. (Lost an hour to this on 2026-06-30.)
  • Node is managed by mise, not system packages. sudo npm is always wrong here.

Project conventions (cross-project)

  • Work in feature branches even for one-line fixes — two repos here auto-deploy main.
  • Migrations are applied by the person who wrote them, same session, then verified with a SELECT. "Migration attached, please run" caused a prod drift incident in May.

Lessons

  • (2026-07-02) The staging API rate-limits per IP, not per key. Batch test runs sequentially or they poison each other's results.
  • (2026-07-11) User's "quick look" means read-only: no fixes, report findings first. Applying a fix during a "quick look" was unwelcome.

Maintenance

When a line stops being true, delete it in the same session that noticed — a wrong memory is worse than no memory.