create complete runner by AGENTS.md and ChatGPT-Codex

README.md

@@ -0,0 +1,55 @@
+# test-samurai-go-runner.nvim
+
+Go runner for `test-samurai.nvim`.
+
+Main plugin: https://gitea.mschirmer.com/m13r/test-samurai.nvim
+
+## Features
+
+- Detects Go test files (`*_test.go`).
+- Finds nearest `Test*`, `Example*`, and `Benchmark*` functions.
+- Builds `go test` commands for nearest, file, all, and failed-only runs.
+- Parses `go test` output to list passes, failures, and skips.
+
+## Installation (lazy.nvim)
+
+```lua
+{
+  "m13r/test-samurai.nvim",
+  dependencies = {
+    "m13r/test-samurai-go-runner.nvim",
+  },
+  config = function()
+    require("test-samurai").setup({
+      runners = {
+        require("test-samurai-go-runner"),
+      },
+    })
+  end,
+}
+```
+
+## Local Development (lazy.nvim)
+
+```lua
+{
+  "m13r/test-samurai.nvim",
+  dependencies = {
+    {
+      "test-samurai-go-runner.nvim",
+      dir = "/absolute/path/to/test-samurai-go-runner.nvim",
+    },
+  },
+  config = function()
+    require("test-samurai").setup({
+      runners = {
+        require("test-samurai-go-runner"),
+      },
+    })
+  end,
+}
+```
+
+## Usage
+
+Use the standard `test-samurai.nvim` commands (e.g. `TSamNearest`, `TSamFile`, `TSamAll`, `TSamFailedOnly`).