// AI EngineeringYour Agent Isn't Dumb. Your Tools Are.petarivanov.tech
Your Agent Isn't Dumb. Your Tools Are.
7 rules for tool definitions a model can't misread, starting with the sentence that fixes the most bugs.
Tagged API Design
6 articles on API Design.
Browse by tag
ReactCareer GrowthNode.jsTypeScriptComponent DesignClean CodeDesign PatternsToolingAgentsAPI DesignLLMProductivityProject StructureTestingCode ReviewCSSDistributed SystemsGraphQLInterview PrepPerformanceSystem DesignDebuggingLearningMicroservicesModular MonolithRefactoringSOLIDError HandlingIdempotencyProductionState ManagementCQRSDatabasesDDDDecision MakingDependency InjectionHiring & OnboardingNext.jsProductSecurityWeb Platform
- // Software Design · Node.jsStop Throwing new Error(). It's Lying to Your Logs.petarivanov.tech
Stop Throwing new Error(). It's Lying to Your Logs.
One distinction that sets your HTTP status, your log level, and who gets paged.
- // Architecture · Node.jsHow to Stop Charging Customers Twice: A Practical Idempotency Guidepetarivanov.tech
How to Stop Charging Customers Twice: A Practical Idempotency Guide
Idempotency in plain English: HTTP, message queues, and the one detail that decides whether it's real.
- // Architecture · GraphQLGraphQL Schema Design 101petarivanov.tech
GraphQL Schema Design 101
Learn proven best practices and key principles for designing robust GraphQL Schemas.
- // Architecture · GraphQLGraphQL Intro 101 (part 2)petarivanov.tech
GraphQL Intro 101 (part 2)
A conscious introduction to the GraphQL World, part 2.
- // Architecture · GraphQLGraphQL Intro 101 (part 1)petarivanov.tech
GraphQL Intro 101 (part 1)
A conscious introduction to the GraphQL World, part 1.