From 81d4b6d573f944da213f011ac73ec34745d3d707 Mon Sep 17 00:00:00 2001 From: Tom Boucher Date: Fri, 19 Jun 2026 21:03:26 -0400 Subject: [PATCH] docs(#1010): document projects-sync as the first reference third-party capability (#1470) Add a worked example to the URL-import how-to showing how to install and enable the projects-sync ADR-1244 ecosystem capability (published at The-Artificer-of-Ciphers-LLC/projects-sync-capability). The capability ships as an external installable repo; GSD Core gains the worked example only. Closes #1010 --- docs/how-to/import-a-capability-from-a-url.md | 14 ++++++++++++++ 1 file changed, 14 insertions(+) diff --git a/docs/how-to/import-a-capability-from-a-url.md b/docs/how-to/import-a-capability-from-a-url.md index 80d825e3d..60c52dd21 100644 --- a/docs/how-to/import-a-capability-from-a-url.md +++ b/docs/how-to/import-a-capability-from-a-url.md @@ -169,6 +169,20 @@ The output shows each installed capability, its version, scope, and enabled stat --- +## A worked example: projects-sync + +[`projects-sync`](https://github.com/The-Artificer-of-Ciphers-LLC/projects-sync-capability) is a reference third-party capability — it mirrors a project's `.planning/ROADMAP.md` to GitHub Issues, Milestones, and Projects v2. Install it the same way as any URL spec: + +```bash +gsd capability install https://github.com/The-Artificer-of-Ciphers-LLC/projects-sync-capability.git#v0.1.0 --scope project +gsd-tools config-set projects-sync.enabled true # opt-in, default off +gsd-tools projects-sync status # dry run +``` + +It is a `role: feature` capability that registers an `execute:pre` step and a `ship:post` contribution (both `onError: skip`) and contributes the `projects-sync` command family — a concrete model for the manifest shape, hook registration, and command-router conventions described in [Develop a capability](./develop-a-capability.md). + +--- + ## Next steps - [Version and update a capability](./version-a-capability.md) — check for updates with `gsd capability outdated` and apply them with `gsd capability update`.