Moving repository memory from specs to OKF
How my project memory evolved from architecture decision records to living specs and now Open Knowledge Format bundles maintained together with the code.
Mykhailo Chalyi
Software engineer from Ukraine. Building things with code.
Latest posts
You Do Not Need a Server for Evals
Most evals do not need LangSmith, Braintrust or MLflow. Datasets, the runner, and the history all fit in your git repo - and your coding agent reviews the results for free.
My Three Phases of Coding with Agents
How I actually work with coding agents. Three phases — design, implementation, ship. Each one has a job, and most of the value is in getting the first one right.
How Tool Search Works and How It Saves Tokens
Why agents drown in tool schemas, how tool search fixes it by deferring schemas and loading them on demand, the difference between generic and provider-specific search, and tricks to make it actually good.
Build a Docs Agent Without Vector Search
Build a LangGraph docs agent that searches read-only documentation files with Bashkit shell tools instead of a vector database or embeddings.
Towards AI Friendly Web APIs
MCP and CLIs made APIs usable for agents by adding metadata, workflows, discovery, and better errors. Maybe the next step is to move this logic back into web APIs and OpenAPI specs.
Introducing Bashkit: Bash That Cannot Hurt You
Sandboxed bash interpreter written in Rust. No fork/exec, no real filesystem, no subprocess surprises. Built for LLM agents, multi-tenant sandboxes, and CI.
Stop Pretending Agents Are Humans
Instead of helping agents bypass CAPTCHA, we should make agent identities official. Human sub-identities for agents, with proper permissions and clear separation.
Call for Transparency
AI coding agents are becoming gatekeepers of tool adoption. The data that shapes their recommendations is opaque, gameable, and already being exploited. Creators, consumers, labs, and governments all need to act.
Rust Is Winning the AI Code Generation Race
Why Rust is becoming the go-to language for AI-generated code. Strong types, cargo conventions, LLM training data representation, and embeddability into Python and Node.js ecosystems make it a perfect fit.
Introducing Trickery: Make Claude Code Generate Nice Diagrams
A Coding Agent friendly tool to magically generate text and image artifacts like diagrams.
Making Your Repository AI-Ready
My experience of transitioning from human-first to AI-ready repositories packed to six practices that enable effective AI coding agents: feedback loops, entry points, specifications, progressive disclosure, skills, and testing documentation.
AWS App Runner as of December 2021
A review of AWS App Runner service capabilities and limitations at the end of 2021.
Your Very Own Private Docker Registry for Kubernetes on Azure ACR
Setting up Azure Container Registry as a private Docker registry for your Kubernetes cluster.
Your Very Own Kubernetes Cluster on Azure ACS
Guide to setting up and running a Kubernetes cluster on Azure Container Service.
Simple Serverless Data Pipeline Using AWS Kinesis and AWS Lambda
Building a serverless data pipeline with AWS Kinesis streams and Lambda functions.
The Most Easy Way to Try TensorFlow Anywhere Including Windows
Quick setup guide for running TensorFlow on any platform, including Windows.
Where do we keep our application configuration settings?
Discussion about application configuration management strategies.
Web-related development tools I used in 2011
A review of web development tools and technologies used throughout 2011.
PsGet News #1: features, new modules, challenges
Updates on PsGet including new features, modules, and development challenges.
Script to commit with message taken from JIRA ticket
Automating git commits with messages extracted from JIRA tickets.
Health monitoring for our production
Setting up health monitoring for production systems.
How do we automatically deploy with Mercurial and TeamCity
Implementing automatic deployment pipelines using Mercurial and TeamCity.
Execute business logic in separate application domain
Isolating business logic execution in separate .NET application domains.
IEnumerable could be considered harmful…
Exploring potential pitfalls and issues with IEnumerable in .NET.
PsGet got its very own central directory
Announcing the central module directory for PsGet.
Download files with PowerShell
How to download files using PowerShell scripts.
Transfer files with PowerShell Remoting
Using PsRemoteFiles to transfer files via PowerShell Remoting.
Introducing PsUrl and PsGet
Introduction to PsUrl for downloading web content and PsGet for PowerShell module management.
Kiev ALT.NET: First event dedicated to DDD and CQRS
Yep! We are moving on. Welcome our first event.
Node.NET: Modern non-blocking IO API in .NET
Introducing innovative stuff in .NET.
Mock friendly System.Reflection API, positive changes in .NET 4.0
Overview of the mocking in System.Reflection API. Some good changes in .NET 4.0
UNETA talk how F# could be used by virtually normal people
I think, now is good time to make small talk what F# is all about. Announce of the upcoming UNETA talk on subject.
Ideal Storage for Event Sourcing
Some subjective thoughts about potential storage dedicated for Event Sourcing.
Reactive Extensions API: Domain Events Example
Example Domain Events implementation with Reactive Extensions. Probably first example of the server side business logic with Rx.
Does Event Sourcing work with DDD?
Kind of yet another technique to organize business logic.
.NET 4.0: New and useful LINQ extensions to IEnumerable
Cool stuff that comes with Reactive Framework API. Hope it really will be part of .NET 4.0
FsSpec: Introducing yet another Unit Testing/BDD framework for F#
Yet another Unit Testing/BDD framework for F#. Inspired by RSpec syntax.
Can you guess error in this Java code snippet?
I love "guess error" kind of posts. This is first of mine. Snippet is all about GWT Java code.
Early review: Master Data Services November CTP
First attempt to view on the Microsoft Master Data Services November 2009 CTP.
What to watch at PDC09?
Small reviews of the PDC09 videos/sessions.
Microsoft Office Outlook 2010: How to connect e-mail account hosted on Windows Live Custom Domains?
Funny, but Microsoft Office Outlook 2010 does not support e-mail accounts hosted on Windows Live Custom Domains. I found not less funny solution.
Google Wave - GWT is probably a wrong technology choice
Inspired by Google Wave invitation, thoughts about suitability of the GWT for RIA.
Not so generic Generic Repository
Nice (at least I hope) solution that will end war between people who use generic repository and who do not.
Simple WCF Client by contract and without svcutil
You can share contracts of the WCF service? Here you can find a much more robust way to instantiate a client.
Semantic meaning of the read methods
What is the difference between GetOrder(id) and FindOrder(id)?
Thoughts on non-blocking sequential number generation
Failed take to design non-blocking sequential number generation.
Code-generation DSL with T4 (Text Templates)
Bored with repetitive code? Need a real example of T4 (Text Templates)? Need tools to write .NET Configuration Sections? This post is all about this stuff.
ASP.NET MVC Web Services (Part #1)
What do you think about ASP.NET MVC as a platform for web service based applications? What about JSON Web Services? Possibly you would like that.
Application Services, to be or not to be
We dropped out Application Layer. And nothing changed. This post is all about overuse of the Application Layer.