mdkg 0.0.4 → 0.0.6

package/README.md

@@ -13,8 +13,7 @@ mdkg stays deliberately boring:
 - zero runtime dependencies
 - no sqlite, daemon, hosted index, or vector DB
 
-Current package version in this repo: `0.0.4`
-Publish status: cut prepared, not yet published
+Current package version in source: `0.0.6`
 
 ## The product shape
 
@@ -50,15 +49,15 @@ Initialize mdkg in a repo:
 mdkg init --llm
 ```
 
-This is the generic OSS bootstrap path. It creates `.mdkg/` and updates `.gitignore` / `.npmignore` by default. Use `--no-update-ignores` to opt out.
+This is the generic OSS bootstrap path. It creates `.mdkg/` and updates `.gitignore` / `.npmignore` by default. Use `--no-update-ignores` to opt out of those ignore-file updates.
 
 Optional agent-ready scaffold:
 
 ```bash
-mdkg init --omni
+mdkg init --agent
 ```
 
-This adds strict-node `SOUL.md` / `HUMAN.md`, a skills scaffold, seeded events JSONL, and core pin updates.
+This adds strict-node `SOUL.md` / `HUMAN.md`, seeds the three default mdkg usage skills, creates `events.jsonl`, updates the skill registry, adds core pin updates, and creates mirrored skill folders under `.agents/skills/` and `.claude/skills/`.
 
 Create a task:
 
@@ -87,7 +86,7 @@ Validate before handoff or commit:
 mdkg validate
 ```
 
-Mutate a task-like node without manual markdown editing:
+Update structured task state and evidence while keeping body and narrative edits in markdown:
 
 ```bash
 mdkg task start task-1 --run-id run_local_1
@@ -95,7 +94,7 @@ mdkg task update task-1 --add-artifacts tests://unit.txt --add-tags release
 mdkg task done task-1 --checkpoint "release readiness milestone"
 ```
 
