Remove co-work-specific gstack path assumptions

Author: sdntsng

README.md

@@ -52,17 +52,17 @@ That creates symlinks from this repo's `skills/` directory into `~/.codex/skills
 
 ## Keep up with upstream gstack
 
-If you have a local `gstack` checkout, refresh the sync report and scaffold any newly discovered upstream skills:
+If you have a local clone of upstream `gstack`, refresh the sync report and scaffold any newly discovered upstream skills:
 
 ```bash
-./scripts/update-from-local-gstack.sh ../knowledge-base/gstack
+./scripts/update-from-local-gstack.sh /path/to/gstack
 ```
 
 Or run the steps explicitly:
 
 ```bash
-python3 scripts/sync_from_gstack.py status --source ../knowledge-base/gstack
-python3 scripts/sync_from_gstack.py scaffold-new --source ../knowledge-base/gstack
+python3 scripts/sync_from_gstack.py status --source /path/to/gstack
+python3 scripts/sync_from_gstack.py scaffold-new --source /path/to/gstack
 ```
 
 This will:
@@ -72,7 +72,7 @@ This will:
 
 ## Current upstream coverage
 
-The local upstream source used for the current mapping is `../knowledge-base/gstack`.
+The current mapping was validated against an external local clone of upstream `gstack`.
 
 - Local `gstack` HEAD: `52f1607`
 - Local `gstack` `origin/main`: `50a7cf8`

catalog/gstack-sync-status.md

@@ -1,6 +1,6 @@
 # gstack sync status
 
-Source: `../knowledge-base/gstack`
+Source: external gstack checkout `gstack`
 
 | gstack skill | codex skill | category | status |
 |---|---|---|---|

docs/porting-guide.md

@@ -31,7 +31,7 @@ Turn strong upstream `gstack` workflows into concise Codex-native skills.
 
 ## Fast path for new upstream skills
 When a new upstream skill appears:
-1. run `sync_from_gstack.py scaffold-new`
+1. run `sync_from_gstack.py scaffold-new --source /path/to/gstack`
 2. inspect the generated scaffold under `scaffolds/`
 3. decide whether it belongs in the curated pack
 4. if yes, create a polished version under `skills/`

scripts/sync_from_gstack.py

@@ -6,7 +6,6 @@
 import re
 from pathlib import Path
 
-DEFAULT_SOURCE = Path(__file__).resolve().parents[2] / 'knowledge-base' / 'gstack'
 REPO_ROOT = Path(__file__).resolve().parents[1]
 MAPPINGS_PATH = REPO_ROOT / 'mappings' / 'skills.json'
 SKILLS_DIR = REPO_ROOT / 'skills'
@@ -61,7 +60,7 @@ def write_status(source_root: Path) -> Path:
     lines = [
         '# gstack sync status',
         '',
-        f'Source: `{source_root}`',
+        f'Source: external gstack checkout `{source_root.name}`',
         '',
         '| gstack skill | codex skill | category | status |',
         '|---|---|---|---|'
@@ -129,14 +128,18 @@ def install_links(target_dir: Path) -> list[str]:
 def main() -> None:
     parser = argparse.ArgumentParser(description='Sync and scaffold Codex skills from gstack.')
     parser.add_argument('command', choices=['status', 'scaffold-new', 'install'])
-    parser.add_argument('--source', type=Path, default=DEFAULT_SOURCE)
+    parser.add_argument('--source', type=Path)
     parser.add_argument('--target', type=Path, default=Path.home() / '.codex' / 'skills')
     args = parser.parse_args()
 
     if args.command == 'status':
+        if args.source is None:
+            parser.error('--source is required for status')
         out = write_status(args.source)
         print(out)
     elif args.command == 'scaffold-new':
+        if args.source is None:
+            parser.error('--source is required for scaffold-new')
         created = scaffold_new(args.source)
         write_status(args.source)
         for path in created:

scripts/update-from-local-gstack.sh

@@ -1,6 +1,10 @@
 #!/usr/bin/env bash
 set -euo pipefail
 ROOT="$(cd "$(dirname "$0")/.." && pwd)"
-SOURCE="${1:-$ROOT/../knowledge-base/gstack}"
+if [ "$#" -lt 1 ]; then
+  echo "Usage: $0 /path/to/gstack" >&2
+  exit 1
+fi
+SOURCE="$1"
 python3 "$ROOT/scripts/sync_from_gstack.py" status --source "$SOURCE"
 python3 "$ROOT/scripts/sync_from_gstack.py" scaffold-new --source "$SOURCE"