Migrate to Jekyll Pages build, reorganize content pages, and update docs

Author: CSVillain

.github/workflows/deploy.yml

@@ -15,10 +15,7 @@ concurrency:
   cancel-in-progress: false
 
 jobs:
-  deploy:
-    environment:
-      name: github-pages
-      url: ${{ steps.deployment.outputs.page_url }}
+  build:
     runs-on: ubuntu-latest
     steps:
       - name: Checkout
@@ -27,11 +24,24 @@ jobs:
       - name: Setup Pages
         uses: actions/configure-pages@v5
 
+      - name: Build with Jekyll
+        uses: actions/jekyll-build-pages@v1
+        with:
+          source: .
+          destination: ./_site
+
       - name: Upload artifact
         uses: actions/upload-pages-artifact@v3
         with:
-          path: .
+          path: ./_site
 
+  deploy:
+    needs: build
+    environment:
+      name: github-pages
+      url: ${{ steps.deployment.outputs.page_url }}
+    runs-on: ubuntu-latest
+    steps:
       - name: Deploy to GitHub Pages
         id: deployment
         uses: actions/deploy-pages@v4

.gitignore

@@ -23,3 +23,4 @@ images/mockup-tacit-constellation.svg
 images/dalle-prompt-pack.md
 images/diagrams/
 images/simple_landing_concept_1.png
+_site/

AGENTS.md

@@ -4,17 +4,19 @@ Repository-specific guidance for Codex and other coding agents.
 
 ## Project Context
 - Repo: `knowledge-intelligence`
-- Type: Static GitHub Pages site (no build step)
+- Type: Static GitHub Pages site (Jekyll build in CI)
 - Entry point: `index.html`
-- Assets: `assets/`, `images/`
+- Content pages source: `pages/*.html` (with Jekyll `permalink` front matter for clean root URLs)
+- Assets: `assets/css/`, `assets/js/`, `assets/images/`
 - Custom domain configured via `CNAME` (`knowledge-intelligence.dev`)
 - Deployment workflow: `.github/workflows/deploy.yml`
 
 ## Safe Edit Scope
 - Default editable files for site updates:
   - `index.html`
+  - `pages/**`
   - `assets/**`
-  - `images/**` (only files referenced by `index.html`)
+  - `README.md`
   - `.github/workflows/deploy.yml` (only when changing deployment behavior)
 - Avoid editing these unless explicitly requested:
   - `research/`
@@ -24,17 +26,18 @@ Repository-specific guidance for Codex and other coding agents.
 
 ## Deployment Model
 - Deploy trigger: push to `main` or manual workflow dispatch.
-- Pages artifact path is repository root (`.`), so published files must stay in root-relative layout.
+- Build step uses `actions/jekyll-build-pages@v1` and outputs `./_site`.
+- Pages deploy artifact path is `./_site`.
+- 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.
 
 ## Validation Checklist (Before Commit)
-1. Confirm changed assets exist and paths in `index.html` are correct.
+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.
-3. Ensure `.github/workflows/deploy.yml` still uploads the correct artifact path (`.`).
+3. Ensure `.github/workflows/deploy.yml` still builds and uploads `./_site`.
 4. If links are changed, prefer absolute domain links or root-relative links consistent with Pages hosting.
 
 ## Git Hygiene
 - Keep commits focused and small.
 - Do not force-push unless explicitly requested.
 - Do not revert unrelated local changes made by the user.
-

CLAUDE.md

