Merge pull request #92 from randlee/feature/sc-just-templates

feat(sc-just): add just setup skill and templates

Author: randlee

.claude-plugin/marketplace.json

@@ -180,6 +180,24 @@
       ],
       "category": "tools"
     },
+    {
+      "name": "sc-just",
+      "source": "./packages/sc-just",
+      "description": "Set up repo-local just task runners with a curated Justfile, optional .just/ helper scripts, and starter templates for minimal, Python, Go, .NET, and Rust repos.",
+      "version": "0.1.0",
+      "author": {
+        "name": "randlee"
+      },
+      "license": "MIT",
+      "keywords": [
+        "just",
+        "task-runner",
+        "automation",
+        "templates",
+        "skills"
+      ],
+      "category": "tools"
+    },
     {
       "name": "sc-kanban",
       "source": "./packages/sc-kanban",
@@ -338,7 +356,9 @@
     {
       "name": "sc-observability",
       "description": "Skills for bootstrapping, adopting, and reviewing sc-observability in downstream Rust projects.",
-      "author": { "name": "randlee" },
+      "author": {
+        "name": "randlee"
+      },
       "category": "tools",
       "source": {
         "source": "git-subdir",

.claude-plugin/registry.json

@@ -168,6 +168,23 @@
       },
       "lastUpdated": "2026-04-29T04:44:47.190573+00:00"
     },
+    {
+      "name": "sc-just",
+      "version": "0.1.0",
+      "description": "Set up repo-local just task runners with a curated Justfile, optional .just/ helper scripts, and starter templates for minimal, Python, Go, .NET, and Rust repos.\n",
+      "author": "randlee",
+      "license": "MIT",
+      "keywords": [],
+      "category": "tools",
+      "artifacts": {
+        "commands": 0,
+        "skills": 1,
+        "agents": 0,
+        "scripts": 0,
+        "schemas": 0
+      },
+      "lastUpdated": "2026-05-15T21:50:55.867734+00:00"
+    },
     {
       "name": "sc-kanban",
       "version": "0.12.0",
@@ -306,13 +323,13 @@
     }
   ],
   "metadata": {
-    "totalPackages": 16,
+    "totalPackages": 17,
     "totalCommands": 10,
-    "totalSkills": 19,
+    "totalSkills": 20,
     "totalAgents": 45,
     "totalScripts": 50,
     "totalSchemas": 2
   },
-  "generated": "2026-04-29T04:44:47.196466+00:00",
-  "lastUpdated": "2026-04-29T04:44:47.196467+00:00"
+  "generated": "2026-05-15T21:50:55.867734+00:00",
+  "lastUpdated": "2026-05-15T21:50:55.867734+00:00"
 }

docs/registries/nuget/registry.json

@@ -1,7 +1,7 @@
 {
   "$schema": "https://yourcompany.github.io/schemas/package-registry.schema.json",
   "version": "2.0.0",
-  "generated": "2026-04-29T04:44:47Z",
+  "generated": "2026-05-15T21:50:55Z",
   "repo": "randlee/synaptic-canvas",
   "marketplace": {
     "name": "Synaptic Canvas",
@@ -667,14 +667,50 @@
       },
       "dependencies": [],
       "lastUpdated": "2026-04-29"
+    },
+    "sc-just": {
+      "name": "sc-just",
+      "status": "beta",
+      "tier": 2,
+      "github": "randlee/synaptic-canvas",
+      "repo": "https://github.com/randlee/synaptic-canvas",
+      "path": "packages/sc-just",
+      "readme": "https://raw.githubusercontent.com/randlee/synaptic-canvas/main/packages/sc-just/README.md",
+      "changelog": "https://raw.githubusercontent.com/randlee/synaptic-canvas/main/packages/sc-just/CHANGELOG.md",
+      "dependents": [],
+      "version": "0.1.0",
+      "description": "Set up repo-local just task runners with a curated Justfile, optional .just/ helper scripts, and starter templates for minimal, Python, Go, .NET, and Rust repos.\n",
+      "license": "MIT",
+      "author": {
+        "name": "randlee"
+      },
+      "tags": [
+        "just",
+        "task-runner",
+        "automation",
+        "templates",
+        "skills"
+      ],
+      "artifacts": {
+        "commands": 0,
+        "skills": 1,
+        "agents": 0,
+        "scripts": 0,
+        "schemas": 0
+      },
+      "dependencies": [
+        "just >= 1.0",
+        "python3 >= 3.11"
+      ],
+      "lastUpdated": "2026-05-15"
     }
   },
   "metadata": {
     "registryVersion": "2.0.0",
     "schemaVersion": "1.0.0",
-    "totalPackages": 11,
+    "totalPackages": 12,
     "totalCommands": 13,
-    "totalSkills": 10,
+    "totalSkills": 11,
     "totalAgents": 34,
     "totalScripts": 19,
     "categories": {
@@ -684,7 +720,8 @@
         "sc-startup",
         "sc-commit-push-pr",
         "sc-launch-term",
-        "sc-launchpad"
+        "sc-launchpad",
+        "sc-just"
       ],
       "development-tools": [
         "sc-git-worktree",
@@ -727,9 +764,10 @@
         "sc-startup",
         "sc-commit-push-pr",
         "sc-launch-term",
-        "sc-launchpad"
+        "sc-launchpad",
+        "sc-just"
       ],
-      "total_packages": 11
+      "total_packages": 12
     }
   }
 }

packages/sc-just/.claude-plugin/plugin.json

