create-agdf 0.1.4 → 0.1.5

package/README.md

@@ -18,14 +18,14 @@ Optional flags:
 ## Targets and existing AGENTS.md
 
 - `codex` writes a repository-local Codex marketplace under `.agents/plugins/` and a local AGDF plugin copy under `plugins/agdf/`
-- `copilot` writes `AGENTS.md`, visible repository skills under `.github/skills/`, and AGDF control templates under `.agdf/control/`
-- `both` writes the Codex project marketplace plus the Copilot-facing repository files
+- `copilot` writes `AGENTS.md`, Copilot custom instructions under `.github/`, visible repository skills under `.github/skills/`, and AGDF control templates under `.agdf/control/`
+- `both` writes the Codex repository-local marketplace plus the Copilot-facing repository files
 
-If the target repository already has an `AGENTS.md`, `create-agdf` preserves it and writes `AGENTS.agdf.md` instead of replacing your existing instructions. Merge the AGDF fragment into your current `AGENTS.md` when you want Copilot to load both instruction sets. Use `--force` only when you explicitly want to overwrite generated files.
+If the target repository already has an `AGENTS.md`, `create-agdf` preserves it and writes `AGENTS.agdf.md` instead of replacing your existing instructions. Merge the AGDF fragment into your current `AGENTS.md` when you want Copilot to load both instruction sets. The generated `.github/copilot-instructions.md` keeps Copilot pointed at `AGENTS.md`, `.github/skills/` and `.agdf/control/` without duplicating the full AGDF rule model. Use `--force` only when you explicitly want to overwrite generated files.
 
 Use the `codex` target when AGDF should be available only inside one repository instead of being installed as a personal/global Codex plugin.
 
-After `npm create agdf@latest codex`, restart Codex in that repository, open `/plugins`, select the project marketplace and install `agdf`.
+After `npm create agdf@latest codex`, restart Codex in that repository, open `/plugins`, select `This repository` and install `agdf`.
 
 ## Control scaffold
 

package/bin/create-agdf.js

@@ -20,7 +20,11 @@ const codexPluginFiles = [
   join("plugins", "agdf", "control", "templates", "SOT_REGISTRY.md"),
   join("plugins", "agdf", "control", "templates", "CONTEXT_GRAPH.md"),
   join("plugins", "agdf", "control", "templates", "AGENT_QUALITY_CONTRACTS.json"),
+  join("plugins", "agdf", "hooks", "hooks.json"),
+  join("plugins", "agdf", "hooks", "session-start.sh"),
+  join("plugins", "agdf", "meta", "agdf-constitution.md"),
   join("plugins", "agdf", "meta", "agdf-runtime-contract.md"),
+  join("plugins", "agdf", "meta", "agdf-tenets.md"),
   join("plugins", "agdf", "skills", "agdf-gate-check", "SKILL.md"),
   join("plugins", "agdf", "skills", "agdf-brownfield-analysis", "SKILL.md"),
   join("plugins", "agdf", "skills", "agdf-task-plan-review", "SKILL.md"),
@@ -38,6 +42,10 @@ const controlFiles = [
   join(".agdf", "control", "templates", "CONTEXT_GRAPH.md"),
   join(".agdf", "control", "templates", "AGENT_QUALITY_CONTRACTS.json"),
 ];
+const copilotInstructionFiles = [
+  join(".github", "copilot-instructions.md"),
+  join(".github", "instructions", "agdf-governance.instructions.md"),
+];
 const copilotSkillFiles = [
   join(".github", "skills", "README.md"),
   join(".github", "skills", "agdf-runtime-contract.md"),
@@ -171,6 +179,13 @@ function generatedFilesForTarget(target, targetDir, force) {
       });
     }
 
+    for (const instructionPath of copilotInstructionFiles) {
+      files.push({
+        path: instructionPath,
+        content: loadAsset(instructionPath),
+      });
+    }
+
     for (const skillPath of copilotSkillFiles) {
       files.push({
         path: skillPath,
@@ -197,7 +212,7 @@ function printNextSteps(target, destination, files, wroteAgentsFragment) {
     console.log(`- Existing AGENTS.md detected. Merge ${agdfFragmentPath} into your current AGENTS.md before using Copilot with AGDF.`);
   }
   if (target === "codex" || target === "both") {
-    console.log("- Restart Codex in this repository, open /plugins, select the project marketplace and install agdf.");
+    console.log("- Restart Codex in this repository, open /plugins, select This repository and install agdf.");
     console.log("- Start a new Codex thread in this repository and ask: Run an AGDF gate check for this request.");
   }
   if (target === "both") {

package/generated/.agents/plugins/marketplace.json

@@ -1,5 +1,8 @@
 {
-  "name": "agdf-project",
+  "name": "agdf-repo",
+  "interface": {
+    "displayName": "This repository"
+  },
   "plugins": [
     {
       "name": "agdf",

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

@@ -0,0 +1,10 @@
+# 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.
+- 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.
+- Do not treat chat history as the source of truth for gate state, approvals, evidence or delivery status.

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

@@ -0,0 +1,13 @@
+---
+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.
+- If changing AGDF bootstrap behaviour, update the generated files, smoke test and affected setup documentation together.

package/generated/plugins/agdf/.codex-plugin/plugin.json

@@ -1,6 +1,6 @@
 {
   "name": "agdf",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Codex-first workflow skills for gated, auditable AI-assisted software delivery.",
   "author": {
     "name": "AI-native Governance & Delivery Framework",

package/generated/plugins/agdf/hooks/hooks.json

@@ -0,0 +1,15 @@
+{
+    "hooks": {
+        "SessionStart": [
+            {
+                "hooks": [
+                    {
+                        "type":         "command",
+                        "command":      "bash -lc 'for hook in \"${CODEX_HOME:-$HOME/.codex}\"/plugins/cache/*/agdf/*/hooks/session-start.sh \"$PWD/plugins/agdf/hooks/session-start.sh\" \"$(dirname \"$0\")/session-start.sh\"; do [ -f \"$hook\" ] && exec bash \"$hook\"; done; exit 0'",
+                        "statusMessage": "Loading AGDF..."
+                    }
+                ]
+            }
+        ]
+    }
+}

package/generated/plugins/agdf/hooks/session-start.sh

@@ -0,0 +1,10 @@
+#!/usr/bin/env bash
+# AGDF Session Start Hook
+# Loads the AGDF constitution into the agent session.
+
+SCRIPT_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")" && pwd)"
+CONSTITUTION="${SCRIPT_DIR}/../meta/agdf-constitution.md"
+
+if [ -f "$CONSTITUTION" ]; then
+    cat "$CONSTITUTION"
+fi

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "create-agdf",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Bootstrap AGDF repository-local Codex plugin marketplaces, Copilot instructions, skills and control templates.",
   "type": "module",
   "files": [