@@ -16,30 +16,30 @@ This repository publishes the **Knowledge Intelligence** white paper and framewo
 
 ```
 knowledge-intelligence/
-├── index.html                    # Single-page website (all HTML, CSS, JS inline)
+├── index.html                    # Landing page and chapter hub
+├── pages/
+│   ├── assets.html               # Source page (permalink: /assets.html)
+│   ├── barriers.html             # Source page (permalink: /barriers.html)
+│   ├── capability.html           # Source page (permalink: /capability.html)
+│   ├── challenge.html            # Source page (permalink: /challenge.html)
+│   ├── decisions.html            # Source page (permalink: /decisions.html)
+│   ├── framework.html            # Source page (permalink: /framework.html)
+│   └── measurement.html          # Source page (permalink: /measurement.html)
 ├── CNAME                         # Custom domain — do not delete
 ├── README.md                     # Project overview
 ├── AGENTS.md                     # Coding agent guidance (Codex/OpenAI)
 ├── CLAUDE.md                     # This file
 ├── assets/
-│   └── kore-logo-horizontal-gradient-dark.svg
-├── images/
-│   ├── network.png               # Hero background
-│   └── Henley docs/              # Reference PDF materials
-├── .github/
-│   └── workflows/
-│       └── deploy.yml            # GitHub Pages deployment pipeline
-├── instructions/                 # Authoritative content governance documents
-│   ├── Knowledge_Intelligence_Executive_Instruction_Block.md
-│   ├── Knowledge_Intelligence_Full_Instruction_Set.md
-│   ├── Knowledge_Intelligence_Red_Team_Instruction_Set.md
-│   └── Knowledge_Intelligence_Strategy_Governance_Pack_v1.0.md
-└── research/                     # Supporting research reports
-    ├── know-intl-deep-research-report.md
-    ├── know-intl-deep-research-report-v2.md
-    ├── know-intl-deep-research-report-v3.md      # Most complete version
-    ├── kore-deep-research-report.md
-    └── Henley docs/
+│   ├── css/
+│   │   └── site.css              # Shared stylesheet
+│   ├── js/
+│   │   └── site.js               # Shared JavaScript
+│   └── images/
+│       ├── kore-logo-horizontal-gradient-dark.svg
+│       └── network.png
+└── .github/
+    └── workflows/
+        └── deploy.yml            # GitHub Pages deployment pipeline
 ```
 
 ---
@@ -48,9 +48,9 @@ knowledge-intelligence/
 
 | Concern | Detail |
 |---|---|
-| Site type | Static HTML — no build step, no framework |
-| Styling | Embedded CSS in `index.html` (CSS variables, dark theme) |
-| JS | Minimal inline scripts + Lucide icons via CDN |
+| Site type | Static HTML source + Jekyll build for clean URL routing |
+| Styling | Shared CSS in `assets/css/site.css` |
+| JS | Shared JS in `assets/js/site.js` + Lucide icons via CDN |
 | Fonts | Google Fonts (Bricolage Grotesque, DM Sans, Inter, Space Grotesk) |
 | Deployment | GitHub Actions → GitHub Pages |
 | Package manager | None |
@@ -64,34 +64,33 @@ knowledge-intelligence/
 Default editable files for site updates:
 
 - `index.html`
+- `pages/**`
 - `assets/**`
-- `images/**` (only files already referenced by `index.html`)
+- `README.md`
 - `.github/workflows/deploy.yml` (only when changing deployment behaviour)
 
 **Do not edit unless explicitly requested:**
 
-- `research/` — research reports used as source material
-- `instructions/` — authoritative governance and instruction documents
-- `whitepaper/`, `tools/` — reserved directories (not yet created)
 - `CNAME` — must remain at repo root to preserve custom domain mapping
 
 ---
 
 ## Deployment
 
 - **Trigger**: push to `main` or manual workflow dispatch via GitHub UI
-- **Artifact path**: repository root (`.`) — all published files must remain in a root-relative layout
+- **Build**: `actions/jekyll-build-pages@v1` (source `.` → destination `./_site`)
+- **Artifact path**: `./_site`
 - **Custom domain**: configured via `CNAME`; never delete this file
 
-Pushing to `main` is the only required deploy action. There is no build, compile, or bundle step.
+Pushing to `main` is the required deploy action; GitHub Actions handles the Jekyll build and Pages deploy.
 
 ---
 
 ## Validation Checklist (Before Committing)
 
-1. Confirm changed assets exist and all paths in `index.html` are correct.
+1. Confirm changed assets exist and all paths in `index.html` / `pages/*.html` are correct.
 2. Verify no internal/unintended directories have been exposed for publishing (check `.gitignore`).
-3. Ensure `.github/workflows/deploy.yml` still references the correct artifact path (`.`).
+3. Ensure `.github/workflows/deploy.yml` still builds and uploads `./_site`.
 4. If links were changed, use absolute domain links or root-relative paths consistent with GitHub Pages hosting.
 5. Content changes must comply with the writing constraints below.
 
@@ -202,28 +201,16 @@ When developing or extending white paper content, follow this arc:
 
 ---
 
