docs(pi): implement milestone M6 - validation and surfacing

scripts/verify-pi-resources.sh

@@ -19,6 +19,8 @@ REQUIRED_FILES=(
   "package.json"
 )
 
+# These required-file checks are intentionally hard failures: removing any
+# required artifact should make this script exit non-zero immediately.
 for file in "${REQUIRED_FILES[@]}"; do
   test -f "$file"
 done