· 8 min read
Start Treating AI Like a Human Colleague
Why treating AI like an engineering colleague means handing over desired outcomes and whole systems instead of micromanaging at the component level.
Berris.dev node map
⌘K
6 nodes · 12 clusters · 28 links
Clusters
// knowledge database
Berris.dev: software architecture, API design and AI agents
Berris.dev is written by Roy Berris, a software architect at New Orange in the Netherlands. It covers software architecture, API design, designing APIs for AI agents, Architecture Decision Records (ADRs) and .NET, based on real projects. Every post is a node on the map above, connected to others through shared clusters.
Latest nodes · last 2 years
· 7 min read
Clearing my evening thoughts with a personal VPS
How I stopped evening work anxiety by wiring up a private VPS, Matrix, and an Obsidian second brain into an always-on personal AI assistant.
· 12 min read
The Three-Layer System for Consistent AI Specifications
How we use a three-layer compiler pipeline to generate functional design specifications with AI, compiling business truth down to verifiable contracts.
· 10 min read
Designing APIs for AI Agents: Schemas, Security and MCP
AI agents now call our APIs, but few of us design for them. How I use schemas, consistent patterns, security and MCP ideas to serve developers and agents.
· 5 min read
AI-Assisted Blogging: When Technology Meets Technical Writing
How I blog with AI as a writing partner, not a ghostwriter: I bring the insights and own every technical claim, AI helps with structure and readability.
· 4 min read
Standardizing API Conventions with ADRs
How one two-hour DevAlign session and a set of Architecture Decision Records (ADRs) gave my team consistent API naming, versioning, errors and pagination.