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.
TypeScript agentic-aiai-agentsai-codinganthropicautomationclaudeclaude-codecodexcoding-agentsdevops-automationdevtoolsgithub-actionsgrokllmloop-engineeringmcpprompt-engineering
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.mddeleted file mode 100644index 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: KILLdiff --git a/KY_Cut_Surface_Philosophy_v0_1/linkedin_post_july06.txt b/KY_Cut_Surface_Philosophy_v0_1/linkedin_post_july06.txtdeleted file mode 100644index 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.sha256similarity index 58%rename from KY_Cut_Surface_Philosophy_v0_1/MANIFEST.sha256rename to resources/ky-cut-surface-philosophy-v0_1/MANIFEST.sha256index 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.md21914927279637f60297caa20944cbc559e82400ac9c37d03b687e5f26f55aaa TERMINAL_ART.txt06c5f8c4ca55691f775ec9f4475383cd0cfb6c6fe07230f6291aec8b348c6258 alternative_openers.txt-55a9bb4ec71c728f342da28f48b35c77e39069c6ce31aa79b5a017cc202b28ab compressed_version.txt-6e53547f058a5c0acc7e3d19f3ed82f68013fc4c15a1f7dfdc52ebe8ecb1c7eb linkedin_post_july06.txt+55a9bb4ec71c728f342da28f48b35c77e39069c6ce31aa79b5a017cc202b28ab compressed_version.txt\ No newline at end of filediff --git a/KY_Cut_Surface_Philosophy_v0_1/MANIFEST_VERIFY.txt b/resources/ky-cut-surface-philosophy-v0_1/MANIFEST_VERIFY.txtsimilarity index 52%rename from KY_Cut_Surface_Philosophy_v0_1/MANIFEST_VERIFY.txtrename to resources/ky-cut-surface-philosophy-v0_1/MANIFEST_VERIFY.txtindex 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: OKTERMINAL_ART.txt: OKalternative_openers.txt: OK-compressed_version.txt: OK-linkedin_post_july06.txt: OK+compressed_version.txt: OK\ No newline at end of filediff --git a/resources/ky-cut-surface-philosophy-v0_1/README.md b/resources/ky-cut-surface-philosophy-v0_1/README.mdnew file mode 100644index 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 filediff --git a/KY_Cut_Surface_Philosophy_v0_1/TERMINAL_ART.txt b/resources/ky-cut-surface-philosophy-v0_1/TERMINAL_ART.txtsimilarity index 100%rename from KY_Cut_Surface_Philosophy_v0_1/TERMINAL_ART.txtrename to resources/ky-cut-surface-philosophy-v0_1/TERMINAL_ART.txtdiff --git a/KY_Cut_Surface_Philosophy_v0_1/alternative_openers.txt b/resources/ky-cut-surface-philosophy-v0_1/alternative_openers.txtsimilarity index 100%rename from KY_Cut_Surface_Philosophy_v0_1/alternative_openers.txtrename to resources/ky-cut-surface-philosophy-v0_1/alternative_openers.txtdiff --git a/KY_Cut_Surface_Philosophy_v0_1/compressed_version.txt b/resources/ky-cut-surface-philosophy-v0_1/compressed_version.txtsimilarity index 100%rename from KY_Cut_Surface_Philosophy_v0_1/compressed_version.txtrename to resources/ky-cut-surface-philosophy-v0_1/compressed_version.txtdiff --git a/resources/sources.md b/resources/sources.mdindex 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 RelatesWe 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.mdindex 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.mdnew file mode 100644index 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