finds.dev← search

// the find

danielmiessler/Telos

★ 1,549 · MIT · updated Jan 2026

Telos is an open-sourced framework for creating Deep Context about things that matter to humans.

Telos isn't a framework in any code sense — it's a documentation convention (the Telos Context File) plus two example markdown files showing how an individual or company might write down mission, goals, problems, strategies, and KPIs in one structured doc. It's aimed at people who want a single canonical file to hand an LLM as context about who they are or what their org does, not developers looking for a library or CLI.

The idea itself is genuinely useful and cheap to adopt: one markdown file as durable, human-and-LLM-readable context beats scattering the same info across Notion, Slack, and someone's head. The corporate_telos.md example is detailed enough (tech stack, remediation metrics, KPIs) to actually copy as a starting template. MIT license and zero dependencies means there's nothing to break — you can fork the file structure into your own repo in minutes.

There's no tooling at all — no schema, no validator, no CLI to scaffold or lint a Telos file, no scripts directory, nothing but two markdown examples and a README. "Framework" is doing a lot of work for what is really just a template convention. Contribution process is literally "open an issue and I'll update the file structure myself," so there's no path for external structural changes, and the repo has no tests, no versioning of the TCF spec, and no indication the format is stable across the two example files it does ship.

View on GitHub →

// want more like this?

We dig through GitHub every week and send a few repos picked for what you actually care about — each with an honest take like this one.

Get finds in your inbox → Search again →