feat: GraphStack v4.0.0 — cross-platform release

Unify repo layout under .cursor/skills/ (source matches installed projects) and port board, installer, and post-commit hooks to scripts/graphstack/.

Add PowerShell shims, pytest suite, graphifyy pin (requirements.txt), tri-OS CI matrix, markdown link lint, orchestrator/path fixes, and CHANGELOG migration notes.

Co-authored-by: Cursor <cursoragent@cursor.com>

Author: MertCapkin

.cursor/rules/graphstack.mdc

@@ -1,9 +1,9 @@
 ---
-description: GraphStack v3 — Orchestrated, graph-first, GNAP-tracked AI development
+description: GraphStack v4 — Orchestrated, graph-first, GNAP-tracked AI development (cross-platform)
 alwaysApply: true
 ---
 
-# GraphStack Core Rules (v3)
+# GraphStack Core Rules (v4)
 
 ## 🎯 Default Mode: Orchestrated
 
@@ -57,7 +57,7 @@ If something looks wrong but is out of scope, note it in `handoff/REVIEW.md` for
 ## 🔄 Rule 6: Graph Staleness Check
 
 If `graphify-out/GRAPH_REPORT.md` is older than the files being discussed:
-- Warn: "Graph may be stale. Consider running `/graphify . --update`"
+- Warn: "Graph may be stale. Consider running `/graphify --update`"
 - Continue with available graph data unless user requests refresh
 
 ## 📁 Rule 7: Handoff Files

skills/architect/ARCHITECT.md .cursor/skills/architect/ARCHITECT.mdskills/architect/ARCHITECT.md renamed to .cursor/skills/architect/ARCHITECT.md

@@ -127,7 +127,7 @@ When brief is ready:
 1. Write `handoff/BRIEF.md`
 2. Create the GNAP board task:
    ```bash
-   bash scripts/board.sh new <task-id> "<objective one-liner>"
+   python -m graphstack board new <task-id> "<objective one-liner>"
    ```
 3. Announce:
 ```

skills/bootstrapper/BOOTSTRAPPER.md …rsor/skills/bootstrapper/BOOTSTRAPPER.mdskills/bootstrapper/BOOTSTRAPPER.md renamed to .cursor/skills/bootstrapper/BOOTSTRAPPER.md skills/bootstrapper/BOOTSTRAPPER.md renamed to .cursor/skills/bootstrapper/BOOTSTRAPPER.md

@@ -42,7 +42,7 @@ If a graph already exists, the Orchestrator uses the Architect instead — not y
 6. Wait for approval. Revise if needed.
 
 7. Write the first brief (Cycle 1) to handoff/BRIEF.md.
-   Create the board task: bash scripts/board.sh new cycle-1-[module] [module name]
+   Create the board task: python -m graphstack board new cycle-1-[module] [module name]
 
 8. Announce handoff:
    "[BOOTSTRAPPER → BUILDER]

skills/builder/BUILDER.md .cursor/skills/builder/BUILDER.mdskills/builder/BUILDER.md renamed to .cursor/skills/builder/BUILDER.md

@@ -23,11 +23,11 @@ When activated, execute this sequence exactly:
    b. Check handoff/board/todo/ — find the task whose title matches the brief
       → If exactly 1 match: claim it automatically
       → If 0 matches: create one on the fly:
-          bash scripts/board.sh new [brief-slug] [brief objective]
+          python -m graphstack board new [brief-slug] [brief objective]
       → If 2+ matches: list them and ask user which to claim
 
 4. Claim the task:
-   bash scripts/board.sh claim <task-id> builder
+   python -m graphstack board claim <task-id> builder
 
 5. Report:
    "Graph loaded. Brief loaded. Board task claimed: [task-id]

skills/qa/QA.md .cursor/skills/qa/QA.mdskills/qa/QA.md renamed to .cursor/skills/qa/QA.md

@@ -20,7 +20,7 @@ When activated, execute this sequence exactly:
    → Understand what was already checked — don't duplicate
 
 4. Claim the active board task as qa:
-   bash scripts/board.sh claim <task-id> qa
+   python -m graphstack board claim <task-id> qa
    → If task is already in doing/ under a different role: note it, continue
    → If no board task found: skip silently
 

skills/reviewer/REVIEWER.md .cursor/skills/reviewer/REVIEWER.mdskills/reviewer/REVIEWER.md renamed to .cursor/skills/reviewer/REVIEWER.md

@@ -19,7 +19,7 @@ When activated, execute this sequence exactly:
    → If missing: skip silently
 
 4. Claim the active board task as reviewer:
-   bash scripts/board.sh claim <task-id> reviewer
+   python -m graphstack board claim <task-id> reviewer
    → If no task in doing/: check todo/ for a matching task and claim it
    → If board has no matching task: skip board step silently, continue
 

skills/ship/SHIP.md .cursor/skills/ship/SHIP.mdskills/ship/SHIP.md renamed to .cursor/skills/ship/SHIP.md

@@ -38,7 +38,7 @@ Code Hygiene
 
 Board
   [ ] Task moved to done/:
-      bash scripts/board.sh complete <task-id>
+      python -m graphstack board complete <task-id>
   [ ] board/doing/ is empty after this commit
 
 Handoff Files

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -7,6 +7,37 @@ body:
       value: |
         Thanks for reporting. Please fill in as much as you can.
 
+  - type: dropdown
+    id: os
+    attributes:
+      label: Operating system
+      options:
+        - Windows (PowerShell)
+        - Windows (Git Bash / WSL)
+        - macOS
+        - Linux
+        - Other
+    validations:
+      required: true
+
+  - type: input
+    id: python-version
+    attributes:
+      label: Python version
+      description: Output of `python --version` (or `py -3 --version` on Windows).
+      placeholder: "3.11.7"
+    validations:
+      required: false
+
+  - type: input
+    id: graphifyy-version
+    attributes:
+      label: Graphifyy version
+      description: Output of `pip show graphifyy | head -2`.
+      placeholder: "0.7.8"
+    validations:
+      required: false
+
   - type: dropdown
     id: ai-tool
     attributes: