finds.dev

danielmiessler/Telos

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

View on GitHub

★ 1,549MITupdated Jan 2026

// the take

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.

We read the README, the directory tree and a key source file in September 2026. Nobody pays to be listed. How we judge →

// at a glance

Stars
1,549
Forks
230
License
MIT
Last commit
9 Jan 2026

// nearby

If Telos isn't quite it.

All repos →