@jeger-ai/opengantry 1.0.0

package/templates/.github/workflows/gxt-validate.yml

@@ -0,0 +1,129 @@
+# Validates OpenGantry substrate: Foreman MANIFEST + path-scoped [MSN-NNNN] on PRs.
+#
+# MSN policy (pull_request only): commits touching MSN-enforced paths must have
+# subject [MSN-NNNN] (four digits) or a valid gxt-bypass git note.
+# Paths = fixed substrate (.gitagent/, WORKER_LOG.md, .githooks/, gxt-validate.yml)
+#       + all MANIFEST skills[].tmvc_roots (Node via scripts/gxt-manifest-lib.mjs).
+# Logic: scripts/validate-gxt.sh — keep workflow header and script in sync.
+
+name: GXT validate
+
+on:
+  push:
+    branches: ["**"]
+  pull_request:
+
+permissions:
+  contents: read
+
+jobs:
+  manifest:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: "24"
+          cache: "npm"
+
+      - name: Install Node deps
+        run: npm ci
+
+      - name: Build gapman
+        run: npm run build
+
+      - name: gapman check (MANIFEST + Rule 4.4 skills sync)
+        run: node dist/cli/index.js check
+
+      - name: Validate Foreman MANIFEST.json (Node parity)
+        run: ./scripts/validate-gxt.sh manifest
+
+      - name: gapman unit tests
+        run: node --test dist/cli/tests/*.test.js
+
+      - name: gapman doctor (readiness)
+        run: node dist/cli/index.js doctor
+
+  code_quality:
+    if: github.event_name == 'pull_request'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+          ref: ${{ github.event.pull_request.head.sha }}
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: "24"
+          cache: "npm"
+
+      - name: Install Node deps
+        run: npm ci
+
+      - name: Changed-code quality gates (complexity + import layers)
+        env:
+          BASE_SHA: ${{ github.event.pull_request.base.sha }}
+          HEAD_SHA: ${{ github.event.pull_request.head.sha }}
+        run: ./scripts/check-changed-code.sh "$BASE_SHA" "$HEAD_SHA"
+
+  npm_pack:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: "24"
+          cache: npm
+
+      - name: Install Node deps
+        run: npm ci
+
+      - name: npm pack check
+        run: ./scripts/npm-pack-check.sh
+
+  msn_commits:
+    if: github.event_name == 'pull_request'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+          ref: ${{ github.event.pull_request.head.sha }}
+
+      - name: Fetch gxt-bypass git notes
+        run: git fetch origin 'refs/notes/*:refs/notes/*' || true
+
+      - name: Path-scoped MSN commit subjects
+        env:
+          BASE_SHA: ${{ github.event.pull_request.base.sha }}
+          HEAD_SHA: ${{ github.event.pull_request.head.sha }}
+        run: ./scripts/validate-gxt.sh msn "$BASE_SHA" "$HEAD_SHA"
+
+  mission_verify:
+    if: github.event_name == 'pull_request'
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v6
+        with:
+          fetch-depth: 0
+          ref: ${{ github.event.pull_request.head.sha }}
+
+      - uses: actions/setup-node@v6
+        with:
+          node-version: "24"
+          cache: npm
+
+      - name: Install Node deps
+        run: npm ci
+
+      - name: Build gapman
+        run: npm run build
+
+      - name: Full verify on PR-changed missions
+        env:
+          BASE_SHA: ${{ github.event.pull_request.base.sha }}
+          HEAD_SHA: ${{ github.event.pull_request.head.sha }}
+        run: ./scripts/verify-pr-missions.sh

package/templates/.gitignore.gxt

@@ -0,0 +1,8 @@
+# OpenGantry local forensic paths (merged by gapman init)
+.gitagent/.upgrade-tmp/
+.gitagent/foreman/TEACHER.allowlist.local
+.gitagent/history/
+.gitagent/history/credentials/
+.gitagent/history/.ignored-last-error.json
+.gitagent/history/.draft-token-replay.json
+.gitagent/foreman/DRAFT_TOKEN.key

package/templates/AGENTS.md

@@ -0,0 +1,24 @@
+# Agent instructions (OpenGantry)
+
+Before planning, editing code, or running substantive commands in this repository:
+
+1. Read **`.gitagent/teacher/RULES.md`** — governance (SOD, trace mapping, risk tiers, dynamic TMVC, Rule 4.4).
+2. Read **`.gitagent/foreman/MANIFEST.json`** — Foreman map (`schema_version`, per-skill `trust_threshold`, `tmvc_roots`, `forbidden_zones`, `path_risks`, `risk_keywords`).
+
+Treat these as the **law + routing contract** for agent work. Before editing application code, read **`.gitagent/ARCHITECTURE.pointer.json`**. If **`kind` is `unset`**, or docs are stub/missing, read **`.gitagent/teacher/ARCHITECTURE-DISCOVERY.md`** and ask the user — do not invent architecture. When `access.required` is true, read **`.gitagent/teacher/ARCHITECTURE-ACCESS.md`**. For GXT workflow orientation, see **`.gitagent/README.md`**.
+
+## Mission Architect (IDE chat)
+
+**Activation macro:**
+
+- If a user prompt starts with `/gantry`, treat that as an explicit Mission Architect activation request. Do not use `/plan` — Cursor reserves it for native Plan Mode.
+- On activation, follow **`.gitagent/teacher/MISSION-ARCHITECT.md`** and complete the legislate handoff flow.
+
+**Implicit interception:**
+
+When the user **explicitly** asks to write, edit, refactor, or implement code and **no mission is pinned**, read **`.gitagent/teacher/MISSION-ARCHITECT.md`** and follow it.
+
+- **Do NOT** trigger for questions, explanations, or code discovery — answer normally.
+- **Fast-path** trivial single-file work; **full interview** for heavy/risky scope.
+- **Cursor MCP handoff (preferred):** `gxt_draft_legislation` → human chat approval → `gxt_execute_legislation` → Teacher commit → `gxt_check_signature` → `gxt_pin_mission`.
+- **CLI fallback:** one copy-paste `gapman legislate …` command — never raw YAML blocks.

package/templates/docs/ARCHITECTURE.md

@@ -0,0 +1,23 @@
+# Code architecture
+
+Document repository layout, module boundaries, and dependency direction for agents working in this codebase.
+
+This file is the **default** architecture source when [`.gitagent/ARCHITECTURE.pointer.json`](../.gitagent/ARCHITECTURE.pointer.json) has `"kind": "file"`. You may instead point the pointer at:
+
+- **`directory`** — e.g. `docs/architecture/` (read `README.md` or index first, then layer notes)
+- **`external`** — e.g. a wiki URL or MCP-backed doc system (follow `read_hint` in the pointer)
+
+Agents discover how to read architecture via the pointer on first substantive work — do not hardcode alternate paths in IDE rules.
+
+**If the pointer has `kind: unset`**, or pointed docs are still the init stub, read **`.gitagent/teacher/ARCHITECTURE-DISCOVERY.md`** and ask the user structured questions before implementing — never invent the full architecture yourself.
+
+## GXT governance (always read first)
+
+1. **`.gitagent/teacher/RULES.md`** — law (SOD, trace, TMVC, Rule 4.4).
+2. **`.gitagent/foreman/MANIFEST.json`** — skill routing, `tmvc_roots`, forbidden zones.
+
+Workflow orientation: **`.gitagent/README.md`**.
+
+## Your architecture notes
+
+Replace this section with your project structure — layers, import rules, and where new code belongs. Keep TMVC roots in MANIFEST aligned with paths described here.

package/templates/integrations/aider/.aider.conf.yml

@@ -0,0 +1,4 @@
+read:
+  - AGENTS.md
+  - .gitagent/teacher/RULES.md
+  - .gitagent/foreman/MANIFEST.json

package/templates/integrations/antigravity/.agent/rules/gxt.md

@@ -0,0 +1,11 @@
+---
+always_on: true
+---
+
+# GXT substrate (Google Antigravity)
+
+Read **`AGENTS.md`**, **`.gitagent/teacher/RULES.md`**, and **`.gitagent/foreman/MANIFEST.json`** before acting.
+
+Bootstrap: `source scripts/gxt-runtime-env.sh .gitagent/missions/<file>.yaml`
+
+See `.gitagent/ARCHITECTURE.pointer.json` for code layout (follow `read_hint`). GXT workflow: `.gitagent/README.md`.

package/templates/integrations/claude-code/CLAUDE.md

@@ -0,0 +1,9 @@
+# Claude Code — GXT context (keep under ~200 lines)
+
+Before planning, editing code, or running substantive commands:
+
+1. Read **`AGENTS.md`** — cross-tool entry.
+2. Read **`.gitagent/teacher/RULES.md`** — governance law.
+3. Read **`.gitagent/foreman/MANIFEST.json`** — routing map (TMVC roots, forbidden zones).
+
+Do not duplicate full RULES here. For code architecture read `.gitagent/ARCHITECTURE.pointer.json` first (follow `read_hint`). For GXT workflow see `.gitagent/README.md`.

package/templates/integrations/cline/.clinerules/gxt.md

@@ -0,0 +1,7 @@
+# GXT policy for Cline
+
+Before substantive work, read `AGENTS.md`, `.gitagent/teacher/RULES.md`, and `.gitagent/foreman/MANIFEST.json`.
+
+Terminal bootstrap: `source scripts/gxt-runtime-env.sh .gitagent/missions/<file>.yaml`
+
+Code layout: read `.gitagent/ARCHITECTURE.pointer.json` first (file, folder, or external per `kind`). GXT workflow: `.gitagent/README.md`.

package/templates/integrations/codex-cli/.codex/config.toml

@@ -0,0 +1,3 @@
+# OpenAI Codex CLI project defaults (optional — trusted projects only)
+# See https://developers.openai.com/codex/config-basic
+# GXT law lives in AGENTS.md + .gitagent/ — do not duplicate here.

package/templates/integrations/compatibility.json

@@ -0,0 +1,92 @@
+{
+  "schema_version": "1",
+  "opengantry_version": "1.0.0",
+  "integrations": {
+    "cursor": {
+      "display_name": "Cursor",
+      "verified_date": "2026-05-19",
+      "docs_url": "https://cursor.com/docs/agent/hooks",
+      "recipe_file": "cursor.md",
+      "canonical_paths": [
+        ".cursor/rules/opengantry-gxt-substrate.mdc",
+        ".cursor/hooks.json"
+      ],
+      "deprecated_paths": [".cursorrules"],
+      "hooks_schema_version": 1,
+      "cli_probe": ["cursor", "--version"]
+    },
+    "claude-code": {
+      "display_name": "Claude Code",
+      "verified_date": "2026-05-19",
+      "docs_url": "https://docs.anthropic.com/en/docs/claude-code",
+      "recipe_file": "claude-code.md",
+      "canonical_paths": ["CLAUDE.md"],
+      "deprecated_paths": [],
+      "cli_probe": ["claude", "--version"]
+    },
+    "codex-cli": {
+      "display_name": "OpenAI Codex CLI",
+      "verified_date": "2026-05-19",
+      "docs_url": "https://developers.openai.com/codex/config-basic",
+      "disambiguation": "OpenAI Codex API (2021-2023) is NOT this product",
+      "recipe_file": "codex-cli.md",
+      "canonical_paths": ["AGENTS.md", ".codex/config.toml"],
+      "deprecated_paths": [],
+      "cli_probe": ["codex", "--version"]
+    },
+    "opencode": {
+      "display_name": "OpenCode",
+      "verified_date": "2026-05-19",
+      "docs_url": "https://opencode.ai/docs",
+      "recipe_file": "opencode.md",
+      "canonical_paths": ["opencode.json"],
+      "deprecated_paths": [],
+      "cli_probe": ["opencode", "--version"]
+    },
+    "junie": {
+      "display_name": "JetBrains Junie",
+      "verified_date": "2026-05-19",
+      "docs_url": "https://www.jetbrains.com/junie/",
+      "recipe_file": "junie.md",
+      "canonical_paths": [".junie/guidelines.md"],
+      "deprecated_paths": [],
+      "cli_probe": null
+    },
+    "antigravity": {
+      "display_name": "Google Antigravity",
+      "verified_date": "2026-05-19",
+      "docs_url": "https://antigravity.google/",
+      "recipe_file": "antigravity.md",
+      "canonical_paths": [".agent/rules/gxt.md"],
+      "deprecated_paths": [],
+      "cli_probe": null
+    },
+    "cline": {
+      "display_name": "Cline",
+      "verified_date": "2026-05-19",
+      "docs_url": "https://docs.cline.bot/",
+      "recipe_file": "cline.md",
+      "canonical_paths": [".clinerules/gxt.md"],
+      "deprecated_paths": [".cursorrules"],
+      "cli_probe": null
+    },
+    "aider": {
+      "display_name": "Aider",
+      "verified_date": "2026-05-19",
+      "docs_url": "https://aider.chat/docs/",
+      "recipe_file": "aider.md",
+      "canonical_paths": [".aider.conf.yml"],
+      "deprecated_paths": [],
+      "cli_probe": ["aider", "--version"]
+    },
+    "openhands": {
+      "display_name": "OpenHands",
+      "verified_date": "2026-05-19",
+      "docs_url": "https://docs.all-hands.dev/",
+      "recipe_file": "openhands.md",
+      "canonical_paths": [".openhands/microagents/gxt.md"],
+      "deprecated_paths": [],
+      "cli_probe": null
+    }
+  }
+}

package/templates/integrations/junie/.junie/guidelines.md

@@ -0,0 +1,11 @@
+# JetBrains Junie — GXT guidelines
+
+Before planning, editing code, or running substantive commands:
+
+1. Read **`AGENTS.md`**
+2. Read **`.gitagent/teacher/RULES.md`**
+3. Read **`.gitagent/foreman/MANIFEST.json`**
+
+Bootstrap: `source scripts/gxt-runtime-env.sh .gitagent/missions/<file>.yaml`
+
+See `.gitagent/ARCHITECTURE.pointer.json` for code layout (follow `read_hint`). GXT workflow: `.gitagent/README.md`.

package/templates/integrations/opencode/opencode.json

@@ -0,0 +1,3 @@
+{
+  "instructions": ["AGENTS.md", ".gitagent/teacher/RULES.md", ".gitagent/foreman/MANIFEST.json"]
+}

package/templates/integrations/openhands/.openhands/microagents/gxt.md

@@ -0,0 +1,11 @@
+# OpenHands microagent — GXT substrate
+
+Before planning or editing code, read:
+
+- `AGENTS.md`
+- `.gitagent/teacher/RULES.md`
+- `.gitagent/foreman/MANIFEST.json`
+
+Bootstrap: `source scripts/gxt-runtime-env.sh .gitagent/missions/<file>.yaml`
+
+See `.gitagent/ARCHITECTURE.pointer.json` for code layout (follow `read_hint`). GXT workflow: `.gitagent/README.md`.

package/templates/integrations/recipes/_footer.md

@@ -0,0 +1,20 @@
+---
+
+## Closed-loop checklist
+
+1. `gapman init` + `export GAPMAN_TEACHER_EMAILS="$(git config user.email)"` + `gapman doctor`
+2. `gapman legislate "<intent>" --msn MSN-NNNN --skill-key <key>` → Teacher `[MSN-NNNN]` commit
+3. Bootstrap: `source scripts/gxt-runtime-env.sh .gitagent/missions/<file>.yaml`
+4. Worker executes; append PASS quotes to `WORKER_LOG.md`
+5. `gapman verify --mission .gitagent/missions/<file>.yaml`
+6. `git push` (pre-push uses `--pre-push` handoff semantics)
+
+## Troubleshooting
+
+| Symptom | Fix |
+|---------|-----|
+| `NO_MSN_COMMITS` on push | Teacher `[MSN-NNNN]` commit modifying the mission file; set `GAPMAN_TEACHER_EMAILS` |
+| Pre-push OK, full verify fails trace | Fill `WORKER_LOG.md`; align `trace_rows`; re-run full verify |
+| `TEACHER_IDENTITY_UNCONFIGURED` | `export GAPMAN_TEACHER_EMAILS="$(git config user.email)"` |
+
+Integration compat verified by OpenGantry release — run `gapman doctor` for detected wiring and stale paths.

package/templates/integrations/recipes/_preamble.md

@@ -0,0 +1,46 @@
+# Agent Integrations (GXT wrapper)
+
+OpenGantry is **tool-agnostic**. Any agent that can run shell commands can participate in the GXT loop.
+
+## Universal rule
+
+1. Teacher legislates a mission under `.gitagent/missions/` (IDE chat: [`.gitagent/teacher/MISSION-ARCHITECT.md`](.gitagent/teacher/MISSION-ARCHITECT.md) — one copy-paste `gapman legislate` command).
+2. Bootstrap mission-scoped runtime env before worker execution.
+3. Append trace evidence to `WORKER_LOG.md`.
+4. Finish with `gapman verify --mission <path>` (full verify before merge / claiming done).
+
+```bash
+gapman runtime exec --mission .gitagent/missions/MSN-0001.<slug>.yaml -- <your-agent-command>
+source scripts/gxt-runtime-env.sh .gitagent/missions/MSN-0001.<slug>.yaml
+gapman runtime env --mission .gitagent/missions/MSN-0001.<slug>.yaml --json
+```
+
+## Enforcement boundary
+
+| Tier | Mechanism | What it actually traps |
+|------|-----------|------------------------|
+| **Process-boundary** | `gapman runtime exec` | TMVC roots + forbidden zones for subprocess workers |
+| **Deterministic hook** | Tool hooks (Cursor `beforeShellExecution` on law/manifest paths) | Shell writes to `.gitagent/foreman/`, `.gitagent/teacher/RULES.md` |
+| **Advisory** | Rules / `AGENTS.md` / tool memory | IDE Agent Write/Edit — LLM compliance, not kernel enforcement |
+
+IDE agent file edits are not TMVC-trapped unless the tool runs inside `runtime exec`.
+
+## Canonical context files
+
+| File | Role |
+|------|------|
+| `AGENTS.md` | Cross-tool entry: read RULES + MANIFEST before acting |
+| `.gitagent/teacher/RULES.md` | Governance law |
+| `.gitagent/foreman/MANIFEST.json` | Routing map (TMVC roots, forbidden zones) |
+
+## Shared session variables
+
+| Variable | Purpose |
+|----------|---------|
+| `GAPMAN_TEACHER_EMAILS` | Comma-separated Git author emails allowed to legislate |
+| `GAPMAN_MISSION` | Optional mission path for `gxt-runtime-env.sh` |
+| `GXT_*` | Emitted by `gapman runtime env` |
+
+---
+
+## Per-tool closed loop

package/templates/integrations/recipes/aider.md

@@ -0,0 +1,13 @@
+### Aider
+
+- **Context injection:** `.aider.conf.yml` with `read:` list for canonical GXT files.
+- **Session bootstrap:**
+
+```bash
+gapman runtime exec --mission .gitagent/missions/MSN-0001.<slug>.yaml -- aider --message "<task>"
+```
+
+- **Enforcement:** Process-boundary when wrapped — strongest TMVC trap among IDE-adjacent tools.
+- **Gotcha:** Run from repo root; `read:` paths resolve from CWD.
+
+Vendor docs: https://aider.chat/docs/

package/templates/integrations/recipes/antigravity.md

@@ -0,0 +1,8 @@
+### Google Antigravity
+
+- **Context injection:** Root `AGENTS.md`; `.agent/rules/gxt.md` with `always_on` pointing at canonical files.
+- **Session bootstrap:** `source scripts/gxt-runtime-env.sh <mission>` or `gapman runtime exec … -- <command>`.
+- **Enforcement:** Advisory for Editor/Manager views; process-boundary for wrapped CLI runs.
+- **Gotcha:** Rules load order includes `GEMINI.md` → `AGENTS.md` → `.agent/rules/` — keep GXT pointers in `AGENTS.md`.
+
+Vendor docs: https://antigravity.google/

package/templates/integrations/recipes/claude-code.md

@@ -0,0 +1,14 @@
+### Claude Code
+
+- **Context injection:** Minimal `CLAUDE.md` pointing at `AGENTS.md`, `.gitagent/teacher/RULES.md`, `.gitagent/foreman/MANIFEST.json`.
+- **Session bootstrap:**
+
+```bash
+source scripts/gxt-runtime-env.sh .gitagent/missions/MSN-0001.<slug>.yaml
+gapman runtime exec --mission .gitagent/missions/MSN-0001.<slug>.yaml -- claude "<task>"
+```
+
+- **Enforcement:** Advisory in interactive session; process-boundary when wrapped with `runtime exec`.
+- **Gotcha:** Link canonical files — do not copy full RULES into `CLAUDE.md`.
+
+Vendor docs: https://docs.anthropic.com/en/docs/claude-code

package/templates/integrations/recipes/cline.md

@@ -0,0 +1,8 @@
+### Cline
+
+- **Context injection:** `.clinerules/gxt.md`; root `AGENTS.md` appears in Rules panel.
+- **Session bootstrap:** VS Code terminal → `source scripts/gxt-runtime-env.sh <mission>`.
+- **Enforcement:** Advisory; toggle rules in Cline panel without deleting files.
+- **Gotcha:** Prefer `.clinerules/gxt.md` over legacy `.cursorrules` for GXT policy.
+
+Vendor docs: https://docs.cline.bot/

package/templates/integrations/recipes/codex-cli.md

@@ -0,0 +1,16 @@
+### OpenAI Codex CLI
+
+> **Not** the deprecated OpenAI Codex API (2021–2023). This covers [OpenAI Codex CLI](https://github.com/openai/codex) (2025+ terminal/IDE agent).
+
+- **Context injection:** Root `AGENTS.md` (native after `gapman init`); optional `.codex/config.toml` for project defaults.
+- **Session bootstrap:**
+
+```bash
+source scripts/gxt-runtime-env.sh .gitagent/missions/MSN-0001.<slug>.yaml
+gapman runtime exec --mission .gitagent/missions/MSN-0001.<slug>.yaml -- codex exec "<task>"
+```
+
+- **Enforcement:** Advisory in interactive TUI/IDE extension; process-boundary when wrapped with `runtime exec`.
+- **Gotcha:** Codex sandbox settings govern Codex — not GXT forbidden zones. Use `runtime exec` for manifest-enforced boundaries.
+
+Vendor docs: https://developers.openai.com/codex/config-basic

package/templates/integrations/recipes/cursor.md

@@ -0,0 +1,19 @@
+### Cursor
+
+- **Context injection:** `.cursor/rules/opengantry-gxt-substrate.mdc` (`alwaysApply: true`); `.cursor/hooks.json` — `sessionStart` mission scope + `beforeShellExecution` fallback guard; `.cursor/mcp.json` — `gapman mcp serve`.
+- **Mission Architect:** `/gantry` macro (do not use `/plan` — Cursor native Plan Mode); implicit activation when user asks to **write/edit code** with no pinned mission. Follow `.gitagent/teacher/MISSION-ARCHITECT.md`.
+- **MCP legislation:** `gxt_draft_legislation` → semantic chat approval → `gxt_execute_legislation` → Teacher commit → `gxt_check_signature` → `gxt_pin_mission`. Or **`gxt_start_orchestration`** for goal-first CLI parity.
+- **Verify remediation:** `gxt_verify` returns `error_code`, `fix_hints`, `next_actions` on failure; CLI equivalent: `gapman verify --mission … --fix`.
+- **Session bootstrap:**
+
+```bash
+scripts/gxt-pin-mission.sh .gitagent/missions/MSN-0001.<slug>.yaml
+source scripts/gxt-runtime-env.sh
+```
+
+- **Enforcement:** Advisory for Agent edits; MCP two-step gate for legislation; shell hook fallback for non-MCP paths; use `runtime exec` for headless CLI/SDK runs.
+- **Gotcha:** Enable hooks **and** MCP in Cursor Settings; restart if they do not load (**Output → Hooks**).
+
+Headless: `gapman runtime exec --mission .gitagent/missions/MSN-0001.<slug>.yaml -- cursor agent "<task>"`
+
+Vendor docs: https://cursor.com/docs/agent/hooks

package/templates/integrations/recipes/junie.md

@@ -0,0 +1,8 @@
+### JetBrains Junie
+
+- **Context injection:** `.junie/guidelines.md` (same bullets as root `AGENTS.md`).
+- **Session bootstrap:** IDE terminal → `source scripts/gxt-runtime-env.sh <mission>`.
+- **Enforcement:** Advisory (guidelines); no process trap for in-IDE edits.
+- **Gotcha:** Use `.junie/guidelines.md`, not generic AI Assistant project rules.
+
+Vendor docs: https://www.jetbrains.com/junie/

package/templates/integrations/recipes/opencode.md

@@ -0,0 +1,8 @@
+### OpenCode
+
+- **Context injection:** Repo-root `AGENTS.md` (native); optional `opencode.json` `instructions` array.
+- **Session bootstrap:** `source scripts/gxt-runtime-env.sh <mission>` then OpenCode in same terminal.
+- **Enforcement:** Advisory; OpenCode permissions are separate from GXT TMVC.
+- **Gotcha:** OpenCode prefers `AGENTS.md` over `CLAUDE.md` when both exist.
+
+Vendor docs: https://opencode.ai/docs

package/templates/integrations/recipes/openhands.md

@@ -0,0 +1,8 @@
+### OpenHands
+
+- **Context injection:** `.openhands/microagents/gxt.md` pointing at `AGENTS.md`, RULES, and MANIFEST.
+- **Session bootstrap:** `source scripts/gxt-runtime-env.sh <mission>` then run OpenHands against the repo.
+- **Enforcement:** Advisory for in-IDE edits; process-boundary when wrapped with `runtime exec`.
+- **Gotcha:** Keep microagent prose minimal — link canonical GXT files, do not duplicate RULES.
+
+Vendor docs: https://docs.all-hands.dev/

package/templates/scripts/dev-validate.sh

@@ -0,0 +1,24 @@
+#!/usr/bin/env bash
+# OpenGantry dogfood: run the full local GXT + gapman stack before push/PR.
+# Usage: ./scripts/dev-validate.sh [base-ref] [head-ref]
+#   base-ref defaults to origin/main (falls back to HEAD~1)
+#   head-ref defaults to HEAD
+set -euo pipefail
+
+ROOT="$(git rev-parse --show-toplevel 2>/dev/null)" || {
+  echo "dev-validate: not inside a git repository" >&2
+  exit 1
+}
+cd "$ROOT"
+
+BASE_REF="${1:-origin/main}"
+HEAD_REF="${2:-HEAD}"
+
+./scripts/dev-validate-core.sh "${BASE_REF}" "${HEAD_REF}"
+
+if git rev-parse --verify "${BASE_REF}^{commit}" >/dev/null 2>&1; then
+  echo "dev-validate: PR mission verify (${BASE_REF}...${HEAD_REF})"
+  ./scripts/verify-pr-missions.sh "${BASE_REF}" "${HEAD_REF}"
+fi
+
+echo "dev-validate OK — stack: check, manifest, tests, doctor, changed-code, MSN, mission-verify"

package/templates/scripts/gxt-cursor-env.sh

@@ -0,0 +1,5 @@
+#!/usr/bin/env bash
+# Deprecated: use scripts/gxt-runtime-env.sh (tool-agnostic GXT bootstrap).
+echo "gxt-cursor-env.sh is deprecated — use scripts/gxt-runtime-env.sh" >&2
+# shellcheck source=scripts/gxt-runtime-env.sh
+source "$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)/gxt-runtime-env.sh" "$@"