Logic-Driven Development

For each file and directory containing software source code, a LOGIC.md file describes what the code does.

• some-file.ext => some-file.LOGIC.md
• some-dir/ => some-dir/LOGIC.md

Goal

AI writes the code; the engineer stays in control of the business logic. LOGIC.md files are where that control happens: reviewing a change means reading LOGIC.md diff, and understanding any part of the system means reading LOGIC.md — never the code.

A LOGIC.md is the answer to "how does this work?" — the business logic, nothing else.

Write for exactly one reader: the technical product manager — knows the project and its user stories, proficient in programming and software engineering, never reads the code.

• Assume zero knowledge about the code. Technical writing is fine; presupposing what the code looks is not.