Remove redundant CLAUDE doc and clean local generated artifacts

Author: CSVillain

.github/workflows/validate.yml

@@ -0,0 +1,100 @@
+name: Validate Site
+
+on:
+  pull_request:
+    branches: [main]
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  validate:
+    runs-on: ubuntu-latest
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+
+      - name: Build with Jekyll
+        uses: actions/jekyll-build-pages@v1
+        with:
+          source: .
+          destination: ./_site
+
+      - name: Validate generated output
+        run: |
+          set -euo pipefail
+
+          for f in \
+            _site/index.html \
+            _site/assets.html \
+            _site/challenge.html \
+            _site/capability.html \
+            _site/framework.html \
+            _site/decisions.html \
+            _site/measurement.html \
+            _site/barriers.html \
+            _site/assets/css/site.css \
+            _site/assets/js/site.js \
+            _site/assets/images/network.png \
+            _site/assets/images/kore-logo-horizontal-gradient-dark.svg; do
+            test -f "$f" || { echo "Missing expected file: $f"; exit 1; }
+          done
+
+          python3 - <<'PY'
+          import re
+          import pathlib
+          import sys
+
+          pages = [
+              "_site/index.html",
+              "_site/assets.html",
+              "_site/challenge.html",
+              "_site/capability.html",
+              "_site/framework.html",
+              "_site/decisions.html",
+              "_site/measurement.html",
+              "_site/barriers.html",
+          ]
+          nav_targets = [
+              "/assets.html",
+              "/challenge.html",
+              "/capability.html",
+              "/framework.html",
+              "/decisions.html",
+              "/measurement.html",
+              "/barriers.html",
+          ]
+          expected_canonical = {
+              "_site/index.html": "https://knowledge-intelligence.dev/",
+              "_site/assets.html": "https://knowledge-intelligence.dev/assets.html",
+              "_site/challenge.html": "https://knowledge-intelligence.dev/challenge.html",
+              "_site/capability.html": "https://knowledge-intelligence.dev/capability.html",
+              "_site/framework.html": "https://knowledge-intelligence.dev/framework.html",
+              "_site/decisions.html": "https://knowledge-intelligence.dev/decisions.html",
+              "_site/measurement.html": "https://knowledge-intelligence.dev/measurement.html",
+              "_site/barriers.html": "https://knowledge-intelligence.dev/barriers.html",
+          }
+
+          for page in pages:
+              html = pathlib.Path(page).read_text(encoding="utf-8")
+              if 'href="/assets/css/site.css"' not in html:
+                  print(f"Missing shared CSS reference in {page}")
+                  sys.exit(1)
+              if 'src="/assets/js/site.js"' not in html:
+                  print(f"Missing shared JS reference in {page}")
+                  sys.exit(1)
+              for target in nav_targets:
+                  if f'href="{target}"' not in html:
+                      print(f"Missing nav target {target} in {page}")
+                      sys.exit(1)
+              match = re.search(r'<link rel="canonical" href="([^"]+)"', html)
+              if not match:
+                  print(f"Missing canonical tag in {page}")
+                  sys.exit(1)
+              if match.group(1) != expected_canonical[page]:
+                  print(f"Canonical mismatch in {page}: {match.group(1)}")
+                  sys.exit(1)
+
+          print("Validation passed.")
+          PY

.gitignore

@@ -13,6 +13,12 @@ instructions/
 # Local Claude Code settings
 .claude/
 
+# Jekyll local build and cache artifacts
+_site/
+.jekyll-cache/
+.jekyll-metadata
+.sass-cache/
+
 # Images not used by the deployed site
 images/3d-network.png
 images/blue-graph.png
@@ -23,4 +29,3 @@ images/mockup-tacit-constellation.svg
 images/dalle-prompt-pack.md
 images/diagrams/
 images/simple_landing_concept_1.png
-_site/

AGENTS.md

@@ -2,6 +2,11 @@
 
 Repository-specific guidance for Codex and other coding agents.
 
+## Authority
+- This file is the single source of truth for agent behavior in this repository.
+- If another agent-specific file conflicts with this file, follow `AGENTS.md`.
+- Agent-specific files are optional compatibility notes only and must not override this file.
+
 ## Project Context
 - Repo: `knowledge-intelligence`
 - Type: Static GitHub Pages site (Jekyll build in CI)
@@ -31,6 +36,12 @@ Repository-specific guidance for Codex and other coding agents.
 - Public URLs stay root-level (`/assets.html`, etc.) via `permalink` values in `pages/*.html`.
 - Keep `CNAME` in the repo root to preserve custom domain mapping.
 
+## Content Governance
+- Write in plain, precise language; avoid hype and transformation buzzwords.
+- Avoid unverified statistics or claims.
+- Prefer structurally defensible assertions tied to governance, measurement, and decision quality.
+- Treat Knowledge Intelligence as an operating/governance capability, not a marketing category.
+
 ## Validation Checklist (Before Commit)
 1. Confirm changed assets exist and paths in `index.html` / `pages/*.html` are correct.
 2. Verify no local/internal directories were unintentionally unignored for publishing.

CLAUDE.md

@@ -31,4 +31,35 @@ The site is deployed by GitHub Actions + GitHub Pages via `.github/workflows/dep
 - Published artifact: `./_site`
 - Public chapter URLs remain clean at root (`/assets.html`, `/challenge.html`, etc.) via page-level `permalink` front matter in `pages/*.html`
 
+## Editing guide
+
+- Update homepage content in `index.html`.
+- Update chapter content in `pages/*.html`.
+- Keep each chapter front matter intact:
+  - `---`
+  - `permalink: /<chapter>.html`
+  - `---`
+- Shared presentation logic belongs in:
+  - `assets/css/site.css`
+  - `assets/js/site.js`
+- Use root-relative paths for internal links and assets (e.g. `/assets.html`, `/assets/css/site.css`).
+
+## Quality checks
+
+- PR validation workflow: `.github/workflows/validate.yml`
+  - Builds with Jekyll
+  - Verifies expected output files
+  - Verifies canonical tags and critical nav links
+
+Local validation (optional):
+
+```bash
+JEKYLL_ENV=production jekyll build --source . --destination ./_site
+```
+
+## SEO and crawl files
+
+- `robots.txt`
+- `sitemap.xml`
+
 From information abundance to decision advantage.