From 358eb004c32c886d2c1f434152f1b2d29d8b96a4 Mon Sep 17 00:00:00 2001 From: Kirk Marple Date: Fri, 21 Aug 2026 18:19:14 -0700 Subject: [PATCH 1/2] Refresh Clockgrove public home page --- README.md | 40 +++++++++++++++++----------------------- profile/README.md | 36 ++++++++++++++++-------------------- 2 files changed, 33 insertions(+), 43 deletions(-) diff --git a/README.md b/README.md index f086cc2..3cfcf69 100644 --- a/README.md +++ b/README.md @@ -1,35 +1,29 @@ -# Clockgrove organization configuration +# Clockgrove -This repository contains organization-level GitHub configuration and the public Clockgrove organization profile. +Clockgrove is an open-source platform for building persistent artificial-life worlds: places that keep time, change while nobody is watching, remember what happened, and give their inhabitants meaningful lives of their own. -## Copilot capability marketplace +Our guiding idea is simple: -`.github/plugin/marketplace.json` publishes the Clockgrove capability packages used by project repositories: +> Build persistent worlds from deterministic physical truth and subjective, agentic cognition. -- `clockgrove-factory` — Director and engineering-management capabilities from `clockgrove/factory`; -- `clockgrove-skills` — reusable Clockgrove product/engineering skills from `clockgrove/skills`. +## Worlds that feel alive -The source repositories contain GitHub Copilot-compatible root `plugin.json` manifests. This repository is the shared marketplace catalog; Factory and Skills do not need to duplicate it. +Clockgrove brings together: -Register and install the packages with GitHub Copilot CLI: +- persistent simulation, where time, weather, resources, movement, and growth continue to matter; +- characters who perceive, remember, form beliefs, build relationships, and learn from experience; +- conversations grounded in what each character knows and has lived through; +- inspectable history, so important events and behaviors can be traced back to their causes; and +- safe creative tools for shaping worlds without giving AI unchecked control over their reality. -```bash -copilot plugin marketplace add clockgrove/.github -copilot plugin install clockgrove-factory@clockgrove -copilot plugin install clockgrove-skills@clockgrove -``` +The simulation remains the source of truth. AI can reason, speak, plan, and propose actions, while the world itself stays consistent, testable, and understandable. -A plugin can also be installed directly from its repository without registering the marketplace: +## Meet Raccoon World -```bash -copilot plugin install clockgrove/factory -copilot plugin install clockgrove/skills -``` +Clockgrove's first reference world is a cozy Pacific Northwest raccoon neighborhood. Rain changes comfort and resources, food appears and disappears, plants grow, neighbors learn from one another, and relationships influence what happens next. -Target repositories can enable the marketplace and packages declaratively through `.github/copilot/settings.json`. The marketplace is distribution/configuration only; product authority remains in the target repository, Factory behavior remains in `clockgrove/factory`, and shared skill behavior remains in `clockgrove/skills`. +It is a small world designed to explore a big question: what becomes possible when a digital place has continuity, memory, and inhabitants whose experiences genuinely matter? -## Release discipline +## Growing the grove -Versioned capability entries use the GitHub Copilot source object's `sha` field with a full immutable commit SHA, as recommended for reproducible installs. They never use a moving branch or tag. `scripts/validate-marketplace.py` and the corresponding GitHub Actions check enforce the release inventory and pin format before changes are merged. - -Consumer repositories may additionally pin the marketplace repository itself to a reviewed commit SHA so their complete capability resolution is reproducible. +Clockgrove is under active development. We are currently building the foundations for persistent simulation, memorable characters, and worlds that can grow richer over time. diff --git a/profile/README.md b/profile/README.md index 38c34bb..3cfcf69 100644 --- a/profile/README.md +++ b/profile/README.md @@ -1,33 +1,29 @@ # Clockgrove -Clockgrove is an open-source project exploring persistent artificial-life worlds: deterministic physical simulation paired with agentic cognition, memory, conversation, causality, and worlds that continue to change over time. +Clockgrove is an open-source platform for building persistent artificial-life worlds: places that keep time, change while nobody is watching, remember what happened, and give their inhabitants meaningful lives of their own. -## Repositories +Our guiding idea is simple: -### `clockgrove/clockgrove` +> Build persistent worlds from deterministic physical truth and subjective, agentic cognition. -The Clockgrove platform/runtime and its reference world. This is where product requirements, runtime architecture, world semantics, implementation waves, and product source live. +## Worlds that feel alive -### `clockgrove/factory` +Clockgrove brings together: -A GitHub-native engineering-management capability package centered on **Director**. Factory turns human Objectives into planned, prioritized, supervised, evaluated, and continuously improving engineering work while using GitHub for project/execution state and deterministic guardrails wherever possible. +- persistent simulation, where time, weather, resources, movement, and growth continue to matter; +- characters who perceive, remember, form beliefs, build relationships, and learn from experience; +- conversations grounded in what each character knows and has lived through; +- inspectable history, so important events and behaviors can be traced back to their causes; and +- safe creative tools for shaping worlds without giving AI unchecked control over their reality. -### `clockgrove/skills` +The simulation remains the source of truth. AI can reason, speak, plan, and propose actions, while the world itself stays consistent, testable, and understandable. -Reusable Clockgrove product and engineering skills. These provide domain competence independently from Factory's engineering-management capabilities. +## Meet Raccoon World -### `clockgrove/.github` +Clockgrove's first reference world is a cozy Pacific Northwest raccoon neighborhood. Rain changes comfort and resources, food appears and disappears, plants grow, neighbors learn from one another, and relationships influence what happens next. -Organization profile and the Clockgrove Copilot plugin marketplace used to distribute Factory and Skills to target repositories. +It is a small world designed to explore a big question: what becomes possible when a digital place has continuity, memory, and inhabitants whose experiences genuinely matter? -## Project principles +## Growing the grove -- Durable truth is explicit and inspectable. -- Agent cognition is powerful without becoming implicit authority. -- GitHub provides the engineering substrate; Factory provides engineering management; Skills provide reusable engineering competence. -- Deterministic controls are enforced mechanically where possible rather than delegated to model judgment. -- Commodity infrastructure is reused before custom infrastructure is built. -- Target projects remain independently buildable and operable without Factory as a runtime dependency. -- Documentation and architecture are publication-ready by default. - -The projects are under active development. Public contribution and release guidance will be added as individual repositories reach their open-source readiness gates. +Clockgrove is under active development. We are currently building the foundations for persistent simulation, memorable characters, and worlds that can grow richer over time. From 4fe2ca4bd406b7b9e1e8b10fab30ad32ad261d4f Mon Sep 17 00:00:00 2001 From: Kirk Marple Date: Fri, 21 Aug 2026 18:28:01 -0700 Subject: [PATCH 2/2] Run required validation on every pull request --- .github/workflows/validate-marketplace.yml | 8 -------- 1 file changed, 8 deletions(-) diff --git a/.github/workflows/validate-marketplace.yml b/.github/workflows/validate-marketplace.yml index 7bbfbb3..ff56ac8 100644 --- a/.github/workflows/validate-marketplace.yml +++ b/.github/workflows/validate-marketplace.yml @@ -2,16 +2,8 @@ name: Validate Clockgrove Marketplace on: pull_request: - paths: - - '.github/plugin/marketplace.json' - - 'scripts/validate-marketplace.py' - - '.github/workflows/validate-marketplace.yml' push: branches: [main] - paths: - - '.github/plugin/marketplace.json' - - 'scripts/validate-marketplace.py' - - '.github/workflows/validate-marketplace.yml' permissions: contents: read