@harness-forge/cli 0.1.0

package/manifests/catalog/engineering-assistant-import-inventory.json

@@ -0,0 +1,215 @@
+{
+  "packId": "engineering-assistant-2026-03",
+  "sourceName": "Engineering Assistant Skill Pack",
+  "sourceVersion": "2026-03-26-import",
+  "resourceRoots": [
+    "engineering-assistant/"
+  ],
+  "summary": "Governed port record for the imported engineering-assistant archive, preserving its architecture and implementation collaboration contract while translating notes, changelog, helper-script, and metadata assumptions into project-owned Harness Forge surfaces.",
+  "validationScope": "The MVP port validates canonical skill ownership, imported artifact coverage, helper-surface planning, and packaged governance paths. Runtime wrapper parity and executable helper commands remain scheduled for later user-story slices.",
+  "researchScope": "The imported pack contributes architecture playbooks, SOLID and patterns guidance, skill-composition rules, project-memory expectations, strict change-discipline habits, and runtime metadata from its original OpenAI-oriented packaging.",
+  "entries": [
+    {
+      "artifactPath": "engineering-assistant/SKILL.md",
+      "artifactType": "skill",
+      "skillId": "engineering-assistant",
+      "existingProjectSurface": null,
+      "decision": "embed",
+      "decisionReason": "The imported pack owns a distinct orchestration responsibility that fits Harness Forge as one canonical skill instead of as a wrapper-only appendix.",
+      "destinationPath": "skills/engineering-assistant/SKILL.md",
+      "reviewStatus": "accepted"
+    },
+    {
+      "artifactPath": "engineering-assistant/references/architecture.md",
+      "artifactType": "reference",
+      "skillId": "engineering-assistant",
+      "existingProjectSurface": null,
+      "decision": "embed",
+      "decisionReason": "The architecture checklist is core operator guidance and should ship as a project-owned engineering-assistant reference.",
+      "destinationPath": "skills/engineering-assistant/references/architecture.md",
+      "reviewStatus": "accepted"
+    },
+    {
+      "artifactPath": "engineering-assistant/references/solid-and-patterns.md",
+      "artifactType": "reference",
+      "skillId": "engineering-assistant",
+      "existingProjectSurface": null,
+      "decision": "embed",
+      "decisionReason": "The practical SOLID and pattern guidance is a direct supporting reference for the canonical skill contract.",
+      "destinationPath": "skills/engineering-assistant/references/solid-and-patterns.md",
+      "reviewStatus": "accepted"
+    },
+    {
+      "artifactPath": "engineering-assistant/references/skill-composition.md",
+      "artifactType": "reference",
+      "skillId": "engineering-assistant",
+      "existingProjectSurface": null,
+      "decision": "embed",
+      "decisionReason": "The orchestration rules for composing with other skills are central to the imported workflow and should remain directly accessible.",
+      "destinationPath": "skills/engineering-assistant/references/skill-composition.md",
+      "reviewStatus": "accepted"
+    },
+    {
+      "artifactPath": "engineering-assistant/PROJECT_NOTES.md",
+      "artifactType": "notes",
+      "skillId": "engineering-assistant",
+      "existingProjectSurface": null,
+      "decision": "adapt",
+      "decisionReason": "The raw project-notes file is sample-pack state, but its structure should become reusable project-owned guidance for project memory discipline.",
+      "destinationPath": "skills/engineering-assistant/references/project-notes.md",
+      "reviewStatus": "accepted"
+    },
+    {
+      "artifactPath": "engineering-assistant/CHANGELOG.md",
+      "artifactType": "changelog",
+      "skillId": "engineering-assistant",
+      "existingProjectSurface": null,
+      "decision": "adapt",
+      "decisionReason": "The sample changelog should not ship as live package state, but its structured format belongs in project-owned change-discipline guidance.",
+      "destinationPath": "skills/engineering-assistant/references/change-discipline.md",
+      "reviewStatus": "accepted"
+    },
+    {
+      "artifactPath": "engineering-assistant/scripts/project_notes.py",
+      "artifactType": "script",
+      "skillId": "engineering-assistant",
+      "existingProjectSurface": null,
+      "decision": "adapt",
+      "decisionReason": "The helper script captures a useful deterministic update flow, but it needs later translation into package-owned runtime helpers and commands rather than shipping as an isolated Python script.",
+      "destinationPath": "docs/authoring/engineering-assistant-port.md",
+      "reviewStatus": "accepted"
+    },
+    {
+      "artifactPath": "engineering-assistant/scripts/change_log.py",
+      "artifactType": "script",
+      "skillId": "engineering-assistant",
+      "existingProjectSurface": null,
+      "decision": "adapt",
+      "decisionReason": "The helper script is valuable source material for reusable change-discipline commands, but the package should translate it into shared Harness Forge surfaces instead of preserving the pack-local implementation verbatim.",
+      "destinationPath": "docs/authoring/engineering-assistant-port.md",
+      "reviewStatus": "accepted"
+    },
+    {
+      "artifactPath": "engineering-assistant/agents/openai.yaml",
+      "artifactType": "metadata",
+      "skillId": "engineering-assistant",
+      "existingProjectSurface": null,
+      "decision": "translate",
+      "decisionReason": "The imported OpenAI-specific metadata needs to become cross-agent compatibility guidance rather than a runtime-specific source of truth.",
+      "destinationPath": "docs/authoring/engineering-assistant-port.md",
+      "reviewStatus": "accepted"
+    }
+  ],
+  "compatibilityProfiles": [
+    {
+      "targetId": "codex",
+      "supportLevel": "translated",
+      "metadataMode": "translated",
+      "hookMode": "manual",
+      "helperMode": "documentation-only",
+      "notes": "The MVP port ships the canonical skill and governance surfaces first. Codex discovery wrappers and packaged helper commands are planned in later tasks, so current support is documented rather than auto-discoverable.",
+      "currentSurfaces": [
+        "skills/engineering-assistant/SKILL.md",
+        "docs/authoring/engineering-assistant-port.md"
+      ]
+    },
+    {
+      "targetId": "claude-code",
+      "supportLevel": "translated",
+      "metadataMode": "translated",
+      "hookMode": "manual",
+      "helperMode": "documentation-only",
+      "notes": "Claude Code can consume the same canonical guidance, but the OpenAI-specific descriptor is intentionally translated into package-owned provenance and compatibility notes until wrapper rollout lands.",
+      "currentSurfaces": [
+        "skills/engineering-assistant/SKILL.md",
+        "docs/authoring/engineering-assistant-port.md"
+      ]
+    },
+    {
+      "targetId": "cursor",
+      "supportLevel": "guidance-only",
+      "metadataMode": "unsupported",
+      "hookMode": "documentation-only",
+      "helperMode": "documentation-only",
+      "notes": "Cursor parity is intentionally limited during the MVP slice. The package records fallback guidance instead of claiming a native engineering-assistant runtime surface.",
+      "currentSurfaces": [
+        "docs/authoring/engineering-assistant-port.md",
+        "docs/hooks/catalog.md"
+      ]
+    },
+    {
+      "targetId": "opencode",
+      "supportLevel": "guidance-only",
+      "metadataMode": "unsupported",
+      "hookMode": "documentation-only",
+      "helperMode": "documentation-only",
+      "notes": "OpenCode support remains guidance-first during the MVP slice. The import is governed and preserved without overstating runtime-native parity.",
+      "currentSurfaces": [
+        "docs/authoring/engineering-assistant-port.md",
+        "docs/hooks/catalog.md"
+      ]
+    }
+  ],
+  "helperSurfaces": [
+    {
+      "helperId": "engineering-assistant-project-notes",
+      "sourceArtifact": "engineering-assistant/scripts/project_notes.py",
+      "surfaceType": "documentation-plan",
+      "purpose": "Maintain a current project snapshot, open questions, glossary, and mini-ADR trail as part of the engineering-assistant workflow.",
+      "destinationPath": "skills/engineering-assistant/references/project-notes.md",
+      "targetCoverage": [
+        "codex",
+        "claude-code",
+        "cursor",
+        "opencode"
+      ],
+      "failureMode": "Until packaged helper commands land, update project notes manually using the canonical reference and port guidance."
+    },
+    {
+      "helperId": "engineering-assistant-change-discipline",
+      "sourceArtifact": "engineering-assistant/scripts/change_log.py",
+      "surfaceType": "documentation-plan",
+      "purpose": "Capture meaningful skill, script, and reference changes with a structured summary and touched-file list.",
+      "destinationPath": "skills/engineering-assistant/references/change-discipline.md",
+      "targetCoverage": [
+        "codex",
+        "claude-code",
+        "cursor",
+        "opencode"
+      ],
+      "failureMode": "Until packaged helper commands land, record the same fields manually using the canonical reference and port guidance."
+    }
+  ],
+  "portingRules": [
+    {
+      "ruleId": "preserve-one-canonical-owner",
+      "matchCriteria": "The imported pack defines a distinct engineering orchestration responsibility not already owned by another Harness Forge skill.",
+      "preferredOutcome": "embed",
+      "requiredFollowUps": [
+        "create the canonical skill under skills/",
+        "ship supporting references under the same skill directory",
+        "register the skill in catalogs and package surfaces"
+      ]
+    },
+    {
+      "ruleId": "translate-pack-state-into-guidance",
+      "matchCriteria": "The imported artifact is sample-pack state such as project notes or changelog entries rather than reusable runtime guidance.",
+      "preferredOutcome": "adapt",
+      "requiredFollowUps": [
+        "convert the structure into project-owned reference guidance",
+        "keep the original pack state described in maintainer provenance",
+        "avoid shipping stale sample data as live package state"
+      ]
+    },
+    {
+      "ruleId": "defer-runtime-specific-helpers-until-translated",
+      "matchCriteria": "The imported artifact is a helper script or agent-specific metadata file tied to one runtime model.",
+      "preferredOutcome": "translate",
+      "requiredFollowUps": [
+        "document the translation target in maintainer provenance",
+        "record fallback support modes for other runtimes",
+        "avoid claiming native parity before package-owned helpers exist"
+      ]
+    }
+  ]
+}

