Address ninth review: populate catalog, fix indentation, priority, README

- Add speckit workflow entry to catalog.json so it's discoverable
- Fix shell step output dict indentation
- Catalog add_catalog priority derived from max existing + 1
- README Quick Start clarified with install + local file examples

Author: mnriem

src/specify_cli/workflows/catalog.py

@@ -467,11 +467,13 @@ def add_catalog(self, url: str, name: str | None = None) -> None:
                     f"Catalog URL already configured: {url}"
                 )
 
+        # Derive priority from the highest existing priority + 1
+        max_priority = max((cat.get("priority", 0) for cat in catalogs), default=0)
         catalogs.append(
             {
                 "name": name or f"catalog-{len(catalogs) + 1}",
                 "url": url,
-                "priority": len(catalogs) + 1,
+                "priority": max_priority + 1,
                 "install_allowed": True,
                 "description": "",
             }

src/specify_cli/workflows/steps/shell/__init__.py

@@ -39,10 +39,10 @@ def execute(self, config: dict[str, Any], context: StepContext) -> StepResult:
                 timeout=300,
             )
             output = {
-                    "exit_code": proc.returncode,
-                    "stdout": proc.stdout,
-                    "stderr": proc.stderr,
-                }
+                "exit_code": proc.returncode,
+                "stdout": proc.stdout,
+                "stderr": proc.stderr,
+            }
             if proc.returncode != 0:
                 return StepResult(
                     status=StepStatus.FAILED,

workflows/README.md

@@ -31,10 +31,13 @@ For detailed architecture and internals, see [ARCHITECTURE.md](ARCHITECTURE.md).
 # Search available workflows
 specify workflow search
 
-# Install a workflow from the catalog
+# Install the built-in SDD workflow
 specify workflow add speckit
 
-# Run a workflow with inputs
+# Or run directly from a local YAML file
+specify workflow run ./workflow.yml --input feature_name="user-auth"
+
+# Run an installed workflow with inputs
 specify workflow run speckit --input feature_name="user-auth"
 
 # Check run status

workflows/catalog.json

@@ -1,6 +1,16 @@
 {
   "schema_version": "1.0",
-  "updated_at": "2026-04-10T00:00:00Z",
+  "updated_at": "2026-04-13T00:00:00Z",
   "catalog_url": "https://raw.githubusercontent.com/github/spec-kit/main/workflows/catalog.json",
-  "workflows": {}
+  "workflows": {
+    "speckit": {
+      "id": "speckit",
+      "name": "Full SDD Cycle",
+      "description": "Runs specify \u2192 plan \u2192 tasks \u2192 implement with review gates",
+      "author": "GitHub",
+      "version": "1.0.0",
+      "url": "https://raw.githubusercontent.com/github/spec-kit/main/workflows/speckit/workflow.yml",
+      "tags": ["sdd", "full-cycle"]
+    }
+  }
 }