Initial commit.

README.md

@@ -0,0 +1,48 @@
+# Cthulhu Tentacles
+
+A repository of experimental Tentacles for Cthulhu-Go, maintained by Storm
+Dragon. It currently contains one Tentacle: [Hello World](hello-world/README.md).
+Repository material and Hello World are licensed under GPL-3.0-or-later; see
+[LICENSE](LICENSE) and [CONTRIBUTING.md](CONTRIBUTING.md).
+
+`repository.toml` identifies this source. `catalog.toml` explicitly lists its
+Tentacles, each in a direct top-level folder with its own `tentacle.toml`.
+The catalog currently contains discovery metadata, with no release artifacts.
+The proposed source URL is
+`https://git.stormux.org/storm/cthulhu-tentacles`; it becomes usable after the
+maintainer creates and publishes the Git repository.
+
+## Build and check
+
+Keep the matching experimental `cthulhu-go` checkout beside this directory.
+The `go.mod` local replacement uses its Go SDK, including the new
+uninterruptible presentation option. Building requires Go 1.24 or newer;
+checks also require Python 3.11 or newer and Make.
+
+```sh
+make build
+make check
+```
+
+The executable is `hello-world/bin/hello-world`, which is ignored by Git.
+Checks validate the TOML metadata, registration and suggested bindings, and
+invoke Hello World through the actual Cthulhu-Go host. They produce no speech
+or Braille and leave the running reader alone.
+
+## Discovery and the upcoming installation workflow
+
+After publishing this repository, open global Cthulhu Preferences → Tentacles
+→ Add repository and enter its HTTPS Git URL. Its tab should list Hello World,
+version 0.1.0, with the description from its manifest.
+
+The current reader validates and displays repository catalogs. It does not
+yet install or build a Tentacle from a catalog. Manifest launch/runtime/API
+fields document this package for the next installation slice; the current
+discovery parser does not interpret them. There is no invented download URL,
+release digest, or automatic installation step here.
+
+For local execution before installation is implemented, see the explicit
+[Hello World launch procedure](hello-world/README.md). Future publishing should
+add immutable artifacts and verified digests only once the reader has a defined
+installation contract.
+