|
2 | 2 |
|
3 | 3 | A template for building structured, version-controlled knowledge bases with an ontology-first approach. Edit a config file, add markdown data, get a full HTML site + JSON API. |
4 | 4 |
|
| 5 | +**[Knowledge as Code](https://knowledge-as-code.com)** is a pattern created by [Sam Rogers](https://sam-rogers.com) at [Snap Synapse](https://snapsynapse.com). It applies software engineering practices to knowledge management: plain text, Git-native, zero-dependency, ontology-driven, multi-output from a single source. |
| 6 | + |
| 7 | +## Live Examples |
| 8 | + |
| 9 | +- [AI Capability Reference](https://airef.snapsynapse.com) — AI model capabilities across 12 products |
| 10 | +- [AI Regulation Tracker](https://aireg.snapsynapse.com) — global AI regulatory landscape |
| 11 | +- [Meeting Standards Reference](https://meetings.snapsynapse.com) — meeting facilitation standards |
| 12 | + |
5 | 13 | ## Quick Start |
6 | 14 |
|
7 | 15 | 1. **Use this template** — click "Use this template" on GitHub, or clone locally |
@@ -77,6 +85,23 @@ node scripts/validate.js # Validate cross-references |
77 | 85 | - **Bespoke static generation** — the build script _is_ the specification |
78 | 86 | - **GitOps** — Git is the single source of truth |
79 | 87 |
|
| 88 | +## The Pattern |
| 89 | + |
| 90 | +Knowledge as Code has six defining properties: |
| 91 | + |
| 92 | +1. **Plain text canonical** — knowledge in human-readable, version-controlled files |
| 93 | +2. **Self-healing** — automated verification detects when knowledge drifts from reality |
| 94 | +3. **Multi-output** — one source produces every format needed (HTML, JSON API, MCP, SEO pages) |
| 95 | +4. **Zero-dependency** — no external packages; nothing breaks when you come back in a year |
| 96 | +5. **Git-native** — Git is the collaboration layer, audit trail, and deployment trigger |
| 97 | +6. **Ontology-driven** — a vendor-neutral taxonomy maps to domain-specific implementations |
| 98 | + |
| 99 | +Read the full pattern definition at [knowledge-as-code.com](https://knowledge-as-code.com). |
| 100 | + |
| 101 | +## Attribution |
| 102 | + |
| 103 | +Knowledge as Code was created by [Sam Rogers](https://sam-rogers.com) / [Snap Synapse](https://snapsynapse.com). See [ATTRIBUTION.md](ATTRIBUTION.md) for details. |
| 104 | + |
80 | 105 | ## License |
81 | 106 |
|
82 | 107 | MIT |
0 commit comments