chore: address PR #25 review feedback

- Move plan to docs/plans/completed/
- Move design spec to docs/designs/
- Mark init.sh feature as passes:true in features.json
- Document inotify-tools as optional dev prerequisite in README
- Handle errserver startup failure: log, stop_dev, exit watcher

Signed-off-by: Matej Vašek <matejvasek@gmail.com>
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: matejvasek

README.md

@@ -48,6 +48,7 @@ Available image tags are listed in the [container registry](https://github.com/t
 - [Docker](https://www.docker.com) or [podman 3.2.0+](https://podman.io)
 - An [OpenShift cluster](https://console.redhat.com/openshift/create)
 - Github [*Personal Access Token*](https://github.com/settings/personal-access-tokens) with *administration*, *content* and *workflow* write permissions in all repositories
+- [inotify-tools](https://github.com/inotify-tools/inotify-tools) (optional, enables Go backend auto-recompile on file changes)
 
 ### Option 1: Local
 

…pecs/2026-05-14-better-init-sh-design.md …igns/2026-05-14-better-init-sh-design.mddocs/superpowers/specs/2026-05-14-better-init-sh-design.md renamed to docs/designs/2026-05-14-better-init-sh-design.md docs/superpowers/specs/2026-05-14-better-init-sh-design.md renamed to docs/designs/2026-05-14-better-init-sh-design.md

@@ -154,7 +154,7 @@
       "The randomized ports shall be available to the Claude via a file.",
       "The go backend service should be automatically recompiled/restarted upon change to the ./backend directory."
     ],
-    "passes": false
+    "passes": true
   },
   {
     "category": "functional",

docs/features.json

@@ -116,7 +116,14 @@ start_backend_watcher() {
         rm -f bin/backend-tmp
         echo "$build_output" > "$LOG_DIR/backend-build-error.txt"
         ./bin/errserver --port "$BACKEND_PORT" --msg-file "$LOG_DIR/backend-build-error.txt" >>"$LOG_DIR/backend.log" 2>&1 &
-        echo $! > "$PID_DIR/backend.pid"
+        errserver_pid=$!
+        sleep 0.5
+        if ! kill -0 "$errserver_pid" 2>/dev/null; then
+          echo "[watcher] Error server failed to start. Shutting down."
+          stop_dev
+          break
+        fi
+        echo "$errserver_pid" > "$PID_DIR/backend.pid"
       fi
 
     done