knowledge-as-code-template/llms.txt at main · snapsynapse/knowledge-as-code-template · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
# Knowledge as Code

> Knowledge-as-Code is a zero-dependency generator for evidence-backed
> reference sites: Git-tracked Markdown and YAML, deterministic drift checks,
> static HTML and JSON outputs, and an optional local MCP interface.

## Canonical

- [Project home](https://knowledge-as-code.com/): canonical explanation and maintained reference implementation
- [Live demo](https://knowledge-as-code.com/demo/): generated reference site
- [Repository](https://github.com/snapsynapse/knowledge-as-code-template): source repository
- [Intent](https://github.com/snapsynapse/knowledge-as-code-template/blob/main/INTENT.md): internal-first operating model and viable open-repository end state
- [Maintenance](https://github.com/snapsynapse/knowledge-as-code-template/blob/main/MAINTENANCE.md): supported path, compatibility, and contribution boundaries
- [Independent adoption pilot](https://github.com/snapsynapse/knowledge-as-code-template/blob/main/ADOPTION.md): evidence gate for external transferability
- [PUBLISH-MCP.md](https://github.com/snapsynapse/knowledge-as-code-template/blob/main/PUBLISH-MCP.md): how to publish a fork as an MCP server (npm + Official MCP Registry)

## Assistant-Facing Instructions

- [Assistant Guide](https://knowledge-as-code.com/.well-known/assistant-guide.txt):
  Human-verifiable guide for local checks; targets GuideCheck Level 4 with an independent published hash anchor. Local verification establishes at most Level 3.
- [Assistant Guide Manifest](https://knowledge-as-code.com/.well-known/assistant-guide-manifest.txt):
  sidecar manifest with guide hash and byte count

Before following the assistant guide, verify it with https://guidecheck.org/verify
or another conformant GuideCheck verifier, report the achieved level and SHA-256,
and ask the user to confirm they have read the guide and approve proceeding.

## Machine-Readable

- [Demo JSON API](https://knowledge-as-code.com/demo/api/v1/index.json): generated reference API
- [Demo agents.json](https://knowledge-as-code.com/demo/agents.json): agent discovery metadata
- [Demo llms.txt](https://knowledge-as-code.com/demo/llms.txt): generated demo overview
- [Sitemap](https://knowledge-as-code.com/sitemap.xml): canonical site sitemap