create-agdf 0.13.8 → 0.14.1

package/lib/lifecycle/status.js

@@ -63,7 +63,7 @@ function inspectInstallation(surface, targetDir, options, deps, exec) {
       evidence: [report.global_config.path],
     };
   }
-  if (["codex", "claude"].includes(surface)) return deps.inspectPluginSurface(surface, exec);
+  if (["codex", "claude", "copilot"].includes(surface)) return deps.inspectPluginSurface(surface, exec);
   return { status: "unknown", surface, version: null, evidence: [`unsupported_status_probe:${surface}`] };
 }
 
@@ -79,7 +79,7 @@ export function evaluateGeneralStatus(targetDir, options = {}, dependencies = {}
   if (surface) {
     installation = inspectInstallation(surface, targetDir, options, deps, dependencies.exec);
   } else {
-    const probes = ["codex", "claude", "opencode"].map((candidate) => inspectInstallation(candidate, targetDir, options, deps, dependencies.exec));
+    const probes = ["codex", "claude", "copilot", "opencode"].map((candidate) => inspectInstallation(candidate, targetDir, options, deps, dependencies.exec));
     const observed = probes.filter((probe) => ["healthy", "degraded"].includes(probe.status));
     if (observed.length === 1) {
       installation = observed[0];
@@ -96,7 +96,7 @@ export function evaluateGeneralStatus(targetDir, options = {}, dependencies = {}
   }
   const repository = repositoryStatus(targetDir, surface);
   const delivery = deliveryStatus(targetDir, { runId: options.runId }, deps);
-  const runtimeChecks = ["codex", "claude", "opencode"].includes(surface)
+  const runtimeChecks = ["codex", "claude", "copilot", "opencode"].includes(surface)
     ? runtimeCheckStatus(options.dataRoot, surface)
     : { requested: "unknown", effective: "unavailable", reason: "unsupported_host_capability" };
   const nextText = surface === "multiple"

package/lib/public-plugin/manifest.js

@@ -39,14 +39,12 @@ export function createCodexPluginManifest(definition, { publicCandidate = false
       websiteURL: distribution.urls.website,
       privacyPolicyURL: distribution.urls.privacy,
       termsOfServiceURL: distribution.urls.terms,
-      supportURL: distribution.urls.support,
       composerIcon: definition.codex.composerIcon,
       logo: definition.codex.logo,
       defaultPrompt: pluginInterface.defaultPrompt,
       brandColor: definition.brandColor,
     },
   };
-  if (!publicCandidate) manifest.hooks = `./${definition.codex.hooks}`;
   return manifest;
 }
 
@@ -70,3 +68,37 @@ export function createClaudePluginManifest(definition) {
 export function renderClaudePluginManifest(definition) {
   return `${JSON.stringify(createClaudePluginManifest(definition), null, 2)}\n`;
 }
+
+function requireCopilotPath(value, field) {
+  if (typeof value !== "string" || !value || value.startsWith("/") || value.includes("..") || value.includes("\\")) {
+    throw new Error(`AGDF_COPILOT_PLUGIN_CONTRACT_INVALID: ${field} must be a relative POSIX path`);
+  }
+  return value;
+}
+
+export function createCopilotPluginManifest(definition) {
+  if (!/^[a-z0-9]+(?:-[a-z0-9]+)*$/.test(definition.id ?? "") || definition.id.length > 64) {
+    throw new Error("AGDF_COPILOT_PLUGIN_CONTRACT_INVALID: kebab-case name is required");
+  }
+  if (!/^\d+\.\d+\.\d+(?:-[0-9A-Za-z.-]+)?$/.test(definition.version ?? "")) {
+    throw new Error("AGDF_COPILOT_PLUGIN_CONTRACT_INVALID: semantic version is required");
+  }
+  const copilot = definition.copilot ?? {};
+  return {
+    name: definition.id,
+    version: definition.version,
+    description: definition.description,
+    author: definition.author,
+    homepage: definition.homepage,
+    repository: definition.repository,
+    license: definition.license,
+    keywords: definition.keywords,
+    category: definition.category,
+    skills: requireCopilotPath(copilot.skills, "skills"),
+    hooks: requireCopilotPath(copilot.hooks, "hooks"),
+  };
+}
+
+export function renderCopilotPluginManifest(definition) {
+  return `${JSON.stringify(createCopilotPluginManifest(definition), null, 2)}\n`;
+}

package/lib/public-plugin/validator.js

@@ -80,7 +80,7 @@ export function validateCandidate(root) {
   if (unicodeLength(manifest.interface?.developerName) > LISTING_LIMITS.developerName) throw new Error("AGDF_PUBLIC_PLUGIN_LISTING_LIMIT_EXCEEDED: developerName");
   const prompts = manifest.interface?.defaultPrompt ?? [];
   if (prompts.length !== LISTING_LIMITS.promptCount || prompts.some((prompt) => unicodeLength(prompt) > LISTING_LIMITS.promptLength)) throw new Error("AGDF_PUBLIC_PLUGIN_LISTING_LIMIT_EXCEEDED: defaultPrompt");
-  for (const field of ["websiteURL", "privacyPolicyURL", "termsOfServiceURL", "supportURL"]) {
+  for (const field of ["websiteURL", "privacyPolicyURL", "termsOfServiceURL"]) {
     let url;
     try { url = new URL(manifest.interface?.[field]); } catch { throw new Error(`AGDF_PUBLIC_PLUGIN_CONTRACT_INVALID: ${field}`); }
     if (url.protocol !== "https:") throw new Error(`AGDF_PUBLIC_PLUGIN_CONTRACT_INVALID: ${field} must use HTTPS`);

package/lib/release/version-coherence.js

@@ -32,6 +32,7 @@ const VERSION_SURFACES = [
   jsonVersion("create-agdf/generated/plugins/agdf/meta/agdf-plugin.definition.json"),
   jsonVersion("create-agdf/generated/plugins/agdf/.codex-plugin/plugin.json"),
   jsonVersion("create-agdf/generated/plugins/agdf/.claude-plugin/plugin.json"),
+  jsonVersion("create-agdf/generated/plugins/agdf/plugin.json"),
   jsonVersion("create-agdf/generated/plugins/agdf/runtime/runtime-manifest.json"),
   jsonVersion("create-agdf/generated/plugins/agdf/runtime/create-agdf/package.json"),
   jsonVersion("create-agdf/generated/submissions/openai/agdf/meta/agdf-plugin.definition.json"),

package/lib/runtime-check-consent/contract.js

@@ -32,6 +32,7 @@ export function validateRuntimeCheckCapability(capability) {
   }
   const surfaces = capability.surfaces ?? {};
   if (surfaces.codex !== "native-hook-review" || surfaces.claude !== "exact-command-rule"
+      || surfaces.copilot !== "plugin-hook-review"
       || surfaces.opencode !== "plugin-internal"
       || surfaces["portable-skills"] !== "manual-external-required") {
     throw new Error("AGDF_RUNTIME_CHECK_CAPABILITY_INVALID: surface contract");
@@ -41,7 +42,7 @@ export function validateRuntimeCheckCapability(capability) {
 
 export function runtimeCheckCapabilityIdentity({ capability, surface, runtimeDigest, sourceDigest, command }) {
   validateRuntimeCheckCapability(capability);
-  if (!["codex", "claude", "opencode"].includes(surface)) throw new Error("AGDF_RUNTIME_CHECK_SURFACE_INVALID");
+  if (!["codex", "claude", "copilot", "opencode"].includes(surface)) throw new Error("AGDF_RUNTIME_CHECK_SURFACE_INVALID");
   for (const [name, value] of Object.entries({ runtimeDigest, sourceDigest })) {
     if (typeof value !== "string" || !/^[a-f0-9]{64}$/.test(value)) throw new Error(`AGDF_RUNTIME_CHECK_IDENTITY_INVALID: ${name}`);
   }
@@ -59,6 +60,7 @@ export function runtimeCheckCapabilityIdentity({ capability, surface, runtimeDig
 
 export function fixedRuntimeCheckCommand(surface, pluginRoot, platform = process.platform) {
   if (surface === "opencode") return "plugin:agdf:automatic-runtime-checks";
+  if (surface === "copilot") return 'node "${PLUGIN_ROOT}/runtime/agdf-session-check.js"';
   if (surface === "codex" || surface === "claude") {
     return platform === "win32"
       ? "node \"$([Environment]::GetEnvironmentVariable('PLUGIN_ROOT') + [Environment]::GetEnvironmentVariable('CLAUDE_PLUGIN_ROOT'))\\runtime\\agdf-session-check.js\""

package/lib/runtime-check-consent/coordinator.js

@@ -18,6 +18,7 @@ export function resolveRuntimeCheckDecision({ explicitValue, interactive = false
 export function consentDisclosure(surface) {
   const permissionOwner = surface === "codex" ? "Codex native hook trust"
     : surface === "claude" ? "Claude Code user permission settings"
+    : surface === "copilot" ? "GitHub Copilot plugin hook review"
     : "OpenCode plugin and explicit permission configuration";
   return Object.freeze({
     surface,

package/lib/runtime-check-consent/service.js

@@ -35,7 +35,7 @@ function prospectiveRuntimeCheckIdentity(surface, platform = process.platform) {
       command: fixedRuntimeCheckCommand(surface, installed.root, platform),
     });
   }
-  if (!["codex", "claude"].includes(surface)) return null;
+  if (!["codex", "claude", "copilot"].includes(surface)) return null;
   const pluginRoot = join(generatedRoot, "plugins", "agdf");
   let runtimeManifest;
   try { runtimeManifest = JSON.parse(readFileSync(join(pluginRoot, "runtime", "runtime-manifest.json"), "utf8")); } catch { return null; }

package/lib/runtime-check-consent/state.js

@@ -4,12 +4,12 @@ import { dirname, join, resolve } from "node:path";
 import { renameSyncWithRetry } from "../fs-swap.js";
 
 export function runtimeCheckReceiptPath(dataRoot, surface) {
-  if (!["codex", "claude", "opencode"].includes(surface)) throw new Error("AGDF_RUNTIME_CHECK_RECEIPT_SURFACE_INVALID");
+  if (!["codex", "claude", "copilot", "opencode"].includes(surface)) throw new Error("AGDF_RUNTIME_CHECK_RECEIPT_SURFACE_INVALID");
   return join(resolve(dataRoot), "runtime-checks", `${surface}.json`);
 }
 
 export function createRuntimeCheckReceipt({ surface, decision, capabilityIdentity, command }) {
-  if (!["codex", "claude", "opencode"].includes(surface)) throw new Error("AGDF_RUNTIME_CHECK_RECEIPT_SURFACE_INVALID");
+  if (!["codex", "claude", "copilot", "opencode"].includes(surface)) throw new Error("AGDF_RUNTIME_CHECK_RECEIPT_SURFACE_INVALID");
   if (!["enable", "manual"].includes(decision)) throw new Error("AGDF_RUNTIME_CHECK_RECEIPT_DECISION_INVALID");
   if (!/^[a-f0-9]{64}$/.test(capabilityIdentity)) throw new Error("AGDF_RUNTIME_CHECK_RECEIPT_IDENTITY_INVALID");
   return Object.freeze({
@@ -26,7 +26,7 @@ export function createRuntimeCheckReceipt({ surface, decision, capabilityIdentit
 export function validateRuntimeCheckReceipt(receipt) {
   if (receipt?.schema_version !== 1 || receipt.owner !== "create-agdf"
       || receipt.capability_id !== "automatic-runtime-checks") return { status: "receipt_unowned", receipt: null };
-  if (!["codex", "claude", "opencode"].includes(receipt.surface)
+  if (!["codex", "claude", "copilot", "opencode"].includes(receipt.surface)
       || !["enabled", "manual"].includes(receipt.requested_state)
       || !/^[a-f0-9]{64}$/.test(receipt.capability_identity)
       || typeof receipt.command !== "string" || !receipt.command.trim()) {

package/lib/scaffold/plan.js

@@ -1,11 +1,9 @@
-import { existsSync, readFileSync } from "node:fs";
+import { readFileSync } from "node:fs";
 import { join } from "node:path";
 import { generatedRoot, languageConfigContent, pluginDefinition } from "../cli/runtime-context.js";
 export { doctorRequiredFiles } from "../control-evaluation/required-files.js";
 
-export const agdfFragmentPath = "AGENTS.agdf.md";
 const codexSkillNames = pluginDefinition.skillSet.map((skill) => `${pluginDefinition.codex.skillPrefix}${skill.slug}`);
-const copilotSkillNames = pluginDefinition.skillSet.map((skill) => `${pluginDefinition.copilot.skillPrefix}${skill.slug}`);
 const globalOpenCodeSkillNames = pluginDefinition.skillSet.map((skill) => `${pluginDefinition.opencode.globalSkillPrefix}${skill.slug}`);
 const contractModules = [
   "gate-transition.md",
@@ -96,63 +94,11 @@ const artefactTemplateFiles = [
   join(".agdf", "control", "templates", "artefacts", "QA_REPORT.md"),
   join(".agdf", "control", "templates", "artefacts", "OR.md"),
 ];
-const copilotInstructionFiles = [
-  join(".github", "copilot-instructions.md"),
-  join(".github", "instructions", "agdf-governance.instructions.md"),
-];
-const copilotSkillFiles = [
-  join(".github", "skills", "README.md"),
-  join(".github", "skills", pluginDefinition.copilot.runtimeContractFileName),
-  ...contractModules.map((moduleName) => join(".github", "skills", "contracts", moduleName)),
-  ...copilotSkillNames.map((skillName) => join(".github", "skills", skillName, "SKILL.md")),
-];
 
 function loadAsset(relativePath) {
   return readFileSync(join(generatedRoot, relativePath), "utf8");
 }
 
-function isAgdfOwnedAgentsFile(content) {
-  return content.includes("## Surface Convention")
-    && content.includes("GitHub Copilot repository skills do not have a plugin namespace")
-    && content.includes("AGDF is agent-native first and CLI-verifiable by design");
-}
-
-function addCopilotAgentsFile(files, targetDir, force) {
-  const agentsPath = join(targetDir, "AGENTS.md");
-  if (!existsSync(agentsPath) || force) {
-    files.push({
-      path: "AGENTS.md",
-      content: loadAsset("AGENTS.md"),
-    });
-    return;
-  }
-
-  const existingAgents = readFileSync(agentsPath, "utf8");
-  if (isAgdfOwnedAgentsFile(existingAgents)) {
-    files.push({
-      path: "AGENTS.md",
-      content: loadAsset("AGENTS.md"),
-      allowOverwrite: true,
-      action: "refreshed",
-    });
-    return;
-  }
-
-  files.push({
-    path: agdfFragmentPath,
-    content: loadAsset("AGENTS.md"),
-    allowOverwrite: true,
-    action: "refreshed",
-    preserved: "AGENTS.md",
-  });
-}
-
-function shouldWriteLanguageConfig(target, targetDir, force) {
-  if (force) return true;
-  if ((target === "copilot" || target === "both") && existsSync(join(targetDir, ".agdf", "control", "config.json"))) return false;
-  return true;
-}
-
 function addLanguageConfig(files, languagePreference) {
   files.push({
     path: join(".agdf", "control", "config.json"),
@@ -196,8 +142,8 @@ export function generatedFilesForTarget(target, targetDir, force, languagePrefer
     return files;
   }
 
-  if (target === "codex-repo" || target === "both") {
-    if (shouldWriteLanguageConfig(target, targetDir, force)) addLanguageConfig(files, languagePreference);
+  if (target === "codex-repo") {
+    addLanguageConfig(files, languagePreference);
     for (const codexPath of codexPluginFiles) {
       files.push({
         path: codexPath,
@@ -206,38 +152,6 @@ export function generatedFilesForTarget(target, targetDir, force, languagePrefer
     }
   }
 
-  if (target === "copilot" || target === "both") {
-    if (target !== "both" && shouldWriteLanguageConfig(target, targetDir, force)) addLanguageConfig(files, languagePreference);
-    addCopilotAgentsFile(files, targetDir, force);
-
-    for (const controlPath of controlFiles) {
-      files.push({
-        path: controlPath,
-        content: loadAsset(controlPath),
-        allowOverwrite: true,
-        action: "refreshed",
-      });
-    }
-
-    for (const instructionPath of copilotInstructionFiles) {
-      files.push({
-        path: instructionPath,
-        content: loadAsset(instructionPath),
-        allowOverwrite: true,
-        action: "refreshed",
-      });
-    }
-
-    for (const skillPath of copilotSkillFiles) {
-      files.push({
-        path: skillPath,
-        content: loadAsset(skillPath),
-        allowOverwrite: true,
-        action: "refreshed",
-      });
-    }
-  }
-
   if (target === "opencode-repo") {
     addLanguageConfig(files, languagePreference);
     for (const controlPath of controlFiles) {

package/lib/scaffold/presentation.js

@@ -3,12 +3,9 @@ import { join } from "node:path";
 import { pluginDefinition } from "../cli/runtime-context.js";
 import { printLifecycleResult } from "../lifecycle/presentation.js";
 import { createLifecycleResult } from "../lifecycle/result.js";
-import { agdfFragmentPath } from "./plan.js";
 
-const pluginInstallCommand = "npx --yes @agdf/cli@latest claude";
-
-export function printNextSteps(target, destination, files, wroteAgentsFragment, removedOpenCodeAgents = [], { verbose = false, json = false, io = console } = {}) {
-  const repositorySurface = { "codex-repo": "codex", "opencode-repo": "opencode", copilot: "copilot" }[target];
+export function printNextSteps(target, destination, files, removedOpenCodeAgents = [], { verbose = false, json = false, io = console } = {}) {
+  const repositorySurface = { "codex-repo": "codex", "opencode-repo": "opencode" }[target];
   const verified = files.every((file) => {
     const path = join(destination, file.path);
     return existsSync(path) && readFileSync(path, "utf8") === file.content;
@@ -16,9 +13,7 @@ export function printNextSteps(target, destination, files, wroteAgentsFragment,
   if (repositorySurface) {
     const nextAction = repositorySurface === "codex"
       ? "Restart Codex, open /plugins, select This repository and install agdf; then start a new task with: Run an AGDF gate check for this request."
-      : repositorySurface === "opencode"
-        ? "Restart OpenCode in this repository so the global AGDF plugin observes the durable control configuration."
-        : "Run /instructions in GitHub Copilot CLI to confirm that the generated AGDF repository instructions are visible.";
+      : "Restart OpenCode in this repository so the global AGDF plugin observes the durable control configuration.";
     printLifecycleResult(createLifecycleResult({
       operation: "repository_setup",
       result: verified ? "success" : "partial",
@@ -79,25 +74,11 @@ export function printNextSteps(target, destination, files, wroteAgentsFragment,
     io.log("- Run the installed `agdf doctor` when this repository also uses durable AGDF control state.");
     return;
   }
-  if (wroteAgentsFragment) {
-    io.log(`- Existing AGENTS.md detected. Merge ${agdfFragmentPath} into your current AGENTS.md before using Copilot with AGDF.`);
-  }
-  if (target === "both") {
-    io.log("- Restart Codex in this repository, open /plugins, select This repository and install agdf.");
-    io.log("- Start a new Codex thread in this repository and ask: Run an AGDF gate check for this request.");
-  }
-  if (target === "both") {
-    io.log(`- Optional global Claude Code install: ${pluginInstallCommand}`);
-  }
   if (target === "opencode-repo") {
     io.log("- Install the global OpenCode surface once with npx --yes @agdf/cli@latest opencode if it is not already installed.");
     io.log("- Start or restart OpenCode in this repository; valid .agdf/control/config.json activates the global AGDF runtime here.");
     io.log("- Load agdf-global-gate-check through OpenCode's native skill tool for new build/change intent or unclear approval before later artefacts or implementation.");
     io.log("- Existing .opencode files are left untouched as a compatibility path; this command does not copy a second runtime surface.");
   }
-  if (target === "copilot" || target === "both") {
-    io.log("- In GitHub Copilot CLI, run /instructions after the AGENTS.md step is complete to confirm that AGDF instructions and the repository skills are visible.");
-    io.log("- Run npx --yes @agdf/cli@latest init when the repository needs live AGDF control files.");
-  }
   io.log("- Commit the generated files so the repository becomes the source of truth.");
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "create-agdf",
-  "version": "0.13.8",
-  "description": "Bootstrap AGDF repository-local plugin files, Copilot/OpenCode instructions, skills, control files and machine-readable checks.",
+  "version": "0.14.1",
+  "description": "Install AGDF plugins, bootstrap supported repository surfaces and validate durable governance state.",
   "type": "module",
   "files": [
     "bin",
@@ -24,6 +24,7 @@
     "build:public-plugin": "node ./scripts/build-public-plugin.js",
     "install:claude": "node ./scripts/install-local-plugin.js claude",
     "install:codex": "node ./scripts/install-local-plugin.js codex",
+    "install:copilot": "node ./scripts/install-local-plugin.js copilot",
     "install:opencode": "node ./scripts/install-local-plugin.js opencode",
     "test:release-version-coherence": "node ./scripts/release-version-coherence-test.js",
     "test:public-plugin": "node ./scripts/public-plugin-test.js",
@@ -40,6 +41,7 @@
     "test:package-contents": "node ./scripts/package-contents-test.js",
     "test:package-build": "node ./scripts/package-build-test.js",
     "test:lifecycle": "node ./scripts/lifecycle-test.js",
+    "test:copilot-repository-retention": "node ./scripts/copilot-repository-retention-test.js",
     "test:control-state": "node ./scripts/control-state-test.js",
     "test:parent-reconciliation": "node ./scripts/parent-reconciliation-test.js",
     "test:interaction-presentation": "node ./scripts/interaction-presentation-test.js",
@@ -55,7 +57,7 @@
     "test:proportionality": "node ./scripts/proportionality-benchmark-test.js",
     "test:release-bootstrap": "node ./scripts/release-bootstrap-smoke-test.js",
     "test:routing": "npm run sync-package-assets && node ./scripts/test-routing.js",
-    "smoke-test": "npm run release:prepare && npm run test:cli-modularization && npm run test:local-validator && npm run test:local-marketplace && npm run test:local-development-install && npm run test:package-build && npm run test:package-contents && npm run test:lifecycle && npm run test:control-state && npm run test:parent-reconciliation && npm run test:interaction-presentation && npm run test:verified-change && npm run test:runtime-integrity-layout && npm run test:runtime-integrity-negative && npm run test:agent-skills-conformance && npm run test:skill-evals && npm run eval:skills && npm run test:proportionality && npm run test:delivery-path-search && npm run test:delivery-path-search-unit && npm run test:delivery-path-search-generator && npm run test:opencode-hardening && node ./scripts/smoke-test.js && node ./scripts/test-routing.js",
+    "smoke-test": "npm run release:prepare && npm run test:cli-modularization && npm run test:local-validator && npm run test:local-marketplace && npm run test:local-development-install && npm run test:package-build && npm run test:package-contents && npm run test:lifecycle && npm run test:copilot-repository-retention && npm run test:control-state && npm run test:parent-reconciliation && npm run test:interaction-presentation && npm run test:verified-change && npm run test:runtime-integrity-layout && npm run test:runtime-integrity-negative && npm run test:agent-skills-conformance && npm run test:skill-evals && npm run eval:skills && npm run test:proportionality && npm run test:delivery-path-search && npm run test:delivery-path-search-unit && npm run test:delivery-path-search-generator && npm run test:opencode-hardening && node ./scripts/smoke-test.js && node ./scripts/test-routing.js",
     "prepack": "npm run release:prepare"
   },
   "keywords": [

package/generated/.github/copilot-instructions.md

@@ -1,16 +0,0 @@
-# AGDF Copilot instructions
-
-AGDF is active in this repository.
-
-- Treat `AGENTS.md` as the primary repository instruction source.
-- Use `.github/skills/` for AGDF task workflows instead of inventing parallel process rules.
-- Use `.agdf/control/` for durable run state, backlog pointers, source-of-truth ownership, Context Graph knowledge and quality contracts.
-- AGDF is agent-native first and CLI-verifiable by design.
-- Apply AGDF natively from `AGENTS.md`, repository skills and live `.agdf/control/` state before reaching for helper commands.
-- Before non-trivial implementation or formal delivery work, determine whether the request is a Quick Task or Structured Delivery.
-- If approval, evidence, ownership or the next allowed action is unclear, run the AGDF gate-check workflow before creating later artefacts or code.
-- Use `doctor --json`, `gate-check --json` or `delivery-map --json` as deterministic validators for CI, PR evidence, regression checks and audit trails, not as the primary workflow.
-- Do not infer gate approval from generic consent such as "ok", "go ahead", "do it", "continue", "leg los" or "approved".
-- Do not treat chat history as the source of truth for gate state, approvals, evidence or delivery status.
-- Do not paste full control files, templates or artefact bodies into chat unless the user explicitly asks for the full content; summarize and link paths instead.
-- For deterministic ready-gate rendering, prefer an installed `agdf gate-check --approval-envelope`; use `agdf gate-check --json` for native-adapter input, automation or audit evidence. Reserve `npx ...@latest` for bootstrap, installation, refresh or a missing local executable.

package/generated/.github/instructions/agdf-governance.instructions.md

@@ -1,14 +0,0 @@
----
-applyTo: "AGENTS.md,AGENTS.agdf.md,.agdf/**,.github/skills/**,.github/copilot-instructions.md,.github/instructions/**"
----
-
-# AGDF governance artefacts
-
-These files are control artefacts, not general documentation.
-
-- Keep AGDF rules sourced from `AGENTS.md`, `.github/skills/` and `.github/skills/agdf-runtime-contract.md`.
-- Do not duplicate the full gate model, Quality Contract table or Context Graph relationship language in new files.
-- Keep generated AGDF files small, reviewable and linked to the owning source of truth.
-- Preserve the rule that missing approval, missing evidence or unclear ownership blocks later delivery steps.
-- Preserve the rule that gates cannot be skipped by generic consent, urgency or a request to start.
-- If changing AGDF bootstrap behaviour, update the generated files, smoke test and affected setup documentation together.

package/generated/.github/skills/README.md

@@ -1,20 +0,0 @@
-# AGDF repository skills
-
-These repository skills were generated from the AGDF source repository and are intended to be checked into this repository.
-
-## Skills
-
-- `agdf-brownfield-analysis`
-- `agdf-clean-implementation-review`
-- `agdf-code-review`
-- `agdf-delivery-closeout`
-- `agdf-delivery-path-search`
-- `agdf-gate-check`
-- `agdf-qa-gate`
-- `agdf-release-or`
-- `agdf-task-plan-review`
-- `agdf-ux-intent-definition`
-
-## Runtime contract
-
-Shared output and gate rules for this checkout live in `agdf-runtime-contract.md`.

package/generated/AGENTS.md

@@ -1,113 +0,0 @@
-# AGENTS.md
-
-## Role
-You are an autonomous agent operating in an AGDF-governed delivery system.
-
-Use the plugin skills as workflow controls, not as documentation shortcuts.
-Your goal is trustworthy progress: reduce uncertainty, establish evidence, preserve artefacts, verify outcomes and make the next allowed step explicit.
-
-## Surface Convention
-GitHub Copilot repository skills do not have a plugin namespace.
-
-Therefore generated Copilot skill names use the AGDF prefix:
-
-- `agdf-delivery-path-search`
-- `agdf-brownfield-analysis`
-- `agdf-ux-intent-definition`
-- `agdf-clean-implementation-review`
-- `agdf-code-review`
-- `agdf-delivery-closeout`
-- `agdf-gate-check`
-- `agdf-qa-gate`
-- `agdf-release-or`
-- `agdf-task-plan-review`
-
-Do not remove that prefix in Copilot-facing repository skills.
-Codex and Claude Code plugin surfaces use the same canonical router with unprefixed skill names because their plugin namespace already carries `agdf`.
-## Mode Selection
-Default entry rule: a new user intent to build, add, change, extend, refactor or otherwise deliver something starts with `agdf-gate-check` unless it is clearly only a question, explanation, local inspection, or explicitly scoped review.
-
-Use Quick Task Mode for questions, small reviews, local debugging and narrow fixes without new product semantics. Use Verified Change only after approved UR and Brownfield Review when the Runtime Contract's compact record can prove bounded ownership, clean-at-baseline paths, prohibited-impact absence and deterministic validation.
-
-Use Structured Delivery Mode for new capabilities, architecture, policy, persistence, release-critical work, formal artefacts or explicit approvals.
-
-Any new product semantics, functional change or user-visible behaviour change requires a durable UR first.
-Persist it in `.agdf/control/` or link it from there to the target repository's authoritative source of truth before PRD, SD, TP, Brownfield Analysis or implementation.
-Treat approval text and durable artefact presence as separate checks for UR, PRD, SD, TP and QA report decisions.
-Do not infer approval from "ok", "go ahead", "do it", "approved", "continue", "leg los" or similar wording.
-Those phrases may express intent to proceed, but they do not unlock a gate unless the exact gate formula is present.
-Do not infer active scope from branch names, uncommitted workspace deltas, chat history or generated summaries when durable artefacts point elsewhere.
-If multiple active scopes are plausible, list the evidenced lines and route to `agdf-gate-check` or workstate clarification instead of choosing silently.
-After `Approval: UR`, run lightweight Brownfield Review before PRD when Brownfield, ownership, runtime, policy, persistence, architecture, UI or UX impact is possible.
-Brownfield Review must produce a Mode/Slice Decision: `quick_task`, `verified_change`, `structured_slice`, `structured_delivery` or `block`.
-That same review records the shared UI/UX impact classification. Run `agdf-ux-intent-definition` before
-PRD readiness for medium/high impact and for low impact with ambiguous mandatory PRD semantics. It is
-an internal analytical step, not a gate or product authority; a required blocked result keeps PRD
-readiness closed.
-Make that decision visible before coding or drafting later artefacts: state the selected path, scope reason, evidence and next required gate in the live control state or linked artefact.
-Do not assume the full PRD/SD/TP chain before that decision; use only as much gate depth as the reviewed change size justifies. A user-visible change is not automatically Verified Change eligible; any missing or ambiguous record condition escalates to the declared structured target before implementation.
-
-Quick Task Mode must still use the Runtime Contract mini-output: `result`, `evidence`, `risk`, `next_step`.
-Narrow defect work may use the Runtime Contract's Bug Lightweight Track only when a durable bug artefact or linked authoritative issue carries reproduction, actual behavior, expected behavior, fix boundary and evidence plan.
-Structured Delivery Mode must respect gates, reviews and closeout discipline.
-
-## Skill Routing
-| Skill | Use For | Boundary |
-|---|---|---|
-| `agdf-delivery-path-search` | high-impact planning decisions with several plausible next delivery steps before implementation | read-only advisory search; never grants gate permission or replaces gate-check |
-| `agdf-brownfield-analysis` | after gate-check permits Brownfield Review or implementation preparation, before non-trivial changes in existing systems | clarifies reuse, owners, risks and Mode/Slice Decision; never bypasses gate-check; Brownfield Review is not implementation permission |
-| `agdf-ux-intent-definition` | after approved UR and post-UR routing for medium/high UI/UX impact or ambiguous low-impact product semantics before PRD readiness | non-authorizing analytical PRD input; never creates product intent, gate permission, technical design or a parallel product source of truth |
-| `agdf-clean-implementation-review` | evidence dimension: inspect whether the solution is structurally clean | supports Quality Readiness; not a TP or QA substitute |
-| `agdf-code-review` | evidence dimension: review the actual diff for defects, regression and security findings | supports Quality Readiness; does not replace QA |
-| `agdf-delivery-closeout` | commit/PR-near handoff after QA/OR/UAT | never performs VCS actions automatically |
-| `agdf-gate-check` | new build/change intent, unclear approval, Structured Delivery, later-gate artefact requested | does not create later artefacts or skip Mode/Slice Decision after Brownfield Review |
-| `agdf-qa-gate` | sole final Quality Readiness decision | only instance for `pass | revise | block` |
-| `agdf-release-or` | auditable closeout for every relevant run | not a QA substitute |
-| `agdf-task-plan-review` | evidence dimension: verify whether the approved Task Plan was fulfilled | supports Quality Readiness; no final QA decision |
-
-Select exactly one primary skill first.
-Add more only when they cover a distinct concrete risk dimension.
-Do not choose `agdf-brownfield-analysis` as the first primary skill for a fresh "I want to build/change X" prompt unless `agdf-gate-check` or existing live AGDF control state already makes implementation preparation the next allowed action.
-Never jump directly from `Approval: UR`, implicit consent, or a generic "start" request to implementation. Route to Brownfield Review, then a visible Mode/Slice Decision with evidence, then the smallest safe next gate or Quick Task execution.
-
-## Runtime Contract
-For repeated output, gate, Quality Contract and Context Graph rules, use:
-
-- `contracts/task-target-resolution.md` for primary target authority before repository activation
-- `contracts/gate-transition.md` for gate terms, Brownfield routing and transition rules
-- `contracts/interaction.md` for status cards, approval orientation and native interaction
-- `contracts/modes.md` for delivery-mode boundaries
-- `contracts/quality.md` for quality and output discipline
-- `contracts/context-graph.md` for persistence and reconciliation
-- `contracts/control-scaffold.md` for run state, CLI verification and Delivery Map
-- `contracts/closeout.md` for relevant-run and closeout boundaries
-
-`agdf-runtime-contract.md` remains the compatibility manifest for these modules.
-
-Skills may include short reminders, but they must not carry a second complete rule or code table.
-
-## Durable Control State
-When the target repository uses the AGDF control scaffold, keep live control files under `.agdf/control/`.
-Use templates as starting points only.
-
-Do not let chat history become the source of truth for gate state, approvals, evidence, backlog status or durable Brownfield knowledge.
-
-AGDF is agent-native first and CLI-verifiable by design: read the live control state, apply the active skill and make the next allowed step explicit.
-Use `init` only when durable control state is explicitly requested, the repository already uses `.agdf/control/` as its live AGDF working state, or a deterministic CLI/CI setup path is being executed.
-Use `doctor --json`, `gate-check --json` or `delivery-map --json` as deterministic validators for CI, PR evidence, regression checks or audit trails, not as a substitute for the router or skills.
-At run closeout, route new durable knowledge explicitly as `context_graph`, `sot_registry`, `scope_artifact`, `open_questions` or `none`.
-
-## Closeout
-For Quick Task Mode, close with the Runtime Contract mini-output only:
-
-- `result`
-- `evidence`
-- `risk`
-- `next_step`
-
-For relevant runs that change durable state, code, artefacts or gate status:
-
-- run relevant checks or state the test gap
-- never commit, push or open a PR automatically
-- include exactly one `Next step:`
-- include exactly one `Quality outlook:`