chore(skills): add desktop manifest workflow

Author: ericyangpan

.agents/skills/manifest-automation/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: manifest-automation
-description: Prepares and guides evidence-backed creation or updates of CLI, extension, IDE, model, provider, and vendor manifests in this repository. Use when manifest data must be researched, merged, localized, and validated against the current schemas.
+description: Prepares and guides evidence-backed creation or updates of CLI, desktop, extension, IDE, model, provider, and vendor manifests in this repository. Use when manifest data must be researched, merged, localized, and validated against the current schemas.
 ---
 
 # Manifest Automation
@@ -14,7 +14,7 @@ node .agents/skills/manifest-automation/scripts/automate.mjs create model exampl
 node .agents/skills/manifest-automation/scripts/automate.mjs update model existing-model
 ```
 
-Supported types: `cli`, `extension`, `ide`, `model`, `provider`, and `vendor`.
+Supported types: `cli`, `desktop`, `extension`, `ide`, `model`, `provider`, and `vendor`.
 
 ## Required workflow
 
@@ -30,6 +30,8 @@ Supported types: `cli`, `extension`, `ide`, `model`, `provider`, and `vendor`.
 ## Merge policy
 
 - Immutable identity fields such as `id` are preserved.
+- Use `familyId` to group surfaces that official sources present as one product family; keep `relatedProducts` bidirectional for explicit navigation.
+- Classify a standalone native app for delegating or supervising coding agents as `desktop`. Keep products whose primary first-party surface is an editor under `ide`; do not classify web or cloud-only services as desktop products.
 - Mutable facts may change only with current, authoritative evidence.
 - Object arrays are merged by their schema identity, not by raw object equality.
 - Pricing, license, lifecycle, availability, model limits, install commands, and marketplace identifiers require explicit verification.
@@ -40,7 +42,7 @@ The merge helper is advisory. Always inspect its proposed result before applying
 
 ## GitHub stars
 
-`data/github-stars.json` tracks only `cli`, `extension`, `ide`, and `model` entries. Add an entry only when the entity has an official GitHub repository and the repository's fetch workflow supports that manifest. Providers and vendors are not tracked.
+`data/github-stars.json` tracks `cli`, `desktop`, `extension`, `ide`, and selected `model` entries. Every CLI, desktop, extension, and IDE manifest must have a corresponding entry; use `null` when no official repository or trustworthy count is available. Providers and vendors are not tracked.
 
 ## Validation
 

.agents/skills/manifest-automation/scripts/lib/config.mjs

@@ -5,11 +5,12 @@
  */
 
 // Supported manifest types
-export const MANIFEST_TYPES = ['cli', 'extension', 'ide', 'model', 'provider', 'vendor']
+export const MANIFEST_TYPES = ['cli', 'desktop', 'extension', 'ide', 'model', 'provider', 'vendor']
 
 // Schema path mapping
 export const SCHEMA_PATHS = {
   cli: 'manifests/$schemas/cli.schema.json',
+  desktop: 'manifests/$schemas/desktop.schema.json',
   extension: 'manifests/$schemas/extension.schema.json',
   ide: 'manifests/$schemas/ide.schema.json',
   model: 'manifests/$schemas/model.schema.json',
@@ -20,6 +21,7 @@ export const SCHEMA_PATHS = {
 // Manifest output path mapping
 export const MANIFEST_PATHS = {
   cli: name => `manifests/clis/${name}.json`,
+  desktop: name => `manifests/desktops/${name}.json`,
   extension: name => `manifests/extensions/${name}.json`,
   ide: name => `manifests/ides/${name}.json`,
   model: name => `manifests/models/${name}.json`,
@@ -30,6 +32,7 @@ export const MANIFEST_PATHS = {
 // Workflow file mapping
 export const WORKFLOW_PATHS = {
   cli: '.agents/skills/manifest-automation/scripts/workflows/cli-workflow.md',
+  desktop: '.agents/skills/manifest-automation/scripts/workflows/desktop-workflow.md',
   extension: '.agents/skills/manifest-automation/scripts/workflows/extension-workflow.md',
   ide: '.agents/skills/manifest-automation/scripts/workflows/ide-workflow.md',
   model: '.agents/skills/manifest-automation/scripts/workflows/model-workflow.md',
@@ -59,7 +62,7 @@ export const FIELD_CATEGORIES = {
   ],
 
   // Preserve identity, relationships, and localized copy for manual review.
-  PRESERVE: ['id', 'name', 'translations', 'relatedProducts', 'vendor', 'provider'],
+  PRESERVE: ['id', 'familyId', 'name', 'translations', 'relatedProducts', 'vendor', 'provider'],
 
   // Smart merge: add new, keep existing
   MERGE_ADDITIVE: ['communityUrls', 'platformUrls', 'supportedIdes', 'platforms'],
@@ -79,7 +82,7 @@ export const FIELD_CATEGORIES = {
 }
 
 // Platform OS enum values
-export const PLATFORM_OS = ['macos', 'windows', 'linux', 'web']
+export const PLATFORM_OS = ['macOS', 'Windows', 'Linux']
 
 // IDE enum values for extensions
 export const IDE_TYPES = ['vscode', 'cursor', 'windsurf', 'trae', 'zed', 'jetbrains']

.agents/skills/manifest-automation/scripts/workflows/desktop-workflow.md

@@ -0,0 +1,30 @@
+# Desktop manifest workflow
+
+## Read before editing
+
+- `manifests/$schemas/desktop.schema.json` and referenced schemas
+- `src/types/manifests.ts`
+- the target manifest and two current desktop examples
+- related CLI, extension, IDE, and vendor manifests
+
+## Classification boundary
+
+Use `desktop` for a standalone native application whose primary workflow is delegating, coordinating, or reviewing coding-agent work. A product may share one `familyId` with CLI or extension surfaces. Keep editor-first products under `ide`, and exclude browser-only, hosted, and cloud execution products.
+
+## Evidence checklist
+
+Use the official product/download page, documentation, release notes, repository, pricing page, and license. Verify that the native desktop build actually exists for each recorded OS. Do not infer a Windows or Linux build from a generic product page.
+
+## Create or update
+
+1. Keep filename, `id`, official name, vendor, and `familyId` aligned.
+2. Record only schema-supported operating systems and documented install or launch commands.
+3. Do not invent application paths; use `null` when an optional value is undocumented.
+4. Use the latest stable version when published; otherwise use the vendor's documented release label without inventing a number.
+5. Copy pricing and license facts without conversion or extrapolation.
+6. Add bidirectional `relatedProducts` links for verified CLI, extension, IDE, or desktop siblings.
+7. Keep every configured locale complete and semantically aligned.
+
+## Validation
+
+Run the parent skill's validation sequence. Confirm that GitHub stars, generated indexes, navigation counts, vendor pages, search, sitemap, and related-product links all include the new desktop manifest.