remove references to my local paths on hack run scripts;

update README to reflect the new changes (gcs) and link the new MD files

Author: hoxhaeris

README.md

@@ -6,17 +6,83 @@ You'll be placed in a new channel with the App, and you'll be ready to begin lau
 
 To see the available commands, type `help`.
 
-## Authorization System
+## Features
 
-The cluster-bot includes an organizational data-based authorization system that controls access to commands based on team membership, organization affiliation, or individual user permissions. 
+### 🔐 **Advanced Authorization System**
+- **Organizational data-based access control** using pre-computed indexes for fast lookups
+- **Multiple authorization levels**: User UID, team membership, organization-based permissions  
+- **Hot reload**: Automatic updates when organizational data or authorization config changes
+- **Complete hierarchy support**: Teams → Organizations → Pillars → Team Groups
 
-- Use `@cluster-bot whoami` to see your permissions and available commands
-- Administrators can configure access rules in `authorization.yaml`
-- See [AUTHORIZATION.md](AUTHORIZATION.md) for detailed setup and configuration instructions
+### ☁️ **Flexible Data Sources**
+- **Local files**: Development and testing with JSON files
+- **Google Cloud Storage**: Production deployments with secure, cross-cluster access
+- **Hot reload**: Both file watching and GCS polling for live updates
+- **Pluggable architecture**: Easy to extend with new data sources
+
+### 🚀 **Production Ready**  
+- **Fast performance**: O(1) organizational lookups with pre-computed indexes
+- **Thread-safe**: Concurrent access with read-write mutex protection
+- **Build flexibility**: Optional GCS support with build tags (`-tags gcs`)
+- **Secure authentication**: Application Default Credentials for GCS
+
+## Quick Start
+
+### Option 1: Local Development
+```bash
+# Set your organizational data file
+export ORGDATA_PATHS="/path/to/comprehensive_index_dump.json"
+
+# Start the bot
+./hack/run.sh
+```
+
+### Option 2: Google Cloud Storage
+```bash
+# Build with GCS support
+make BUILD_FLAGS="-tags gcs" build
+
+# Quick start with GCS
+./hack/run-with-gcs.sh
+
+# Or configure manually
+export USE_GCS_ORGDATA=true
+export GCS_BUCKET="your-bucket"
+export GCS_OBJECT_PATH="orgdata/comprehensive_index_dump.json"
+./hack/run.sh
+```
+
+### Check Your Permissions
+```
+@cluster-bot whoami
+```
+
+## Documentation
+
+- 📖 **[AUTHORIZATION.md](AUTHORIZATION.md)** - Complete authorization system setup and configuration
+- 🛠️ **[hack/DEVELOPMENT.md](hack/DEVELOPMENT.md)** - Detailed development setup guide
+- ❓ **[docs/FAQ.md](docs/FAQ.md)** - Frequently asked questions
+
+## Build Options
+
+```bash
+# Standard build (file-based data sources only)
+make build
+
+# Build with GCS support
+make BUILD_FLAGS="-tags gcs" build
+
+# See all available targets
+make help-ci-chat-bot
+```
+
+## Getting Help
 
 For any questions, concerns, comments, etc, please reach out in the `#forum-ocp-crt` channel.
 
 ## Links
 * [OpenShift Releases](https://amd64.ocp.releases.ci.openshift.org/)
+* [Authorization System Documentation](AUTHORIZATION.md) - Complete setup guide
+* [Development Guide](hack/DEVELOPMENT.md) - Local development setup  
 * [Frequently Asked Questions](docs/FAQ.md)
-* [Authorization System Documentation](AUTHORIZATION.md)
+* [Makefile Help](Makefile) - Run `make help-ci-chat-bot` for build options

hack/DEVELOPMENT.md

@@ -27,7 +27,8 @@ export GCS_CREDENTIALS_JSON='{"type":"service_account",...}'  # Optional: explic
 **Option 2: Use Local Files (Development)**
 ```bash
 export ORGDATA_PATHS="/path/to/your/comprehensive_index_dump.json"
-# Default: ../cyborg/org_tools/comprehensive_index_dump.json (relative to ci-chat-bot)
+# Default: test-data/comprehensive_index_dump.json (relative to ci-chat-bot)
+# You can generate this file using the Python orglib indexing system
 ```
 
 #### Authorization Configuration
@@ -71,9 +72,9 @@ workspace/
 │   │   ├── run.sh        # Main development script
 │   │   └── run-with-gcs.sh  # GCS convenience script
 │   └── test-authorization.yaml  # Default auth config
-├── cyborg/               # Optional: orgdata repository
-│   └── org_tools/
-│       └── comprehensive_index_dump.json
+├── test-data/           # Test data and examples
+│   ├── comprehensive_index_dump.json  # Sample orgdata file
+│   └── orgdata.json                   # Legacy test data
 └── release/              # OpenShift release repository (required)
     ├── ci-operator/
     └── core-services/
@@ -140,9 +141,14 @@ export AUTH_CONFIG="/path/to/my-auth-config.yaml"
 ### File Not Found Errors
 If you see errors about missing files:
 1. Check that `ORGDATA_PATHS` points to a valid file
-2. Ensure the `../cyborg` directory exists if using defaults
+2. Generate or obtain a `comprehensive_index_dump.json` file from your orgdata system
 3. Verify the `../release` directory exists (OpenShift release repo)
 
+To generate organizational data:
+- Use the Python `orglib` indexing system to create `comprehensive_index_dump.json`
+- Or obtain the file from your organization's data pipeline
+- See the cyborg/org_tools project for data generation examples
+
 ### GCS Authentication Errors
 If GCS fails to authenticate:
 1. **Check authentication**: `gcloud auth list`

hack/run.sh

@@ -53,9 +53,16 @@ if [[ "${USE_GCS_ORGDATA:-false}" == "true" ]]; then
   fi
 else
   echo "Using local file-based orgdata..."
-  # Default to local file-based orgdata (relative to project root)
-  default_orgdata="${work_dir}/../cyborg/org_tools/comprehensive_index_dump.json"
+  # Default orgdata path (can be overridden with ORGDATA_PATHS env var)
+  # Users should set ORGDATA_PATHS to point to their comprehensive_index_dump.json file
+  default_orgdata="${work_dir}/test-data/comprehensive_index_dump.json"
   ORGDATA_PATHS="${ORGDATA_PATHS:-${default_orgdata}}"
+  
+  if [[ ! -f "$ORGDATA_PATHS" ]]; then
+    echo "⚠️  Warning: Orgdata file not found at: $ORGDATA_PATHS"
+    echo "   Set ORGDATA_PATHS environment variable to your comprehensive_index_dump.json file"
+    echo "   Example: export ORGDATA_PATHS=\"/path/to/comprehensive_index_dump.json\""
+  fi
   orgdata_flags="--orgdata-paths=${ORGDATA_PATHS}"
   echo "Orgdata file: ${ORGDATA_PATHS}"
 fi