-Enable and append baseline event memory:
+Ensure and append baseline event memory:
 
 ```bash
 mdkg event enable
@@ -114,6 +113,7 @@ mdkg skill validate release-readiness
 ## LLM-readable onboarding artifacts
 
 The root docs below are the canonical fast-start set for humans and agents:
+- [`AGENT_START.md`](/Users/nicholasreames/Git/mdkg/AGENT_START.md)
 - [`llms.txt`](/Users/nicholasreames/Git/mdkg/llms.txt)
 - [`AGENT_PROMPT_SNIPPET.md`](/Users/nicholasreames/Git/mdkg/AGENT_PROMPT_SNIPPET.md)
 - [`PACK_EXAMPLES.md`](/Users/nicholasreames/Git/mdkg/PACK_EXAMPLES.md)
@@ -129,6 +129,8 @@ mdkg lives under a hidden root directory:
 - `.mdkg/work/` tasks, bugs, tests, epics, checkpoints
 - `.mdkg/templates/` templates used by `mdkg new`
 - `.mdkg/skills/` Agent Skills packages
+- `.agents/skills/` Codex/OpenAI-facing mirrored skills
+- `.claude/skills/` Claude-facing mirrored skills
 - `.mdkg/index/` generated cache files
 
 ## Primary commands
@@ -165,12 +167,15 @@ Canonical layout:
 
 Current source behavior:
 - skills are indexed into `.mdkg/index/skills.json`
+- `.mdkg/skills/` remains the canonical skill source of truth
+- `.agents/skills/` and `.claude/skills/` are materialized mirrors for agent products
 - skills have a focused command family:
   - `mdkg skill new <slug> "<name>" --description "..."`
   - `mdkg skill list`
   - `mdkg skill search "<query>"`
   - `mdkg skill show <slug>`
   - `mdkg skill validate [<slug>]`
+  - `mdkg skill sync`
 - machine-readable skill discovery is available through:
   - `mdkg skill list --json`
   - `mdkg skill search "<query>" --json`
@@ -182,6 +187,8 @@ Current source behavior:
 - `SKILLS.md` is tolerated on read for compatibility, but validation warns and canonical docs still use `SKILL.md`
 - if both `SKILL.md` and `SKILLS.md` exist in one skill folder, validation fails
 - `mdkg skill new` scaffolds `SKILL.md`, `references/`, `assets/`, and `scripts/` only when requested with `--with-scripts`
+- `mdkg skill sync` refreshes the product-specific mirrors from canonical `.mdkg/skills/`
+- mirrored skill folders are append-focused outputs; preserve unrelated existing folders and fail on same-slug collisions unless explicitly forced
 
 This repo now dogfoods three internal skills:
 - `author-mdkg-skill`
@@ -191,19 +198,23 @@ This repo now dogfoods three internal skills:
 
 ## Current direction
 
-Current `0.0.4` release polish already includes:
-- `init --omni`
-- default ignore updates with `--no-update-ignores`
+This release includes:
+- `init --agent`
+- default ignore updates with `--no-update-ignores` for `.mdkg/index/` and `.mdkg/pack/`
 - skills indexing and search/show/list support
 - optional `skills: [...]` on work items
 - pack-time skill inclusion
 - latest-checkpoint resolver + index hint
 - events JSONL validation
+- product-specific skill mirrors for Codex/OpenAI and Claude
+- shared `AGENT_START.md` startup guidance
 
-Current `0.0.4` polish direction is:
+Current direction:
 - keep the OSS story generic around `init --llm`
+- use `init --agent` for deeper AI-agent bootstrap
 - keep `pack <id>` at the center of the human/agent loop
-- make task mutation and event logging guided instead of purely manual
+- use `mdkg task ...` for structured state changes and markdown edits for narrative/body content
+- make event logging guided instead of purely manual
 - dogfood real skills inside the repo
 - make skill authoring first-class through `mdkg skill`
 - make `CLI_COMMAND_MATRIX.md` the single source of truth for the live CLI surface
@@ -218,7 +229,7 @@ mdkg is not a secret store.
 Use these defaults:
 - keep `.mdkg/index/` gitignored
 - keep `.mdkg/pack/` gitignored
-- keep `.mdkg/work/events/*.jsonl` gitignored unless you deliberately opt in
+- event logs are committed by default; ignore or delete them manually if a repo wants local-only provenance
 - do not ship `.mdkg/` into production builds or published packages
 - if an external orchestrator is writing mdkg state, keep one durable writer per run and batch commits at end-of-run or checkpoint boundaries
 - do not commit on every tool call
@@ -235,7 +246,7 @@ Suggested local loop:
 2. inspect truth with `search`, `show`, or `next`
 3. build context with `pack <id>`
 4. mutate task state with `mdkg task ...` when durable state changes
-5. enable event logging if provenance should be captured in JSONL
+5. ensure event logging exists if the JSONL file was deleted or is missing
 6. implement and test
 7. run `mdkg validate`
 

package/dist/cli.js

@@ -77,7 +77,7 @@ function printUsage(log) {
     log("  mdkg skill list --tags stage:plan --json");
     log("  mdkg validate");
     log("\nOptional agent-ready bootstrap:");
-    log("  mdkg init --omni");
+    log("  mdkg init --agent");
     log("\nRun `mdkg help <command>` or `mdkg <command> --help` for details.");
     printGlobalOptions(log);
 }
@@ -86,8 +86,8 @@ function printInitHelp(log) {
     log("  mdkg init [options]");
     log("\nOptions:");
     log("  --force               Overwrite existing mdkg files");
-    log("  --llm                 Create AGENTS.md and CLAUDE.md");
-    log("  --omni                Add SOUL/HUMAN/skills/events scaffolding");
+    log("  --llm                 Create AGENTS.md, CLAUDE.md, llms.txt, and AGENT_START.md");
+    log("  --agent               Add SOUL/HUMAN/skills/events scaffolding and skill mirrors");
     log("  --no-update-ignores   Skip default .gitignore/.npmignore updates");
     log("  --update-gitignore    Append mdkg ignore entries");
     log("  --update-npmignore    Append mdkg ignore entries");
@@ -234,6 +234,13 @@ function printSkillHelp(log, subcommand) {
             log("  mdkg skill validate [<slug>]");
             printGlobalOptions(log);
             return;
+        case "sync":
+            log("Usage:");
+            log("  mdkg skill sync [--force]");
+            log("\nWhen to use:");
+            log("  Rebuild .agents/skills and .claude/skills from canonical .mdkg/skills.");
+            printGlobalOptions(log);
+            return;
         default:
             log("Usage:");
             log('  mdkg skill new <slug> "<name>" --description "<description>" [options]');
@@ -241,6 +248,7 @@ function printSkillHelp(log, subcommand) {
             log("  mdkg skill show <slug> [--meta] [--json]");
             log('  mdkg skill search "<query>" [--tags <tag,tag,...>] [--tags-mode any|all] [--json]');
             log("  mdkg skill validate [<slug>]");
+            log("  mdkg skill sync [--force]");
             log("\nNotes:");
             log("  Skills are first-class under `mdkg skill ...`.");
             log("  Use stage tags like `stage:plan`, `stage:execute`, and `stage:review` with --tags.");
@@ -253,7 +261,8 @@ function printTaskHelp(log, subcommand) {
             log("Usage:");
             log('  mdkg task start <id-or-qid> [--ws <alias>] [--run-id <id>] [--note "<text>"]');
             log("\nWhen to use:");
-            log("  Move a task, bug, or test into progress and emit a baseline event when logging is enabled.");
+            log("  Move a task, bug, or test into progress as a structured state change.");
+            log("  If `events.jsonl` is missing, mdkg prints a short reminder about `mdkg event enable`.");
             printGlobalOptions(log);
             return;
         case "update":
@@ -263,7 +272,7 @@ function printTaskHelp(log, subcommand) {
             log("                   [--add-skills <slug,...>] [--add-tags <tag,...>] [--add-blocked-by <id,...>]");
             log('                   [--clear-blocked-by] [--run-id <id>] [--note "<text>"]');
             log("\nWhen to use:");
-            log("  Update task metadata and evidence without editing markdown manually.");
+            log("  Update structured task metadata and evidence while keeping body and narrative edits in markdown.");
             printGlobalOptions(log);
             return;
         case "done":
@@ -272,6 +281,7 @@ function printTaskHelp(log, subcommand) {
             log('                 [--add-refs <id,...>] [--checkpoint "<title>"] [--run-id <id>] [--note "<text>"]');
             log("\nWhen to use:");
             log("  Mark a task-like node done, optionally create a checkpoint, and emit a completion event when enabled.");
+            log("  Use `--checkpoint` for milestone compression, not every routine task completion.");
             printGlobalOptions(log);
             return;
         default:
@@ -281,6 +291,7 @@ function printTaskHelp(log, subcommand) {
             log('  mdkg task done <id-or-qid> [--checkpoint "<title>"] [options]');
             log("\nNotes:");
             log("  `mdkg task ...` only supports task, bug, and test nodes in this wave.");
+            log("  Feat and epic closeout remain checkpoint-first guidance plus manual parent updates.");
             printGlobalOptions(log);
     }
 }
@@ -288,9 +299,9 @@ function printEventHelp(log, subcommand) {
     switch ((subcommand ?? "").toLowerCase()) {
         case "enable":
             log("Usage:");
-            log("  mdkg event enable [--ws <alias>] [--no-update-gitignore]");
+            log("  mdkg event enable [--ws <alias>]");
             log("\nWhen to use:");
-            log("  Create the append-only JSONL event log for a workspace.");
+            log("  Create or ensure the append-only JSONL event log for a workspace.");
             printGlobalOptions(log);
             return;
         case "append":
@@ -304,7 +315,7 @@ function printEventHelp(log, subcommand) {
             return;
         default:
             log("Usage:");
-            log("  mdkg event enable [--ws <alias>] [--no-update-gitignore]");
+            log("  mdkg event enable [--ws <alias>]");
             log("  mdkg event append --kind <kind> --status <ok|error|retry|skipped> --refs <id,...> [options]");
             printGlobalOptions(log);
     }
@@ -670,8 +681,16 @@ function runSkillSubcommand(parsed, root) {
             (0, skill_1.runSkillValidateCommand)({ root, slug });
             return 0;
         }
+        case "sync": {
+            if (parsed.positionals.length > 2) {
+                throw new errors_1.UsageError("skill sync does not accept positional arguments");
+            }
+            const force = parseBooleanFlag("--force", parsed.flags["--force"]);
+            (0, skill_1.runSkillSyncCommand)({ root, force });
+            return 0;
+        }
         default:
-            throw new errors_1.UsageError("skill requires new/list/show/search/validate");
+            throw new errors_1.UsageError("skill requires new/list/show/search/validate/sync");
     }
 }
 function runTaskSubcommand(parsed, root) {
@@ -760,8 +779,7 @@ function runEventSubcommand(parsed, root) {
                 throw new errors_1.UsageError("event enable does not accept positional arguments");
             }
             const ws = requireFlagValue("--ws", parsed.flags["--ws"]);
-            const noUpdateGitignore = parseBooleanFlag("--no-update-gitignore", parsed.flags["--no-update-gitignore"]);
-            (0, event_1.runEventEnableCommand)({ root, ws, updateGitignore: !noUpdateGitignore });
+            (0, event_1.runEventEnableCommand)({ root, ws });
             return 0;
         }
         case "append": {
@@ -808,7 +826,10 @@ function runCommand(parsed, root, runtime) {
             const createAgents = parseBooleanFlag("--agents", parsed.flags["--agents"]);
             const createClaude = parseBooleanFlag("--claude", parsed.flags["--claude"]);
             const createLlm = parseBooleanFlag("--llm", parsed.flags["--llm"]);
-            const omni = parseBooleanFlag("--omni", parsed.flags["--omni"]);
+            if (parsed.flags["--omni"]) {
+                throw new errors_1.UsageError("`mdkg init --omni` was removed; use `mdkg init --agent`");
+            }
+            const agent = parseBooleanFlag("--agent", parsed.flags["--agent"]);
             const noUpdateIgnores = parseBooleanFlag("--no-update-ignores", parsed.flags["--no-update-ignores"]);
             const updateGitignore = parseBooleanFlag("--update-gitignore", parsed.flags["--update-gitignore"]);
             const updateNpmignore = parseBooleanFlag("--update-npmignore", parsed.flags["--update-npmignore"]);
@@ -823,7 +844,7 @@ function runCommand(parsed, root, runtime) {
                 createAgents,
                 createClaude,
                 createLlm,
-                omni,
+                agent,
             });
             return 0;
         }

package/dist/commands/event.js

@@ -7,8 +7,7 @@ const errors_1 = require("../util/errors");
 function runEventEnableCommand(options) {
     const result = (0, event_support_1.ensureEventsEnabled)(options);
     const createdLabel = result.created ? "created" : "already present";
-    const ignoreLabel = result.gitignoreUpdated ? "updated .gitignore" : "left .gitignore unchanged";
-    console.log(`event logging enabled: ${result.ws} (${createdLabel}; ${ignoreLabel})`);
+    console.log(`event logging enabled: ${result.ws} (${createdLabel})`);
 }
 function normalizeEventStatus(value) {
     const normalized = value.trim().toLowerCase();

package/dist/commands/event_support.js

@@ -16,27 +16,6 @@ const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const config_1 = require("../core/config");
 const errors_1 = require("../util/errors");
-function appendIgnoreEntries(filePath, entries) {
-    const normalizedEntries = entries.map((entry) => entry.trim()).filter(Boolean);
-    if (normalizedEntries.length === 0) {
-        return false;
-    }
-    let existing = "";
-    if (fs_1.default.existsSync(filePath)) {
-        existing = fs_1.default.readFileSync(filePath, "utf8");
-    }
-    const existingLines = new Set(existing
-        .split(/\r?\n/)
-        .map((line) => line.trim())
-        .filter(Boolean));
-    const additions = normalizedEntries.filter((entry) => !existingLines.has(entry));
-    if (additions.length === 0) {
-        return false;
-    }
-    const next = existing.length === 0 ? `${additions.join("\n")}\n` : `${existing.replace(/\s*$/, "\n")}${additions.join("\n")}\n`;
-    fs_1.default.writeFileSync(filePath, next, "utf8");
-    return true;
-}
 function normalizeWorkspaceForEvents(config, raw) {
     const normalized = (raw ?? "root").toLowerCase();
     if (normalized === "all") {
@@ -70,20 +49,13 @@ function ensureEventsEnabled(options) {
     const config = (0, config_1.loadConfig)(options.root);
     const ws = normalizeWorkspaceForEvents(config, options.ws);
     const eventsPath = resolveEventsPath(options.root, config, ws);
-    const updateGitignore = options.updateGitignore !== false;
     let created = false;
     if (!fs_1.default.existsSync(eventsPath)) {
         fs_1.default.mkdirSync(path_1.default.dirname(eventsPath), { recursive: true });
         fs_1.default.writeFileSync(eventsPath, "", "utf8");
         created = true;
     }
-    let gitignoreUpdated = false;
-    if (updateGitignore) {
-        gitignoreUpdated = appendIgnoreEntries(path_1.default.join(options.root, ".gitignore"), [
-            ".mdkg/work/events/*.jsonl",
-        ]);
-    }
-    return { ws, eventsPath, created, gitignoreUpdated };
+    return { ws, eventsPath, created };
 }
 function normalizeIdOrIdRef(value) {
     return value.trim().toLowerCase();
@@ -131,7 +103,7 @@ function appendEvent(options) {
     }
     const eventsPath = resolveEventsPath(options.root, config, record.workspace);
     if (!fs_1.default.existsSync(eventsPath)) {
-        throw new errors_1.NotFoundError(`event logging is not enabled for workspace ${record.workspace}; run \`mdkg event enable --ws ${record.workspace}\``);
+        throw new errors_1.NotFoundError(`events.jsonl is missing for workspace ${record.workspace}; run \`mdkg event enable --ws ${record.workspace}\``);
     }
     fs_1.default.appendFileSync(eventsPath, `${JSON.stringify(record)}\n`, "utf8");
     return record;

package/dist/commands/init.js

@@ -6,9 +6,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.runInitCommand = runInitCommand;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
+const config_1 = require("../core/config");
 const errors_1 = require("../util/errors");
 const date_1 = require("../util/date");
 const skill_support_1 = require("./skill_support");
+const skill_mirror_1 = require("./skill_mirror");
 const DEFAULT_SEED_SUBDIR = path_1.default.resolve(__dirname, "..", "init");
 const SOUL_PIN_ID = "rule-soul";
 const HUMAN_PIN_ID = "rule-human";
@@ -84,7 +86,7 @@ function soulTemplate(created) {
         `id: ${SOUL_PIN_ID}`,
         "type: rule",
         "title: agent soul and execution contract",
-        "tags: [omni, agent, constraints]",
+        "tags: [agent, constraints]",
         "owners: []",
         "links: []",
         "artifacts: []",
@@ -167,7 +169,7 @@ function seededInitEvent(nowIso) {
         status: "ok",
         refs: ["edd-4"],
         artifacts: [],
-        notes: "init omni scaffold target initialized",
+        notes: "init agent scaffold target initialized",
         redacted: true,
     };
     return `${JSON.stringify(event)}\n`;
@@ -222,13 +224,18 @@ function runInitCommand(options) {
     const seedRoot = options.seedRoot ? path_1.default.resolve(options.seedRoot) : DEFAULT_SEED_SUBDIR;
     const createAgents = Boolean(options.createAgents || options.createLlm);
     const createClaude = Boolean(options.createClaude || options.createLlm);
+    const createStartupDocs = Boolean(options.createLlm || options.agent);
     const force = Boolean(options.force);
     const seedConfig = path_1.default.join(seedRoot, "config.json");
     const seedCore = path_1.default.join(seedRoot, "core");
     const seedTemplates = path_1.default.join(seedRoot, "templates");
     const seedAgents = path_1.default.join(seedRoot, "AGENTS.md");
     const seedClaude = path_1.default.join(seedRoot, "CLAUDE.md");
+    const seedLlms = path_1.default.join(seedRoot, "llms.txt");
+    const seedAgentStart = path_1.default.join(seedRoot, "AGENT_START.md");
+    const seedCliMatrix = path_1.default.join(seedRoot, "CLI_COMMAND_MATRIX.md");
     const seedReadme = path_1.default.join(seedRoot, "README.md");
+    const seedDefaultSkills = path_1.default.join(seedRoot, "skills", "default");
     if (!fs_1.default.existsSync(seedConfig) || !fs_1.default.existsSync(seedCore) || !fs_1.default.existsSync(seedTemplates)) {
         throw new errors_1.NotFoundError(`init assets not found at ${seedRoot} (try reinstalling mdkg)`);
     }
@@ -238,9 +245,21 @@ function runInitCommand(options) {
     if (createClaude && !fs_1.default.existsSync(seedClaude)) {
         throw new errors_1.NotFoundError(`init assets missing CLAUDE.md at ${seedRoot}`);
     }
+    if (createStartupDocs && !fs_1.default.existsSync(seedLlms)) {
+        throw new errors_1.NotFoundError(`init assets missing llms.txt at ${seedRoot}`);
+    }
+    if (createStartupDocs && !fs_1.default.existsSync(seedAgentStart)) {
+        throw new errors_1.NotFoundError(`init assets missing AGENT_START.md at ${seedRoot}`);
+    }
+    if (createStartupDocs && !fs_1.default.existsSync(seedCliMatrix)) {
+        throw new errors_1.NotFoundError(`init assets missing CLI_COMMAND_MATRIX.md at ${seedRoot}`);
+    }
     if (!fs_1.default.existsSync(seedReadme)) {
         throw new errors_1.NotFoundError(`init assets missing README.md at ${seedRoot}`);
     }
+    if (options.agent && !fs_1.default.existsSync(seedDefaultSkills)) {
+        throw new errors_1.NotFoundError(`init assets missing default skills at ${seedRoot}`);
+    }
     const mdkgDir = path_1.default.join(root, ".mdkg");
     fs_1.default.mkdirSync(mdkgDir, { recursive: true });
     fs_1.default.mkdirSync(path_1.default.join(mdkgDir, "work"), { recursive: true });
@@ -256,7 +275,12 @@ function runInitCommand(options) {
     if (createClaude) {
         copySeedFile(seedClaude, path_1.default.join(root, "CLAUDE.md"), force, stats);
     }
-    if (options.omni) {
+    if (createStartupDocs) {
+        copySeedFile(seedLlms, path_1.default.join(root, "llms.txt"), force, stats);
+        copySeedFile(seedAgentStart, path_1.default.join(root, "AGENT_START.md"), force, stats);
+        copySeedFile(seedCliMatrix, path_1.default.join(root, "CLI_COMMAND_MATRIX.md"), force, stats);
+    }
+    if (options.agent) {
         const today = (0, date_1.formatDate)(new Date());
         const soulPath = path_1.default.join(mdkgDir, "core", "SOUL.md");
         const humanPath = path_1.default.join(mdkgDir, "core", "HUMAN.md");
@@ -266,6 +290,7 @@ function runInitCommand(options) {
         const eventsPath = path_1.default.join(eventsDir, "events.jsonl");
         fs_1.default.mkdirSync(skillsDir, { recursive: true });
         fs_1.default.mkdirSync(eventsDir, { recursive: true });
+        copySeedDir(seedDefaultSkills, skillsDir, force, stats);
         writeFileIfMissing(soulPath, soulTemplate(today), force, stats);
         writeFileIfMissing(humanPath, humanTemplate(today), force, stats);
         writeFileIfMissing(registryPath, (0, skill_support_1.registryTemplate)(), force, stats);
@@ -274,6 +299,10 @@ function runInitCommand(options) {
         }
         const coreListPath = path_1.default.join(mdkgDir, "core", "core.md");
         ensureCorePins(coreListPath, [SOUL_PIN_ID, HUMAN_PIN_ID]);
+        (0, skill_mirror_1.scaffoldMirrorRoots)(root);
+        const config = (0, config_1.loadConfig)(root);
+        (0, skill_support_1.refreshSkillsRegistry)(root, config);
+        (0, skill_mirror_1.syncSkillMirrors)({ root, config, createRoots: true, force });
     }
     const noUpdateIgnores = Boolean(options.noUpdateIgnores);
     const shouldUpdateGitignore = Boolean(options.updateGitignore || !noUpdateIgnores);
@@ -282,7 +311,6 @@ function runInitCommand(options) {
         appendIgnoreEntries(path_1.default.join(root, ".gitignore"), [
             ".mdkg/index/",
             ".mdkg/pack/",
-            ".mdkg/work/events/*.jsonl",
         ]);
     }
     if (shouldUpdateNpmignore) {
@@ -293,6 +321,9 @@ function runInitCommand(options) {
     }
     console.log(`mdkg init complete: ${stats.created} file(s) created, ${stats.skipped} skipped`);
     console.log("next:");
+    if (createStartupDocs) {
+        console.log("  read AGENT_START.md");
+    }
     console.log('  mdkg new task "..." --status todo --priority 1');
     console.log('  mdkg search "..."');
     console.log("  mdkg show <id>");

package/dist/commands/skill.js

@@ -8,6 +8,7 @@ exports.runSkillListCommand = runSkillListCommand;
 exports.runSkillShowCommand = runSkillShowCommand;
 exports.runSkillSearchCommand = runSkillSearchCommand;
 exports.runSkillValidateCommand = runSkillValidateCommand;
+exports.runSkillSyncCommand = runSkillSyncCommand;
 const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const config_1 = require("../core/config");
@@ -18,6 +19,7 @@ const errors_1 = require("../util/errors");
 const skill_support_1 = require("./skill_support");
 const query_output_1 = require("./query_output");
 const event_support_1 = require("./event_support");
+const skill_mirror_1 = require("./skill_mirror");
 function parseCsvList(raw) {
     if (!raw) {
         return [];
@@ -171,6 +173,9 @@ function runSkillNewCommand(options) {
     fs_1.default.writeFileSync(canonicalPath, content, "utf8");
     (0, skill_support_1.ensureSkillsRegistry)(root, config);
     (0, skill_support_1.refreshSkillsRegistry)(root, config);
+    if ((0, skill_mirror_1.shouldMaintainSkillMirrors)(root)) {
+        (0, skill_mirror_1.syncSkillMirrors)({ root, config, createRoots: true, force });
+    }
     if (config.index.auto_reindex) {
         const skillsIndex = (0, skills_indexer_1.buildSkillsIndex)(root, config);
         (0, skills_index_cache_2.writeSkillsIndex)((0, skills_indexer_1.resolveSkillsIndexPath)(root), skillsIndex);
@@ -357,3 +362,13 @@ function runSkillValidateCommand(options) {
         : 0;
     console.log(`skill validation ok: ${checkedCount} skill${checkedCount === 1 ? "" : "s"} checked`);
 }
+function runSkillSyncCommand(options) {
+    const config = (0, config_1.loadConfig)(options.root);
+    const result = (0, skill_mirror_1.syncSkillMirrors)({
+        root: options.root,
+        config,
+        createRoots: true,
+        force: options.force,
+    });
+    console.log(`skill mirror sync ok: ${result.synced} synced, ${result.pruned} pruned across ${result.targets} target${result.targets === 1 ? "" : "s"}`);
+}