fix(dso-igoj batch2): fix INSTALL.md redundancy and CLAUDE_PLUGIN_ROOT label accuracy

Post-review fixes:
- docs/INSTALL.md: remove Step 3 manual config copy (dso-setup.sh now handles it automatically)
- scripts/dso-setup.sh: correct CLAUDE_PLUGIN_ROOT label to 'optional' (dso.plugin_root in workflow-config.conf is the primary mechanism)
- .tickets/dso-7h4i.md: track PyYAML check guard for missing python3 (deferred)
- .tickets/dso-j48b.md: track INSTALL.md /dso:init clarification (deferred)

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

Author: JoeOakhartNava

.tickets/.index.json

@@ -121,6 +121,13 @@
     "title": "Separate DSO plugin from DSO project",
     "type": "epic"
   },
+  "dso-7h4i": {
+    "deps": [],
+    "priority": 3,
+    "status": "open",
+    "title": "Fix: guard PyYAML check in dso-setup.sh against missing python3",
+    "type": "bug"
+  },
   "dso-8g5p": {
     "deps": [],
     "priority": 2,
@@ -233,6 +240,13 @@
     "title": "Don't merge to main between batches",
     "type": "epic"
   },
+  "dso-j48b": {
+    "deps": [],
+    "priority": 3,
+    "status": "open",
+    "title": "Fix: add clarifying parenthetical for /dso:init in INSTALL.md Step 5",
+    "type": "bug"
+  },
   "dso-jl2z": {
     "deps": [
       "dso-5l1c"

.tickets/.sync-state.json

@@ -227,6 +227,6 @@
     "jira_hash": "b2fcb1e44695c32874c75055e4b8c9e8",
     "last_synced": "2026-03-17T18:34:36Z"
   },
-  "last_sync_commit": "acc23406c818a7993280c48070b98f829764cf30",
-  "last_pull_timestamp": "2026-03-18T07:40:01Z"
+  "last_sync_commit": "df19a42e3f5307216b254eba09bed22ba058996d",
+  "last_pull_timestamp": "2026-03-18T07:57:32Z"
 }

.tickets/dso-7h4i.md

@@ -0,0 +1,13 @@
+---
+id: dso-7h4i
+status: open
+deps: []
+links: []
+created: 2026-03-18T07:58:53Z
+type: bug
+priority: 3
+assignee: Joe Oakhart
+parent: dso-igoj
+---
+# Fix: guard PyYAML check in dso-setup.sh against missing python3
+

.tickets/dso-j48b.md

@@ -0,0 +1,13 @@
+---
+id: dso-j48b
+status: open
+deps: []
+links: []
+created: 2026-03-18T07:58:52Z
+type: bug
+priority: 3
+assignee: Joe Oakhart
+parent: dso-igoj
+---
+# Fix: add clarifying parenthetical for /dso:init in INSTALL.md Step 5
+

docs/INSTALL.md

@@ -44,20 +44,22 @@ This script:
 The `dso.plugin_root` key tells the shim where the plugin lives when `CLAUDE_PLUGIN_ROOT` is not set as an
 environment variable. See [dso.plugin_root in the Configuration Reference](CONFIGURATION-REFERENCE.md#dsoplugin_root).
 
-### Step 3 — Copy example configuration files
+### Step 3 — Customize configuration files
 
-Copy the pre-commit config and workflow-config.conf template (skip any that already exist):
+`dso-setup.sh` (Step 2) already copies default `.pre-commit-config.yaml` and `.github/workflows/ci.yml`
+into your project if they don't exist. This step is about reviewing and customizing them.
+
+If you ran a manual install (without `dso-setup.sh`), copy the defaults first:
 
 ```bash
-# Pre-commit hook configuration (skip if .pre-commit-config.yaml already exists)
-cp $CLAUDE_PLUGIN_ROOT/examples/pre-commit-config.example.yaml .pre-commit-config.yaml
+# Pre-commit hook configuration (if not already present)
+cp "$CLAUDE_PLUGIN_ROOT/examples/pre-commit-config.example.yaml" .pre-commit-config.yaml
 
-# Workflow config (skip if workflow-config.conf already exists)
-cp $CLAUDE_PLUGIN_ROOT/docs/workflow-config.example.conf workflow-config.conf
+# CI workflow (if not already present)
+mkdir -p .github/workflows
+cp "$CLAUDE_PLUGIN_ROOT/examples/ci.example.yml" .github/workflows/ci.yml
 ```
 
-If `CLAUDE_PLUGIN_ROOT` is not set, replace it with the absolute path to the plugin directory.
-
 Edit `workflow-config.conf` to match your project. All keys are optional except `version` — omitted
 keys fall back to stack-detected defaults. See [Configuration Reference](CONFIGURATION-REFERENCE.md).
 

scripts/dso-setup.sh

@@ -134,7 +134,7 @@ fi
 
 # ── Environment variable guidance ─────────────────────────────────────────────
 echo '=== Environment Variables (add to your shell profile) ==='
-echo 'CLAUDE_PLUGIN_ROOT=  # Required: DSO plugin path'
+echo 'CLAUDE_PLUGIN_ROOT=  # Optional: overrides dso.plugin_root from workflow-config.conf'
 echo 'JIRA_URL=https://your-org.atlassian.net  # Required for Jira sync'
 echo 'JIRA_USER=you@example.com  # Required for Jira sync'
 echo 'JIRA_API_TOKEN=...  # Required for Jira sync'