[03] Design Notes

Engineering logs, decision records, and technical essays. No fluff.

2026-05-12

Designing RAG for Hundreds of Documents

Strategies for efficient chunking and retrieval when dealing with diverse institutional data formats.

When building CollegeInfo-Agent, naïve chunking failed for tables. We moved to a semantic-aware splitter... [Read More...]

2026-04-03

JWT Authentication: Key Mistakes

Why storing tokens in localStorage is dangerous and how httpOnly cookies solve XSS vulnerabilities.

In Skill-Swap, I initially stored JWTs in localStorage. After researching XSS vectors, I migrated to httpOnly cookies... [Read More...]

2026-02-15

SQL vs NoSQL: A Decision Framework

Why I chose PostgreSQL for the Shop System but MongoDB for Skill-Swap.

The Shop System required strict ACID guarantees for inventory. Skill-Swap needed flexible schemas for user profiles... [Read More...]