From d1571b61a95887ca49f3f7200141ead8259fc9d4 Mon Sep 17 00:00:00 2001 From: Willem van den Ende Date: Sat, 20 Jun 2026 16:02:41 +0100 Subject: [PATCH] explain READMe better --- LICENSE | 21 + README.md | 17 + transcripts/socrates-uk-session.html | 4328 ++++++++++++++++++++++++++ 3 files changed, 4366 insertions(+) create mode 100644 LICENSE create mode 100644 README.md create mode 100644 transcripts/socrates-uk-session.html diff --git a/LICENSE b/LICENSE new file mode 100644 index 0000000..939be3c --- /dev/null +++ b/LICENSE @@ -0,0 +1,21 @@ +MIT License + +Copyright (c) 2026 Living Software LTD + +Permission is hereby granted, free of charge, to any person obtaining a copy +of this software and associated documentation files (the "Software"), to deal +in the Software without restriction, including without limitation the rights +to use, copy, modify, merge, publish, distribute, sublicense, and/or sell +copies of the Software, and to permit persons to whom the Software is +furnished to do so, subject to the following conditions: + +The above copyright notice and this permission notice shall be included in all +copies or substantial portions of the Software. + +THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE +AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, +OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +SOFTWARE. diff --git a/README.md b/README.md new file mode 100644 index 0000000..9e597d8 --- /dev/null +++ b/README.md @@ -0,0 +1,17 @@ +# Socrates UK 2026 Workshop outcome - deterministic red/green widget for Pi + +Experimental [Pi.dev](https://pi.dev) coding agent extension in [.pi](.pi). It shows a persistent 'green' widget after tests pass, and a 'red' widget after they fail, so it is clear what state you are working in. + +Aim was to make a small step in a developer-in-the-loop state machine that helps developers make small steps, whether an LLM generates the code or a person. + +Hour long workshop in which we made a small extension to show the red or green status right above the developers' prompt. No tests, and specific to a typescript project, but works as a proof of concept. + +Possible next steps: + +- Extract to separate extension. +- Put the compile and run test commands in a shell script, or environment variables (Pi can help you create a 'setting' that you can change in the menu, or pass in as environment variable before starting pi). +- Remember to run pi in a sandbox, there is no pretense of guardrails. + +Thanks to all participants, it was nice to create a widget in small steps and iterate on my reasoning for how I use this stuff. + +Willem van den Ende diff --git a/transcripts/socrates-uk-session.html b/transcripts/socrates-uk-session.html new file mode 100644 index 0000000..4c4b300 --- /dev/null +++ b/transcripts/socrates-uk-session.html @@ -0,0 +1,4328 @@ + + + + + + Session Export + + + + + +
+ + +
+
+
+
+
+ +
+
+ + + + + + + + + + + + +