From e03c5f23a9d8f705eded31b528115f12b1bc7ac4 Mon Sep 17 00:00:00 2001
From: Lior Kanfi <lior@tikalk.com>
Date: Fri, 11 Sep 2026 17:56:05 +0300
Subject: [PATCH 1/2] docs(workflows): align reference doc with fork's shipped
 workflow

The fork intentionally passes empty args to plan, tasks, and implement
steps (commit e66cb0b9) so the workflow engine dispatches them without
repeating the raw spec prompt. An upstream docs sync reverted this in
the reference guide, causing test_reference_doc_matches_the_shipped_workflow
to fail. Restore the fork-correct empty args in the documented copy.

Assisted-by: opencode (model: glm-5.2, autonomous)
---
 docs/reference/workflows.md | 6 +++---
 1 file changed, 3 insertions(+), 3 deletions(-)

diff --git a/docs/reference/workflows.md b/docs/reference/workflows.md
index e2deaf181c..f30dbb75d6 100644
--- a/docs/reference/workflows.md
+++ b/docs/reference/workflows.md
@@ -472,7 +472,7 @@ steps:
     command: speckit.plan
     integration: "{{ inputs.integration }}"
     input:
-      args: "{{ inputs.spec }}"
+      args: ""
 
   - id: review-plan
     type: gate
@@ -484,13 +484,13 @@ steps:
     command: speckit.tasks
     integration: "{{ inputs.integration }}"
     input:
-      args: "{{ inputs.spec }}"
+      args: ""
 
   - id: implement
     command: speckit.implement
     integration: "{{ inputs.integration }}"
     input:
-      args: "{{ inputs.spec }}"
+      args: ""
 ```
 
 This produces the following execution flow:

From 96bd9a3a06a00f35753d9745c9d9b1a124a36d36 Mon Sep 17 00:00:00 2001
From: Lior Kanfi <lior@tikalk.com>
Date: Fri, 11 Sep 2026 18:36:37 +0300
Subject: [PATCH 2/2] fix(tests): cross-platform failures on Windows CI

test_config_set_team_directives_saves_resolved_source_and_skills:
- Use a real tmp_path subdirectory instead of Unix-only /resolved/...
- Path.resolve() on Windows converts /resolved/... to C:\resolved\...

test_verifier_checks_post_initialization_configuration:
- Skip on Windows: bash script requires WSL which is not installed
  on the GitHub Actions Windows runners.

Assisted-by: opencode (model: glm-5.2, autonomous)
---
 tests/test_config_cli.py                               | 10 +++++++---
 ..._verify_post_initialization_configuration_script.py |  3 +++
 2 files changed, 10 insertions(+), 3 deletions(-)

diff --git a/tests/test_config_cli.py b/tests/test_config_cli.py
index d658165059..2cdc00e782 100644
--- a/tests/test_config_cli.py
+++ b/tests/test_config_cli.py
@@ -174,9 +174,13 @@ def test_config_set_team_directives_saves_resolved_source_and_skills(
     monkeypatch.chdir(project)
     calls = []
 
+    # Use a real directory so Path.resolve() is cross-platform.
+    resolved_dir = tmp_path / "resolved" / "team-directives"
+    resolved_dir.mkdir(parents=True)
+
     def sync(source, project_root, *, force, preserve_previous_cache=False):
         calls.append(("sync", source, project_root, force))
-        return "local", Path("/resolved/team-directives")
+        return "local", resolved_dir
 
     def install_skills(**kwargs):
         calls.append(("skills", kwargs))
@@ -191,13 +195,13 @@ def install_skills(**kwargs):
     )
 
     assert result.exit_code == 0, result.output
-    assert load_init_options(project)["team_ai_directives"] == "/resolved/team-directives"
+    assert load_init_options(project)["team_ai_directives"] == str(resolved_dir.resolve())
     assert calls == [
         ("sync", "/input/team-directives", project, False),
         (
             "skills",
             {
-                "team_directives_path": Path("/resolved/team-directives"),
+                "team_directives_path": resolved_dir,
                 "project_path": project,
                 "selected_ai": "codex",
                 "force": False,
diff --git a/tests/test_verify_post_initialization_configuration_script.py b/tests/test_verify_post_initialization_configuration_script.py
index 79bad78cc4..36b3f2758b 100644
--- a/tests/test_verify_post_initialization_configuration_script.py
+++ b/tests/test_verify_post_initialization_configuration_script.py
@@ -3,13 +3,16 @@
 from __future__ import annotations
 
 import subprocess
+import sys
 from pathlib import Path
 
+import pytest
 
 REPO_ROOT = Path(__file__).resolve().parents[1]
 SCRIPT = REPO_ROOT / "scripts" / "verify-post-initialization-configuration.sh"
 
 
+@pytest.mark.skipif(sys.platform == "win32", reason="bash script requires WSL on Windows")
 def test_verifier_checks_post_initialization_configuration() -> None:
     """The helper validates the documented local configuration workflow."""
     result = subprocess.run(