From 29072d36d4a04afc88d48fc0649b02c5407b4d0a Mon Sep 17 00:00:00 2001
From: hopeatina <hopeatina@gmail.com>
Date: Sat, 9 May 2026 10:38:20 -0500
Subject: [PATCH] chore: add Codex environment setup

---
 .codex/README.md                 | 27 +++++++++++++++++++++++++++
 .codex/cleanup-local-worktree.sh | 10 ++++++++++
 .codex/maintenance-cloud.sh      |  6 ++++++
 .codex/setup-cloud.sh            |  7 +++++++
 .codex/setup-local-worktree.sh   | 10 ++++++++++
 AGENTS.md                        | 29 +++++++++++++++++++++++++++++
 6 files changed, 89 insertions(+)
 create mode 100644 .codex/README.md
 create mode 100755 .codex/cleanup-local-worktree.sh
 create mode 100755 .codex/maintenance-cloud.sh
 create mode 100755 .codex/setup-cloud.sh
 create mode 100755 .codex/setup-local-worktree.sh
 create mode 100644 AGENTS.md

diff --git a/.codex/README.md b/.codex/README.md
new file mode 100644
index 0000000..d0bde34
--- /dev/null
+++ b/.codex/README.md
@@ -0,0 +1,27 @@
+# Codex Cloud Environment
+
+Use these repo-local scripts when configuring the Codex cloud environment for `useorgx/skills`.
+
+## Setup script
+
+```bash
+bash .codex/setup-cloud.sh
+```
+
+## Maintenance script
+
+```bash
+bash .codex/maintenance-cloud.sh
+```
+
+## Environment notes
+
+- Python 3 is enough for the repo-level drift checker.
+- No OrgX API secrets are required for static skill drift checks.
+- Keep internet access limited to the setup phase unless a task explicitly needs external services.
+
+## Verification commands
+
+```bash
+python3 scripts/check_skill_tool_drift.py
+```
diff --git a/.codex/cleanup-local-worktree.sh b/.codex/cleanup-local-worktree.sh
new file mode 100755
index 0000000..1404250
--- /dev/null
+++ b/.codex/cleanup-local-worktree.sh
@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+cd "${CODEX_WORKTREE_PATH:-$(dirname "${BASH_SOURCE[0]}")/..}"
+
+if [ -f docker-compose.yml ] || [ -f docker-compose.yaml ] || [ -f compose.yml ] || [ -f compose.yaml ]; then
+  docker compose down --remove-orphans 2>/dev/null || true
+fi
+
+rm -rf .cache/tmp .next/cache .turbo .vitest .wrangler/tmp node_modules/.cache tmp
diff --git a/.codex/maintenance-cloud.sh b/.codex/maintenance-cloud.sh
new file mode 100755
index 0000000..63cc5f2
--- /dev/null
+++ b/.codex/maintenance-cloud.sh
@@ -0,0 +1,6 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+cd "$(dirname "${BASH_SOURCE[0]}")/.."
+
+python3 --version
diff --git a/.codex/setup-cloud.sh b/.codex/setup-cloud.sh
new file mode 100755
index 0000000..aeed37e
--- /dev/null
+++ b/.codex/setup-cloud.sh
@@ -0,0 +1,7 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+cd "$(dirname "${BASH_SOURCE[0]}")/.."
+
+python3 --version
+python3 scripts/check_skill_tool_drift.py
diff --git a/.codex/setup-local-worktree.sh b/.codex/setup-local-worktree.sh
new file mode 100755
index 0000000..ada8e39
--- /dev/null
+++ b/.codex/setup-local-worktree.sh
@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+cd "${CODEX_WORKTREE_PATH:-$(dirname "${BASH_SOURCE[0]}")/..}"
+
+if [ -x .codex/maintenance-cloud.sh ]; then
+  bash .codex/maintenance-cloud.sh
+else
+  echo "No .codex/maintenance-cloud.sh found; skipping local worktree setup."
+fi
diff --git a/AGENTS.md b/AGENTS.md
new file mode 100644
index 0000000..b6a39f9
--- /dev/null
+++ b/AGENTS.md
@@ -0,0 +1,29 @@
+# AGENTS.md
+
+Guidelines for Codex and other agents working in `useorgx/skills`.
+
+## Project
+
+This repo contains OrgX skill definitions and protocol guidance for MCP-capable agents.
+
+## Setup
+
+For Codex cloud, use:
+
+```bash
+bash .codex/setup-cloud.sh
+```
+
+Maintenance script for cached environments:
+
+```bash
+bash .codex/maintenance-cloud.sh
+```
+
+## Verification
+
+```bash
+python3 scripts/check_skill_tool_drift.py
+```
+
+Run the drift checker before claiming skill changes are ready. It is the minimum proof that skill files still reference valid OrgX MCP tool names and required workflow gates.