Skip to content

Practical patterns, starters & CLI tools for loop engineering with AI coding agents. Design systems that prompt and orchestrate agents (inspired by Addy Osmani and Boris Cherny). Includes loop-audit, loop-init, loop-cost.

Restructure KY cut surface philosophy for repo discoverability

Cobus Greyling8e7e71dd587f
diff --git a/KY_Cut_Surface_Philosophy_v0_1/README.md b/KY_Cut_Surface_Philosophy_v0_1/README.md
deleted file mode 100644
index 786c90a..0000000
--- a/KY_Cut_Surface_Philosophy_v0_1/README.md
+++ /dev/null
@@ -1,23 +0,0 @@
-# KY Cut Surface Philosophy v0.1
-
-STATUS: OPEN_AS_PUBLIC_PHILOSOPHY / HOLD_AS_TECHNICAL_CLAIM / KILL_AS_OVERCLAIM
-
-This artifact preserves a public-facing philosophical note on the distinction between generation and consequence.
-
-Core thesis:
-
-Candidate generation is not consequence realization.
-
-Files:
-
-- linkedin_post_july06.txt
-- compressed_version.txt
-- alternative_openers.txt
-- TERMINAL_ART.txt
-
-Boundary:
-
-- public philosophy: OPEN
-- technical proof claim: HOLD
-- physics validation claim: HOLD
-- autonomous system claim: KILL
diff --git a/KY_Cut_Surface_Philosophy_v0_1/linkedin_post_july06.txt b/KY_Cut_Surface_Philosophy_v0_1/linkedin_post_july06.txt
deleted file mode 100644
index b99654c..0000000
--- a/KY_Cut_Surface_Philosophy_v0_1/linkedin_post_july06.txt
+++ /dev/null
@@ -1,11 +0,0 @@
-Det finnes et punkt hvor teori møter menneske, språk og signal. Jeg kaller det kuttflaten.
-
-Mye av det vi bygger i dag forveksler generasjon med realisering. Vi forledes til å tro at mulighet er det samme som konsekvens. Men i systemer hvor innsatsen er høy, er forskjellen mellom disse to altavgjørende.
-
-Gjenkjennelse begynner ikke alltid som en tanke. Den begynner som trykk. Utfordringen er å bære dette trykket gjennom arkitekturen uten at det forvrenges eller smelter sammen til en falsk helhet.
-
-Vi bygger ikke for å generere mest mulig data. Vi bygger for å bevare de skillene som gjør dom, og dermed ansvar, mulig.
-
-Det er her arkivdisiplin, signalintegritet og The Non-Lying Kernel kommer inn. Ikke som mystikk, men som disiplin: free dynamics får ikke passere som physically persistent trajectories uten en warrant som holder vann.
-
-Målet er enkelt, men krevende: At maskinell form og menneskelig kilde forblir adskilte nok til at vi kan bære konsekvensene av det vi setter i gang.
diff --git a/KY_Cut_Surface_Philosophy_v0_1/MANIFEST.sha256 b/resources/ky-cut-surface-philosophy-v0_1/MANIFEST.sha256
similarity index 58%
rename from KY_Cut_Surface_Philosophy_v0_1/MANIFEST.sha256
rename to resources/ky-cut-surface-philosophy-v0_1/MANIFEST.sha256
index 9c6b173..716deab 100644
--- a/KY_Cut_Surface_Philosophy_v0_1/MANIFEST.sha256
+++ b/resources/ky-cut-surface-philosophy-v0_1/MANIFEST.sha256
@@ -1,5 +1,4 @@
-e071b3c835756c1a9421097783f756e223cb23d573d842040013152281a7dabd README.md
+ad7e51c72c94bf01cec4eba3cc94e1a3ae9c507151456d05d7075ec969a035bd README.md
21914927279637f60297caa20944cbc559e82400ac9c37d03b687e5f26f55aaa TERMINAL_ART.txt
06c5f8c4ca55691f775ec9f4475383cd0cfb6c6fe07230f6291aec8b348c6258 alternative_openers.txt
-55a9bb4ec71c728f342da28f48b35c77e39069c6ce31aa79b5a017cc202b28ab compressed_version.txt
-6e53547f058a5c0acc7e3d19f3ed82f68013fc4c15a1f7dfdc52ebe8ecb1c7eb linkedin_post_july06.txt
+55a9bb4ec71c728f342da28f48b35c77e39069c6ce31aa79b5a017cc202b28ab compressed_version.txt
\ No newline at end of file
diff --git a/KY_Cut_Surface_Philosophy_v0_1/MANIFEST_VERIFY.txt b/resources/ky-cut-surface-philosophy-v0_1/MANIFEST_VERIFY.txt
similarity index 52%
rename from KY_Cut_Surface_Philosophy_v0_1/MANIFEST_VERIFY.txt
rename to resources/ky-cut-surface-philosophy-v0_1/MANIFEST_VERIFY.txt
index 54b4374..d294b7a 100644
--- a/KY_Cut_Surface_Philosophy_v0_1/MANIFEST_VERIFY.txt
+++ b/resources/ky-cut-surface-philosophy-v0_1/MANIFEST_VERIFY.txt
@@ -1,5 +1,4 @@
README.md: OK
TERMINAL_ART.txt: OK
alternative_openers.txt: OK
-compressed_version.txt: OK
-linkedin_post_july06.txt: OK
+compressed_version.txt: OK
\ No newline at end of file
diff --git a/resources/ky-cut-surface-philosophy-v0_1/README.md b/resources/ky-cut-surface-philosophy-v0_1/README.md
new file mode 100644
index 0000000..79cee11
--- /dev/null
+++ b/resources/ky-cut-surface-philosophy-v0_1/README.md
@@ -0,0 +1,28 @@
+# KY Cut Surface Philosophy v0.1
+
+**Status:** OPEN (public philosophy) · HOLD (technical claim) · KILL (overclaim)
+
+Archived philosophy artifact contributed by [@sololys](https://github.com/sololys). Not a pattern, runtime, or validation claim.
+
+**Core thesis:** candidate generation is not consequence realization.
+
+**Loop engineering bridge:** see [stories/ky-cut-surface-generation-vs-consequence.md](../../stories/ky-cut-surface-generation-vs-consequence.md).
+
+## Files
+
+| File | Description |
+|------|-------------|
+| `compressed_version.txt` | Short Norwegian note (canonical text) |
+| `alternative_openers.txt` | Alternate openers (Norwegian) |
+| `TERMINAL_ART.txt` | Terminal art rendering |
+
+## Boundary
+
+| Interpretation | Status |
+|----------------|--------|
+| Public philosophy | OPEN |
+| Technical proof claim | HOLD |
+| Physics validation claim | HOLD |
+| Autonomous system claim | KILL |
+
+Manifest files (`MANIFEST.sha256`, `MANIFEST_VERIFY.txt`) are for archive discipline only.
\ No newline at end of file
diff --git a/KY_Cut_Surface_Philosophy_v0_1/TERMINAL_ART.txt b/resources/ky-cut-surface-philosophy-v0_1/TERMINAL_ART.txt
similarity index 100%
rename from KY_Cut_Surface_Philosophy_v0_1/TERMINAL_ART.txt
rename to resources/ky-cut-surface-philosophy-v0_1/TERMINAL_ART.txt
diff --git a/KY_Cut_Surface_Philosophy_v0_1/alternative_openers.txt b/resources/ky-cut-surface-philosophy-v0_1/alternative_openers.txt
similarity index 100%
rename from KY_Cut_Surface_Philosophy_v0_1/alternative_openers.txt
rename to resources/ky-cut-surface-philosophy-v0_1/alternative_openers.txt
diff --git a/KY_Cut_Surface_Philosophy_v0_1/compressed_version.txt b/resources/ky-cut-surface-philosophy-v0_1/compressed_version.txt
similarity index 100%
rename from KY_Cut_Surface_Philosophy_v0_1/compressed_version.txt
rename to resources/ky-cut-surface-philosophy-v0_1/compressed_version.txt
diff --git a/resources/sources.md b/resources/sources.md
index 2f3f2ff..4f31d41 100644
--- a/resources/sources.md
+++ b/resources/sources.md
@@ -39,6 +39,11 @@ These provide important context and guardrails for loop design.
- Peter Steinberger: emphasis on designing loops rather than prompting agents directly.
- Various practitioners experimenting with closed-loop systems, feedback loop engineering, and "routines that prompt the model."
+## Community Philosophy Artifacts
+
+- **Marius ([@sololys](https://github.com/sololys))** — [KY Cut Surface Philosophy v0.1](./ky-cut-surface-philosophy-v0_1/) (July 2026)
+ Archived public philosophy on the distinction between generation and consequence. Not a pattern or runtime — indexed via [stories/ky-cut-surface-generation-vs-consequence.md](../stories/ky-cut-surface-generation-vs-consequence.md).
+
## How This Repo Relates
We treat the above sources as the current best articulation of the idea and aim to turn the abstract framework into practical, copyable patterns, templates, and tool-specific guidance (with special attention to the Grok Build TUI, which has strong native support for the primitives).
diff --git a/stories/README.md b/stories/README.md
index fa4e418..009fda2 100644
--- a/stories/README.md
+++ b/stories/README.md
@@ -14,6 +14,7 @@ Real-world loop engineering — including failures. Contribute yours via [CONTRI
| [post-merge-cleanup-honest-win.md](./post-merge-cleanup-honest-win.md) | Post-Merge Cleanup | Off-peak cadence; verifier caught doc/API drift; bot-merge noise |
| [quant-loop-the-verifier-problem.md](./quant-loop-the-verifier-problem.md) | Quant research (domain) | Numerical checker beats LLM-as-verifier for backtests |
| [quant-loop-out-of-time.md](./quant-loop-out-of-time.md) | Quant research (domain) | Strategy passed research, failed out-of-time data |
+| [ky-cut-surface-generation-vs-consequence.md](./ky-cut-surface-generation-vs-consequence.md) | Philosophy → loop bridge | Generation ≠ consequence; preserve the cut surface |
**Template for new stories:**
diff --git a/stories/ky-cut-surface-generation-vs-consequence.md b/stories/ky-cut-surface-generation-vs-consequence.md
new file mode 100644
index 0000000..853eebe
--- /dev/null
+++ b/stories/ky-cut-surface-generation-vs-consequence.md
@@ -0,0 +1,38 @@
+# KY Cut Surface — Generation vs Consequence
+
+*Contributed by [@sololys](https://github.com/sololys) — adapted from [PR #178](https://github.com/cobusgreyling/loop-engineering/pull/178). Norwegian source artifacts: [resources/ky-cut-surface-philosophy-v0_1/](../resources/ky-cut-surface-philosophy-v0_1/).*
+
+This is a **philosophy artifact**, not a loop pattern. It is indexed here because its core thesis maps directly to loop engineering discipline.
+
+## Setup
+
+- Domain: public philosophy on systems where stakes are high
+- Thesis: *candidate generation is not consequence realization*
+- Posture: fail-closed publication — stronger claims marked HOLD or KILL in the source README
+- No executable runtime, no physics validation claim, no autonomous-system claim
+
+## What maps to loop engineering
+
+| Philosophy term | Loop primitive |
+|-----------------|----------------|
+| Generation | Maker output (signals, patches, strategies, text) |
+| Consequence / realization | Checker-approved state change, verifiable stop condition |
+| Cut surface | Boundary where admissible output becomes accountable action |
+| Non-lying kernel | Verifier that cannot be satisfied by the maker's self-report alone |
+| Archive discipline | `STATE.md`, run logs, manifests — source/machine/human kept distinct |
+
+The same mistake shows up in production loops: treating *possible* output as *proven* output. A maker that generates a backtest, a patch, or a risk assessment has not yet realized a consequence — a checker (numerical, CI, human gate) must.
+
+See also [quant-loop-the-verifier-problem.md](./quant-loop-the-verifier-problem.md) for a domain-specific version of this failure mode.
+
+## What this artifact does not claim
+
+- No technical proof
+- No physics validation
+- No autonomous hedge-fund or agent-sovereignty claim
+
+Those interpretations are explicitly KILL or HOLD in the archived source.
+
+## Lesson
+
+Design loops so generation and consequence stay separable. If your verifier is the same agent that generated the candidate, or if your stop condition is self-reported, you have collapsed the cut surface — and the loop will eventually treat noise as warrant.
\ No newline at end of file