-## Research Materials
-
-The `research/` directory contains supporting reports. The most complete reference is:
-
-- `research/know-intl-deep-research-report-v3.md` — reference architecture, capability layers, open-source toolchain, use cases
-- `research/kore-deep-research-report.md` — Kore Common Knowledge Asset (CKA) Standard v1.3, signal computation formulas, lifecycle states
-
-These are **source material**, not published content. Do not treat them as authoritative outputs.
-
----
-
 ## What Claude Should and Should Not Do
 
 **Do:**
-- Edit `index.html` for visual, structural, or content updates as requested
+- Edit `index.html` and `pages/*.html` for visual, structural, or content updates as requested
 - Follow the content governance constraints above for any text additions
 - Keep commits small and descriptive
 - Respect the safe edit scope boundaries
 
 **Do not:**
 - Add marketing language, hype, or transformation claims to white paper content
-- Edit `instructions/` or `research/` unless explicitly asked
 - Add unverified statistics or claims
 - Delete `CNAME`
 - Push to `main` without confirmation

README.md

@@ -1,29 +1,34 @@
 # Knowledge Intelligence
 
-A strategic overview of **Knowledge Intelligence (KI)** as an enterprise capability.
-
-## 📘 White Paper Contents
-
-- [🧩 Opening Statement](https://knowledge-intelligence.dev/#opening)
-- [🧠 1 - What Knowledge Actually Is](https://knowledge-intelligence.dev/#knowledge)
-- [📏 2 - The Measurement Problem](https://knowledge-intelligence.dev/#challenge)
-- [⚡ 3 - Why Now](https://knowledge-intelligence.dev/#whynow)
-- [🗂️ 4 - Content Intelligence](https://knowledge-intelligence.dev/#ki)
-- [🔍 5 - Knowledge Intelligence](https://knowledge-intelligence.dev/#ki)
-- [🏛️ 6 - The Knowledge Intelligence Framework](https://knowledge-intelligence.dev/#standard)
-- [🧾 7 - Decision Cases](https://knowledge-intelligence.dev/#decisions)
-- [📊 8 - Measuring Knowledge Intelligence](https://knowledge-intelligence.dev/#kpi)
-- [🧭 9 - What Leadership Must Do](https://knowledge-intelligence.dev/#leadership)
-- [🧱 10 - What Makes This Hard](https://knowledge-intelligence.dev/#barriers)
-- [🎬 Closing Statement](https://knowledge-intelligence.dev/#leadership)
+A strategic overview of Knowledge Intelligence (KI) as an enterprise capability.
 
-From information abundance to decision advantage.
+## Site map
+
+- Home: https://knowledge-intelligence.dev/
+- The Assets: https://knowledge-intelligence.dev/assets.html
+- The Challenge: https://knowledge-intelligence.dev/challenge.html
+- The Capability: https://knowledge-intelligence.dev/capability.html
+- The Framework: https://knowledge-intelligence.dev/framework.html
+- The Decisions: https://knowledge-intelligence.dev/decisions.html
+- The Measurement: https://knowledge-intelligence.dev/measurement.html
+- The Barriers: https://knowledge-intelligence.dev/barriers.html
+
+## Repository structure
 
----
-<br>
+- `index.html`: landing page and chapter hub
+- `pages/`: chapter pages
+- `assets/css/site.css`: shared styles
+- `assets/js/site.js`: shared scripts
+- `assets/images/`: image assets
+- `CNAME`: custom domain mapping (`knowledge-intelligence.dev`)
 
+## Deployment
 
-<p align="center">
-  <img src="assets/kore-logo-horizontal-gradient-dark.svg" alt="Kore Logo" width="220" />
-</p>
-<p align="center"><strong>Coming soon. 🚀</strong></p>
+The site is deployed by GitHub Actions + GitHub Pages via `.github/workflows/deploy.yml`.
+
+- Trigger: push to `main` or manual dispatch
+- Build: Jekyll build (`actions/jekyll-build-pages@v1`)
+- Published artifact: `./_site`
+- Public chapter URLs remain clean at root (`/assets.html`, `/challenge.html`, etc.) via page-level `permalink` front matter in `pages/*.html`
+
+From information abundance to decision advantage.