Skip to content

Instantly share code, notes, and snippets.

@theafh
theafh / knowledge-and-tasks-as-files.md
Last active May 31, 2026 19:37
All You Need Is Markdown

Knowledge and Tasks as Files

A pattern for keeping a project's knowledge and backlog as plain markdown in the repository, written by AI and read by any agent. No special tooling required.

I publish the skills that run this as an open set (theafh/ai-modules), and I point at them throughout. Take them as a reference for your own project, adapt them, or skip them. They make the approach faster to follow. What actually makes it work is simpler: the knowledge and the tasks are plain files in the repository, and any editor or agent can already read them.

The core idea

Every project carries information that the source code itself does not hold. Two kinds matter here. The first is knowledge: what is true about the domain, why the project makes the decisions it does, and the conventions a new contributor would otherwise have to learn by asking around. The second is tasks: the work that is planned but not yet done.