Add adoption roadmap and favicon support

Author: snapsynapse

404.html

@@ -5,11 +5,12 @@
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <title>404 — Knowledge as Code</title>
 <meta name="robots" content="noindex">
+<link rel="icon" href="/favicon.svg" type="image/svg+xml">
 <link rel="canonical" href="https://knowledge-as-code.com/">
 <style>
   :root {
     --bg: #fafaf7; --text: #141613; --muted: #5a6258;
-    --border: #e6e5dc; --accent: #059669; --highlight: #eab308;
+    --border: #e6e5dc; --accent: #047857; --highlight: #eab308;
     --highlight-soft: #fef3c7;
   }
   @media (prefers-color-scheme: dark) {

CHANGELOG.md

@@ -14,6 +14,12 @@ pattern.
 
 ## [Unreleased]
 
+### Added
+- Added roadmap commitments for first-class GuideCheck generation and a voluntary, consent-based public library of independent Knowledge-as-Code implementations.
+
+### Fixed
+- Added an SVG favicon to the canonical landing and 404 pages and to every generated and initialized site.
+
 ## [1.1.2] - 2026-07-25
 
 ### Fixed

INTENT.md

@@ -43,14 +43,39 @@ A mature end state has:
 - reproducible tests for the public golden path
 - a small release surface driven by internal needs, security findings, and independently reproduced user problems
 - documented extension contracts instead of bundled vendor integrations
-- no implied service-level agreement, community roadmap, or obligation to accept features
+- no implied service-level agreement, fixed roadmap dates, or obligation to accept features
 
 ## Adoption evidence
 
 Repository traffic, stars, social engagement, and maintainer-assisted demos are weak signals. The meaningful gate is an external pilot completed without live maintainer help. See `ADOPTION.md`.
 
 Until that gate is passed, claims should say the project is used internally and available for external reuse. They should not imply independent adoption.
 
+## Roadmap
+
+Roadmap items are directional and evidence-gated. They do not imply delivery dates or a support commitment.
+
+### GuideCheck implementation
+
+Make GuideCheck a first-class generated implementation, not only a conformance profile adopted by this canonical repository.
+
+- Generate the canonical assistant guide, root compatibility copy, and integrity sidecar for initialized Knowledge-as-Code projects.
+- Derive project-specific guide content from validated configuration instead of copying canonical-repository instructions.
+- Validate guide discovery, byte identity, integrity metadata, action boundaries, and the highest truthfully supported GuideCheck level.
+- Include GuideCheck output in the build, initializer, documentation, eval suite, and compatibility policy.
+- Keep Level 5 reserved for deployments that provide and verify the required runtime behavior.
+
+### Voluntary implementation registry
+
+Provide an opt-in way for independent maintainers to report how they use Knowledge-as-Code and, with explicit permission, appear in a public library of implementations.
+
+- Add a structured submission path for project name, public URL, repository when public, domain, short use-case description, maintainer identity or organization, and Knowledge-as-Code version.
+- Require explicit consent before displaying a submission and provide a clear update or removal path.
+- Verify that a submitted public implementation exposes a recognizable Knowledge-as-Code source or generated surface before listing it.
+- Distinguish maintainer-operated examples, independent implementations, experiments, and completed adoption pilots.
+- Publish the library from reviewable repository data so additions, corrections, provenance, and removal history remain auditable.
+- Do not add telemetry, phone-home behavior, or automatic usage reporting to the generator.
+
 ## Recalibration gates
 
 - If the initializer cannot create a working project from a clean checkout, stop feature work and restore the golden path.
@@ -73,4 +98,5 @@ None currently recorded.
 
 ## Changelog
 
+- 2026-07-25: Added GuideCheck generation and a voluntary, consent-based implementation registry to the roadmap.
 - 2026-07-21: Recalibrated the project from adoption-seeking template to internal-first open utility; made independent transfer the public adoption gate.

MANIFEST.yaml

@@ -47,9 +47,14 @@ files:
 
   - path: README.md
     role: protocol
-    hash: sha256:050155c1eed7241f8d916c647a0f13a9ce57681d48cbe266f0ff49c4d35ede2c
+    hash: sha256:c2e411e2234d7cdec0b89f42af402919f62633e7fd600399abf47e27307362e9
     note: Template overview
 
+  - path: favicon.svg
+    role: branding
+    hash: sha256:cfef3d8bcd5e0ad9c8354c5c1b599137764836694e7e3f41235215c10023567c
+    note: Canonical site favicon
+
   - path: DEPLOYMENT.md
     role: protocol
     hash: sha256:354540763d70739540da1d4bdf31f2b2ebe6fc26fa063baf08ad9f7b7f335506
@@ -77,9 +82,14 @@ files:
 
   - path: scripts/build.js
     role: tooling
-    hash: sha256:e60fd5397c275b5cf4f485488c031e3f7a32fb9e502e7f75d795621e00ae3637
+    hash: sha256:da80cae7d6e661072543189f5ed841b9ea73f3f283508b4b992aaa0118bb18a2
     note: Static site generator
 
+  - path: scripts/assets/favicon.svg
+    role: branding
+    hash: sha256:cfef3d8bcd5e0ad9c8354c5c1b599137764836694e7e3f41235215c10023567c
+    note: Favicon copied into generated sites
+
   - path: scripts/init.js
     role: tooling
     hash: sha256:e9d42face450abb17437edb78af8927dc61c4b917b267174e6fd66137b61098b
@@ -112,7 +122,7 @@ files:
 
   - path: scripts/eval.js
     role: tooling
-    hash: sha256:f19fddbecc278a7346207d7ecbd2b697a1548abbb26895efea0493f711d4dab2
+    hash: sha256:1f441afee32a8f0ad72986cba5acd227a67400c0bbff53655ce3c0a5fa8db4a7
     note: Behavioral and security regression suite
 
   - path: mcp-server.js

README.md

@@ -7,6 +7,7 @@ This repository is an internal-first open utility maintained by [PAICE.work](htt
 ## Project status
 
 - [Intent and viable end state](INTENT.md)
+- [Roadmap](INTENT.md#roadmap)
 - [Maintenance and compatibility](MAINTENANCE.md)
 - [Deployment profiles and environment overrides](DEPLOYMENT.md)
 - [Independent adoption pilot](ADOPTION.md)

demo/404.html

@@ -5,6 +5,7 @@
     <meta name="viewport" content="width=device-width, initial-scale=1.0">
     <title>Page Not Found - Example Knowledge Base</title>
     <meta name="robots" content="noindex">
+    <link rel="icon" href="/demo/assets/favicon.svg" type="image/svg+xml">
     <link rel="stylesheet" href="/demo/assets/styles.css">
     <style>/* Generated from project.yml — do not edit manually */
 .group-badge.governance { background: #7c4dff; color: #fff; }

demo/about.html

@@ -6,6 +6,7 @@
     <title>About - Example Knowledge Base</title>
     <meta name="theme-color" content="#1a1a2e">
     <link rel="canonical" href="https://knowledge-as-code.com/demo/about.html">
+    <link rel="icon" href="assets/favicon.svg" type="image/svg+xml">
     <link rel="stylesheet" href="assets/styles.css">
     <style>/* Generated from project.yml — do not edit manually */
 .group-badge.governance { background: #7c4dff; color: #fff; }

demo/applies-to/federal/index.html

@@ -6,6 +6,7 @@
     <title>Federal - Example Knowledge Base</title>
     <meta name="theme-color" content="#1a1a2e">
     <link rel="canonical" href="https://knowledge-as-code.com/demo/applies-to/federal/">
+    <link rel="icon" href="../../assets/favicon.svg" type="image/svg+xml">
     <link rel="stylesheet" href="../../assets/styles.css">
     <style>/* Generated from project.yml — do not edit manually */
 .group-badge.governance { background: #7c4dff; color: #fff; }

demo/applies-to/international/index.html

@@ -6,6 +6,7 @@
     <title>International - Example Knowledge Base</title>
     <meta name="theme-color" content="#1a1a2e">
     <link rel="canonical" href="https://knowledge-as-code.com/demo/applies-to/international/">
+    <link rel="icon" href="../../assets/favicon.svg" type="image/svg+xml">
     <link rel="stylesheet" href="../../assets/styles.css">
     <style>/* Generated from project.yml — do not edit manually */
 .group-badge.governance { background: #7c4dff; color: #fff; }