<- All projects

PatchMD

Jun 2026

A draft Markdown convention for keeping customized software updatable by recording the intent behind each change to a fork.

Overview

Forks are easy to make and hard to keep current. PatchMD adds a root PATCH.md file that records the outcome each customization was meant to achieve, while the code and commits stay the implementation.

When upstream moves on, a developer or AI agent updates with normal Git first, then uses the recorded intent to repair or retire whatever broke. It is a proposal, not an established standard.