package/manifests/catalog/enhanced-skill-import-inventory.json

@@ -0,0 +1,402 @@
+{
+  "packId": "enhanced-skills-2026-03",
+  "sourceName": "Harness Forge Enhanced Skills Pack",
+  "sourceVersion": "2026-03-26-import",
+  "resourceRoots": [
+    "skills/",
+    ".agents/skills/",
+    "README.md",
+    "VALIDATION.md",
+    "RESEARCH-SOURCES.md"
+  ],
+  "summary": "Governed embedding record for the enhanced skills zip that deepened canonical operational, coordination, and language skill surfaces without creating a parallel runtime package.",
+  "validationScope": "The imported pack reported passing skill-depth and placeholder validation on the upgraded repo copy. Full release smoke remained host-repo dependent because the export environment still had unrelated upstream gaps.",
+  "researchScope": "The imported guidance drew on official docs and upstream repositories for ADRs, API governance, database migrations, worktrees, modernization, .NET, TypeScript, JavaScript, Lua, and repo-onboarding workflows.",
+  "entries": [
+    {
+      "resourcePath": "skills/repo-onboarding/SKILL.md",
+      "resourceType": "skill",
+      "skillId": "repo-onboarding",
+      "existingProjectSurface": "skills/repo-onboarding/SKILL.md",
+      "decision": "merge",
+      "decisionReason": "The pack adds richer onboarding triggers, ownership heuristics, and command discovery without changing the canonical responsibility.",
+      "destinationPath": "skills/repo-onboarding/SKILL.md",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": "skills/repo-onboarding/references/",
+      "resourceType": "reference",
+      "skillId": "repo-onboarding",
+      "existingProjectSurface": "skills/repo-onboarding/references/",
+      "decision": "merge",
+      "decisionReason": "The new checklist, archetype, and health-signal references deepen the existing onboarding surface.",
+      "destinationPath": "skills/repo-onboarding/references/",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": ".agents/skills/repo-onboarding/SKILL.md",
+      "resourceType": "wrapper",
+      "skillId": "repo-onboarding",
+      "existingProjectSurface": ".agents/skills/repo-onboarding/SKILL.md",
+      "decision": "merge",
+      "decisionReason": "Wrapper alignment is planned against the upgraded canonical skill and tracked here so discovery drift stays explicit.",
+      "destinationPath": ".agents/skills/repo-onboarding/SKILL.md",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": "skills/architecture-decision-records/SKILL.md",
+      "resourceType": "skill",
+      "skillId": "architecture-decision-records",
+      "existingProjectSurface": "skills/architecture-decision-records/SKILL.md",
+      "decision": "merge",
+      "decisionReason": "The pack keeps the same ADR responsibility while adding stronger decision framing, supersession, and anti-pattern guidance.",
+      "destinationPath": "skills/architecture-decision-records/SKILL.md",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": "skills/architecture-decision-records/references/",
+      "resourceType": "reference",
+      "skillId": "architecture-decision-records",
+      "existingProjectSurface": "skills/architecture-decision-records/references/",
+      "decision": "merge",
+      "decisionReason": "The imported rubric, MADR guidance, and examples materially deepen the canonical ADR surface.",
+      "destinationPath": "skills/architecture-decision-records/references/",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": ".agents/skills/architecture-decision-records/SKILL.md",
+      "resourceType": "wrapper",
+      "skillId": "architecture-decision-records",
+      "existingProjectSurface": ".agents/skills/architecture-decision-records/SKILL.md",
+      "decision": "merge",
+      "decisionReason": "The wrapper remains the discovery entrypoint and will be aligned in the follow-on discovery phase.",
+      "destinationPath": ".agents/skills/architecture-decision-records/SKILL.md",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": "skills/api-contract-review/SKILL.md",
+      "resourceType": "skill",
+      "skillId": "api-contract-review",
+      "existingProjectSurface": "skills/api-contract-review/SKILL.md",
+      "decision": "merge",
+      "decisionReason": "The canonical API-review skill already existed; the import upgrades it with protocol-aware review depth and consumer-safety outputs.",
+      "destinationPath": "skills/api-contract-review/SKILL.md",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": "skills/api-contract-review/references/",
+      "resourceType": "reference",
+      "skillId": "api-contract-review",
+      "existingProjectSurface": "skills/api-contract-review/references/",
+      "decision": "merge",
+      "decisionReason": "The imported checklists, compatibility notes, and review template are runtime-facing guidance for the existing skill.",
+      "destinationPath": "skills/api-contract-review/references/",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": ".agents/skills/api-contract-review/SKILL.md",
+      "resourceType": "wrapper",
+      "skillId": "api-contract-review",
+      "existingProjectSurface": null,
+      "decision": "merge",
+      "decisionReason": "The imported wrapper should become the project discovery surface, but wrapper rollout is tracked separately from canonical MVP embedding.",
+      "destinationPath": ".agents/skills/api-contract-review/SKILL.md",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": "skills/db-migration-review/SKILL.md",
+      "resourceType": "skill",
+      "skillId": "db-migration-review",
+      "existingProjectSurface": "skills/db-migration-review/SKILL.md",
+      "decision": "merge",
+      "decisionReason": "The existing migration-review skill keeps ownership while absorbing expand-and-contract, engine-hotspot, and rollout guidance.",
+      "destinationPath": "skills/db-migration-review/SKILL.md",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": "skills/db-migration-review/references/",
+      "resourceType": "reference",
+      "skillId": "db-migration-review",
+      "existingProjectSurface": "skills/db-migration-review/references/",
+      "decision": "merge",
+      "decisionReason": "The imported risk taxonomy, rollout notes, and review template are first-class supporting references for the canonical skill.",
+      "destinationPath": "skills/db-migration-review/references/",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": ".agents/skills/db-migration-review/SKILL.md",
+      "resourceType": "wrapper",
+      "skillId": "db-migration-review",
+      "existingProjectSurface": null,
+      "decision": "merge",
+      "decisionReason": "The wrapper is reserved for the discovery-alignment phase so the new workload skill can be surfaced cleanly to agents.",
+      "destinationPath": ".agents/skills/db-migration-review/SKILL.md",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": "skills/parallel-worktree-supervisor/SKILL.md",
+      "resourceType": "skill",
+      "skillId": "parallel-worktree-supervisor",
+      "existingProjectSurface": "skills/parallel-worktree-supervisor/SKILL.md",
+      "decision": "merge",
+      "decisionReason": "Harness Forge already owned the skill identity, and the import turns the placeholder into a production-grade supervision contract.",
+      "destinationPath": "skills/parallel-worktree-supervisor/SKILL.md",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": "skills/parallel-worktree-supervisor/references/",
+      "resourceType": "reference",
+      "skillId": "parallel-worktree-supervisor",
+      "existingProjectSurface": "skills/parallel-worktree-supervisor/references/",
+      "decision": "merge",
+      "decisionReason": "The task sharding, stacked-diff, merge-readiness, and worktree-operation references are runtime-facing supervision knowledge.",
+      "destinationPath": "skills/parallel-worktree-supervisor/references/",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": ".agents/skills/parallel-worktree-supervisor/SKILL.md",
+      "resourceType": "wrapper",
+      "skillId": "parallel-worktree-supervisor",
+      "existingProjectSurface": null,
+      "decision": "merge",
+      "decisionReason": "A new wrapper is appropriate, but the wrapper rollout is tracked separately from the canonical skill merge.",
+      "destinationPath": ".agents/skills/parallel-worktree-supervisor/SKILL.md",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": "skills/repo-modernization/SKILL.md",
+      "resourceType": "skill",
+      "skillId": "repo-modernization",
+      "existingProjectSurface": "skills/repo-modernization/SKILL.md",
+      "decision": "merge",
+      "decisionReason": "The imported roadmap and seam-first modernization guidance enrich the existing project-owned skill.",
+      "destinationPath": "skills/repo-modernization/SKILL.md",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": "skills/repo-modernization/references/",
+      "resourceType": "reference",
+      "skillId": "repo-modernization",
+      "existingProjectSurface": "skills/repo-modernization/references/",
+      "decision": "merge",
+      "decisionReason": "The imported modernization layers, safety rails, automation candidates, and roadmap template are reusable runtime-facing references.",
+      "destinationPath": "skills/repo-modernization/references/",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": ".agents/skills/repo-modernization/SKILL.md",
+      "resourceType": "wrapper",
+      "skillId": "repo-modernization",
+      "existingProjectSurface": null,
+      "decision": "merge",
+      "decisionReason": "The import introduces a missing discovery wrapper and keeps the future agent entrypoint explicit in the inventory.",
+      "destinationPath": ".agents/skills/repo-modernization/SKILL.md",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": "skills/typescript-engineering/SKILL.md",
+      "resourceType": "skill",
+      "skillId": "typescript-engineering",
+      "existingProjectSurface": "skills/typescript-engineering/SKILL.md",
+      "decision": "merge",
+      "decisionReason": "The seeded TypeScript skill keeps ownership while absorbing stronger activation, validation, and workspace-boundary guidance.",
+      "destinationPath": "skills/typescript-engineering/SKILL.md",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": "skills/typescript-engineering/references/",
+      "resourceType": "reference",
+      "skillId": "typescript-engineering",
+      "existingProjectSurface": "skills/typescript-engineering/references/",
+      "decision": "merge",
+      "decisionReason": "The import adds runtime-validation and monorepo references to the existing engineering pack.",
+      "destinationPath": "skills/typescript-engineering/references/",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": ".agents/skills/typescript-engineering/SKILL.md",
+      "resourceType": "wrapper",
+      "skillId": "typescript-engineering",
+      "existingProjectSurface": ".agents/skills/typescript-engineering/SKILL.md",
+      "decision": "merge",
+      "decisionReason": "The wrapper remains the auto-discovery entrypoint and will be aligned to the upgraded language contract later in the feature.",
+      "destinationPath": ".agents/skills/typescript-engineering/SKILL.md",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": "skills/dotnet-engineering/SKILL.md",
+      "resourceType": "skill",
+      "skillId": "dotnet-engineering",
+      "existingProjectSurface": "skills/dotnet-engineering/SKILL.md",
+      "decision": "merge",
+      "decisionReason": "The seeded .NET skill already existed and now absorbs stronger solution-graph, DI, migration, and hosting guidance.",
+      "destinationPath": "skills/dotnet-engineering/SKILL.md",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": "skills/dotnet-engineering/references/",
+      "resourceType": "reference",
+      "skillId": "dotnet-engineering",
+      "existingProjectSurface": "skills/dotnet-engineering/references/",
+      "decision": "merge",
+      "decisionReason": "The import adds cloud-native and Aspire coverage plus richer supporting heuristics to the current reference pack.",
+      "destinationPath": "skills/dotnet-engineering/references/",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": ".agents/skills/dotnet-engineering/SKILL.md",
+      "resourceType": "wrapper",
+      "skillId": "dotnet-engineering",
+      "existingProjectSurface": ".agents/skills/dotnet-engineering/SKILL.md",
+      "decision": "merge",
+      "decisionReason": "The wrapper stays as the entrypoint and is tracked for later alignment with the deeper canonical skill.",
+      "destinationPath": ".agents/skills/dotnet-engineering/SKILL.md",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": "skills/lua-engineering/SKILL.md",
+      "resourceType": "skill",
+      "skillId": "lua-engineering",
+      "existingProjectSurface": "skills/lua-engineering/SKILL.md",
+      "decision": "merge",
+      "decisionReason": "The seeded Lua skill keeps ownership while the import adds runtime-flavor, editor, OpenResty, and tooling guidance.",
+      "destinationPath": "skills/lua-engineering/SKILL.md",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": "skills/lua-engineering/references/",
+      "resourceType": "reference",
+      "skillId": "lua-engineering",
+      "existingProjectSurface": "skills/lua-engineering/references/",
+      "decision": "merge",
+      "decisionReason": "The imported runtime profiles, editor patterns, OpenResty notes, and tooling guidance deepen the existing language pack.",
+      "destinationPath": "skills/lua-engineering/references/",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": ".agents/skills/lua-engineering/SKILL.md",
+      "resourceType": "wrapper",
+      "skillId": "lua-engineering",
+      "existingProjectSurface": ".agents/skills/lua-engineering/SKILL.md",
+      "decision": "merge",
+      "decisionReason": "The wrapper remains a discovery surface and is tracked for later alignment to the upgraded skill contract.",
+      "destinationPath": ".agents/skills/lua-engineering/SKILL.md",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": "skills/javascript-engineering/SKILL.md",
+      "resourceType": "skill",
+      "skillId": "javascript-engineering",
+      "existingProjectSurface": "skills/javascript-engineering/SKILL.md",
+      "decision": "promote",
+      "decisionReason": "JavaScript engineering is a distinct runtime-focused responsibility that already exists in Harness Forge and is now promoted with deeper contracts and packaging guidance.",
+      "destinationPath": "skills/javascript-engineering/SKILL.md",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": "skills/javascript-engineering/references/",
+      "resourceType": "reference",
+      "skillId": "javascript-engineering",
+      "existingProjectSurface": "skills/javascript-engineering/references/",
+      "decision": "merge",
+      "decisionReason": "The imported browser, bundler, and package-contract references deepen the promoted JavaScript skill.",
+      "destinationPath": "skills/javascript-engineering/references/",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": ".agents/skills/javascript-engineering/SKILL.md",
+      "resourceType": "wrapper",
+      "skillId": "javascript-engineering",
+      "existingProjectSurface": ".agents/skills/javascript-engineering/SKILL.md",
+      "decision": "merge",
+      "decisionReason": "The wrapper exists today and will be aligned in the discovery phase so agents see the richer JS contract.",
+      "destinationPath": ".agents/skills/javascript-engineering/SKILL.md",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": "README.md",
+      "resourceType": "provenance",
+      "skillId": null,
+      "existingProjectSurface": null,
+      "decision": "provenance-only",
+      "decisionReason": "The pack README documents the source bundle contents and intent but should not ship as a second front door.",
+      "destinationPath": "docs/authoring/enhanced-skill-import.md",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": "VALIDATION.md",
+      "resourceType": "provenance",
+      "skillId": null,
+      "existingProjectSurface": null,
+      "decision": "provenance-only",
+      "decisionReason": "Pack-local validation context matters for maintainers, but the project keeps release truth in its own validation surfaces.",
+      "destinationPath": "VALIDATION.md",
+      "reviewStatus": "accepted"
+    },
+    {
+      "resourcePath": "RESEARCH-SOURCES.md",
+      "resourceType": "provenance",
+      "skillId": null,
+      "existingProjectSurface": null,
+      "decision": "provenance-only",
+      "decisionReason": "The research summary informs maintainers and future imports, but runtime agents should rely on the canonical project-owned skills instead.",
+      "destinationPath": "RESEARCH-SOURCES.md",
+      "reviewStatus": "accepted"
+    }
+  ],
+  "embeddingRules": [
+    {
+      "ruleId": "merge-overlapping-skill-identities",
+      "matchCriteria": "An imported skill has the same responsibility as an existing canonical Harness Forge skill.",
+      "preferredOutcome": "merge",
+      "requiredFollowUps": [
+        "merge canonical SKILL.md guidance",
+        "merge or extend references/",
+        "record the decision in the inventory",
+        "validate section depth and reference paths"
+      ],
+      "exceptions": [
+        "Promote instead when the imported responsibility is distinct enough to deserve a first-class skill identity."
+      ]
+    },
+    {
+      "ruleId": "promote-runtime-distinct-skills",
+      "matchCriteria": "An imported runtime-facing skill fills a distinct responsibility that should be discoverable in the packaged skill catalog.",
+      "preferredOutcome": "promote",
+      "requiredFollowUps": [
+        "create or update the canonical skill directory",
+        "preserve supporting references",
+        "reflect the skill in catalogs and discovery docs"
+      ],
+      "exceptions": [
+        "Do not promote when the content is just a narrower variant of an existing project-owned responsibility."
+      ]
+    },
+    {
+      "ruleId": "track-wrapper-rollout-explicitly",
+      "matchCriteria": "An imported wrapper changes or introduces an auto-discovery surface under .agents/skills/.",
+      "preferredOutcome": "merge",
+      "requiredFollowUps": [
+        "record the wrapper destination in the inventory",
+        "align wrapper wording to the canonical skill",
+        "validate that the wrapper points at the active canonical surface"
+      ],
+      "exceptions": [
+        "Wrapper execution may be staged after canonical skill embedding, but pending rollout must stay explicit."
+      ]
+    },
+    {
+      "ruleId": "keep-provenance-maintainer-facing",
+      "matchCriteria": "Imported materials describe pack intent, research, or validation rather than runtime guidance.",
+      "preferredOutcome": "provenance-only",
+      "requiredFollowUps": [
+        "summarize the material in maintainer documentation",
+        "keep runtime-facing skills separate from provenance",
+        "reference the inventory rather than shipping a parallel package root"
+      ],
+      "exceptions": [
+        "Runtime guidance that directly improves an active canonical skill belongs in skills/ or references/ instead."
+      ]
+    }
+  ]
+}