From e60a29ead99dad16c139a9ea6111a2e1c3cb7796 Mon Sep 17 00:00:00 2001 From: Heliton Nordt <1625399+hnordt@users.noreply.github.com> Date: Sun, 26 Jul 2026 18:10:36 -0300 Subject: [PATCH 1/3] Clarify Hyperkernel application platform positioning --- AGENTS.md | 2 +- README.md | 6 +++--- package.json | 8 +++++--- 3 files changed, 9 insertions(+), 7 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 5377118..47b31dd 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -6,7 +6,7 @@ When older documentation, an experiment, or a spike conflicts with these files, ## Mission -Hyperkernel is building a small, highly trusted kernel for systems whose applications, interfaces, workflows, and integrations may evolve quickly. +Hyperkernel is a self-hostable application platform built around a small, highly trusted kernel. Developers and organizations build applications, interfaces, workflows, and integrations on top of it. Optimize kernel work for correctness, auditability, deterministic recovery, security, and long-term compatibility. Optimize work outside the kernel for safe iteration without allowing it to bypass kernel contracts. diff --git a/README.md b/README.md index c985f64..0a10524 100644 --- a/README.md +++ b/README.md @@ -1,10 +1,10 @@ # Hyperkernel -**Open-source primitives for building reliable, auditable, self-hosted software platforms.** +**An open-source, self-hostable application platform for building and running reliable, auditable apps that work together.** -Hyperkernel is an open-source project building a small set of production-grade primitives for developers creating platforms for themselves or for small businesses, with or without AI assistance. The goal is software that can be trusted, audited, repaired, and continuously evolved. +Hyperkernel provides a shared kernel and workspace on which developers and organizations build modular applications. Those applications share platform contracts for identity, permissions, state, events, and audit history; together, they form a software platform tailored to their work. -The project separates software into two trust zones: +The platform separates software into two trust zones: - a small kernel whose contracts are designed to be stable, extensively tested, and reviewed by experienced humans; - applications, interfaces, workflows, and integrations that can evolve faster, whether built by developers, developers using AI, or AI agents operating within explicit boundaries. diff --git a/package.json b/package.json index e4f888f..5de83b8 100644 --- a/package.json +++ b/package.json @@ -2,7 +2,7 @@ "name": "@hnordt/hyperkernel", "version": "0.0.1", "private": true, - "description": "Open-source primitives for building reliable, auditable, self-hosted software platforms", + "description": "An open-source, self-hostable application platform for building and running reliable, auditable apps that work together.", "license": "MIT", "repository": { "type": "git", @@ -14,8 +14,10 @@ }, "keywords": [ "application-platform", - "event-sourcing", - "self-hosting" + "modular-applications", + "app-development", + "self-hosted", + "audit-log" ], "type": "module", "engines": { From 0c2f6f1656b51c23a712159a7e2a8d6a8029d74d Mon Sep 17 00:00:00 2001 From: Heliton Nordt <1625399+hnordt@users.noreply.github.com> Date: Sun, 26 Jul 2026 18:34:38 -0300 Subject: [PATCH 2/3] Align README with the application platform positioning --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/README.md b/README.md index 0a10524..5eace34 100644 --- a/README.md +++ b/README.md @@ -2,7 +2,7 @@ **An open-source, self-hostable application platform for building and running reliable, auditable apps that work together.** -Hyperkernel provides a shared kernel and workspace on which developers and organizations build modular applications. Those applications share platform contracts for identity, permissions, state, events, and audit history; together, they form a software platform tailored to their work. +Hyperkernel provides a shared kernel and workspace on which developers and organizations build and run modular applications. Those applications share platform contracts for identity, permissions, state, events, and audit history; together, they form a software platform tailored to the work they support. The platform separates software into two trust zones: @@ -113,9 +113,9 @@ Examples include: - a business operations environment for an independent developer or small company; - a personal work and routine-management environment for developers; - auditable workflows in which people and external AI agents collaborate; -- custom self-hosted platforms composed from shared kernel primitives. +- a tailored, self-hosted suite of modular applications running on Hyperkernel. -These are examples, not hard-coded products. Hyperkernel provides the foundation; applications provide the domain. +These are examples, not hard-coded products. Hyperkernel provides the application platform; applications provide the domain. ## Status From 987bfb38ff09b36a33762c4aeded300e1077655f Mon Sep 17 00:00:00 2001 From: Heliton Nordt <1625399+hnordt@users.noreply.github.com> Date: Sun, 26 Jul 2026 18:34:43 -0300 Subject: [PATCH 3/3] Align agent guidance with the application platform positioning --- AGENTS.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/AGENTS.md b/AGENTS.md index 47b31dd..d10c7da 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -6,7 +6,7 @@ When older documentation, an experiment, or a spike conflicts with these files, ## Mission -Hyperkernel is a self-hostable application platform built around a small, highly trusted kernel. Developers and organizations build applications, interfaces, workflows, and integrations on top of it. +Hyperkernel is a self-hostable application platform built around a small, highly trusted kernel. Developers and organizations build and run modular applications on Hyperkernel. Together, those applications form a software platform tailored to the work they support. Optimize kernel work for correctness, auditability, deterministic recovery, security, and long-term compatibility. Optimize work outside the kernel for safe iteration without allowing it to bypass kernel contracts.