@@ -0,0 +1,19 @@
+{
+  "name": "sc-just",
+  "description": "Set up repo-local just task runners with a curated Justfile, optional .just/ helper scripts, and starter templates for minimal, Python, Go, .NET, and Rust repos.",
+  "version": "0.1.0",
+  "author": {
+    "name": "randlee"
+  },
+  "license": "MIT",
+  "keywords": [
+    "just",
+    "task-runner",
+    "automation",
+    "templates",
+    "skills"
+  ],
+  "skills": [
+    "./skills/setting-up-just/SKILL.md"
+  ]
+}

packages/sc-just/CHANGELOG.md

@@ -0,0 +1,11 @@
+# Changelog
+
+## 0.1.0 — 2026-05-15
+
+Initial package release.
+
+- `setting-up-just` skill for adding repo-local `just` automation
+- template catalog and adoption workflow references
+- starter templates for `minimal`, `python`, `go`, `.NET`, and `rust` repo layouts
+- Rust template modeled on the `atm-core` pattern of a thin `Justfile` plus
+  `.just/` Python helpers

packages/sc-just/README.md

@@ -0,0 +1,44 @@
+# sc-just
+
+Repo-local `just` setup skill for Synaptic Canvas. Provides a single skill plus
+starter templates for adding a root `Justfile` and `.just/` helper scripts to a
+repository.
+
+## Skill
+
+### setting-up-just
+Choose a starter profile, copy the matching template files into the target repo,
+adapt the commands to the repo's actual toolchain, and verify the final `just`
+surface.
+
+Each template also ships a `.just/config.toml`. The helpers are intended to stay
+generic; repo-specific commands, aliases, and discovery settings live in that
+config file.
+The helper scripts require `python3 >= 3.11` because they use `tomllib`.
+Installed package payload is declared in `manifest.yaml`; `.claude-plugin/plugin.json`
+is metadata for marketplace registration and discovery.
+
+## Included Template Profiles
+
+- `minimal` for generic repos that need a thin `just` shell with placeholders
+- `python` for Python repos using `ruff` and `pytest`
+- `go` for Go repos that want root-level `go build ./...` and `go test ./...`
+- `dotnet` for .NET repos that want `just help`, `just build`, and `just test`
+  mapped directly to `dotnet build` and `dotnet test` from repo root
+- `rust` for Cargo workspaces that want the `atm-core` pattern of a lean
+  `Justfile` backed by `.just/*.py` helpers
+
+## Requirements
+
+- `just`
+- `python3 >= 3.11`
+
+The Python template assumes `ruff` and `pytest`. The Go template assumes `go`.
+The Rust template assumes `cargo` and `clippy`. The `.NET` template assumes
+`dotnet` and a repo where root-level `dotnet build` / `dotnet test` are the
+right default.
+
+## Storage
+
+This package installs into `.claude/` only. It does not create persistent state
+at runtime. The copied `Justfile` and `.just/` helpers live in the target repo.

packages/sc-just/manifest.yaml

@@ -0,0 +1,59 @@
+name: sc-just
+version: 0.1.0
+description: >
+  Set up repo-local just task runners with a curated Justfile, optional .just/
+  helper scripts, and starter templates for minimal, Python, Go, .NET, and
+  Rust repos.
+author: randlee
+license: MIT
+category: tools
+tags:
+  - just
+  - task-runner
+  - automation
+  - templates
+  - skills
+
+# Installation source of truth: files copied from this package are declared
+# under artifacts below. `.claude-plugin/plugin.json` is marketplace metadata.
+artifacts:
+  skills:
+    - skills/setting-up-just/SKILL.md
+    - skills/setting-up-just/references/template-catalog.md
+    - skills/setting-up-just/references/adoption-workflow.md
+    - skills/setting-up-just/references/installation-and-troubleshooting.md
+  assets:
+    - skills/setting-up-just/assets/templates/minimal/Justfile
+    - skills/setting-up-just/assets/templates/minimal/.just/config.toml
+    - skills/setting-up-just/assets/templates/minimal/.just/print_help.py
+    - skills/setting-up-just/assets/templates/minimal/.just/task_runner.py
+    - skills/setting-up-just/assets/templates/minimal/.just/run_fmt.py
+    - skills/setting-up-just/assets/templates/minimal/.just/run_lint.py
+    - skills/setting-up-just/assets/templates/minimal/.just/run_tests.py
+    - skills/setting-up-just/assets/templates/python/Justfile
+    - skills/setting-up-just/assets/templates/python/.just/config.toml
+    - skills/setting-up-just/assets/templates/python/.just/print_help.py
+    - skills/setting-up-just/assets/templates/python/.just/task_runner.py
+    - skills/setting-up-just/assets/templates/python/.just/run_fmt.py
+    - skills/setting-up-just/assets/templates/python/.just/run_lint.py
+    - skills/setting-up-just/assets/templates/python/.just/run_tests.py
+    - skills/setting-up-just/assets/templates/go/Justfile
+    - skills/setting-up-just/assets/templates/go/.just/config.toml
+    - skills/setting-up-just/assets/templates/go/.just/print_help.py
+    - skills/setting-up-just/assets/templates/go/.just/run_fmt.py
+    - skills/setting-up-just/assets/templates/dotnet/Justfile
+    - skills/setting-up-just/assets/templates/dotnet/.just/config.toml
+    - skills/setting-up-just/assets/templates/dotnet/.just/print_help.py
+    - skills/setting-up-just/assets/templates/rust/Justfile
+    - skills/setting-up-just/assets/templates/rust/.just/config.toml
+    - skills/setting-up-just/assets/templates/rust/.just/print_help.py
+    - skills/setting-up-just/assets/templates/rust/.just/run_fmt.py
+    - skills/setting-up-just/assets/templates/rust/.just/run_lint.py
+
+install:
+  scope: local-only
+
+requires:
+  cli:
+    - just >= 1.0
+    - python3 >= 3.11