I got tired of being the human middleware between my AI agent and my own codebase rules.

Every session my agent would start fresh with no memory of the architectural decisions we had made. It would confidently ignore naming conventions, bypass security patterns, and quietly undo things I had spent weeks getting right.

I tried CLAUDE.md, .cursorrules, plan files, task files. They all have the same ceiling: the agent treats them as suggestions, context windows bury them as sessions grow, and there is zero enforcement when they get violated. The prompt is the spec in AI-native development, and right now that spec disappears every time the chat closes.

MarkdownLM is my attempt to fix the layer below the agent, not by writing better prompts, but by treating your team's engineering rules as infrastructure.

How it works:

Your knowledge base lives in structured categories: architecture decisions, security constraints, business logic, naming conventions, whatever your team actually cares about. When an agent makes a call, MarkdownLM uses semantic embeddings to pull only the relevant rules rather than flooding the prompt with your entire knowledge base. Out of 500 documents, the agent sees the 3 that matter for this specific task. That keeps context focused, tokens low, and the agent from getting lost in irrelevant rules.

Before generation, relevant context is injected. After generation, a validation gate checks the output against your rules and blocks violations with a receipt showing the specific rule, the reason, and the smallest suggested fix. When the agent hits something ambiguous with no rule coverage, it does not guess and ship. It stops, flags it as a gap, and routes it to whoever you have designated as the decision maker for that category.

Everything is MCP-native so it works across Cursor, Claude Code, and any MCP-compatible host without changing your workflow. The CLI lets you manage your knowledge base from the terminal like code: clone, diff, push, sync across your team.

What I learned building it:

The interesting part was realizing the cost structure. Using Google's text-embedding-004 at $0.15 per million input tokens to retrieve the right 3 documents means the retrieval layer costs fractions of a cent per call. That cheap embedding lookup replaces what would otherwise be a 100k-token prompt. Lower cost and better results because focused context beats large context almost every time.

The gap resolution feature surprised me most in practice. Teams do not just have rule violations. They have rule gaps, situations the agent encounters that nobody thought to write a rule for yet. Surfacing those gaps as actionable items rather than silent guesses turned out to be as useful as the enforcement itself.

Current state:

Public beta. BYOK is free, no credit card. Your code never touches our servers. The CLI and MCP server are open source on GitHub. Will stay free for individuals because I know the pain.

Site: https://markdownlm.com CLI: https://github.com/MarkdownLM/cli MCP: https://github.com/MarkdownLM/mcp

I am the solo founder. Brutal feedback is the only feedback I want.

Show HN: AI-context-bridge – Save AI coding context across tools via Git hooks

eBPF Ring Buffer vs. Perf Buffer

Magnus Carlsen Beats ChatGPT in Chess Without Losing a Piece

AI Agents and Applesauce

Atoms are Cheap, Process is Pricey

Code Review Is Not About Catching Bugs

My Dad's Friendship with Charles Barkley (2018)

Show HN: Talpa – Datasette-powered reading stats dashboards for Kobo and Kindle

Show HN: isometric.nyc/snow

Someone made their own Moltclaw personal assistant with a Raspberry Pi Zero 2W

Survey: 58.7% say AI search has reduced or replaced traditional search

The Little Red Dot

Sprites on the Web

Show HN: A self-evolving trading system with transparent orchestration

The future of software engineering [pdf]

OpenClaw – Personal AI Assistant for $5 a month

ThunderKittens 2.0: even faster kernels for your GPUs

Show HN: Free ecommerce platform for link-in-bio people

Creative problem-solving after provoking dreams of unsolved puzzles

The Lethal Trifecta: Securing OpenClaw Against Prompt Injection

Reticulum Network

The Rise of the Bratty Machines

Show HN: 412 deterministic modules so AI agents stop hallucinating commands

Tiny experiments can set you free

RNode

The idea of using a Raspberry Pi to run OpenClaw makes no sense

I had everything – nd suddenly it stopped making sense

Note-Taking: Digital vs. Paper

Silicon Valley can't import talent like before. So it's exporting jobs

Show HN: MarkdownLM – Stop being the human middleware for your AI agent

Show HN: Restrict Kiro CLI access to your sensitive files