@veleads/gtm 0.3.0 → 0.4.0

package/CHANGELOG.md

@@ -5,6 +5,13 @@ All notable changes to `@veleads/gtm`. Each entry is tagged: **no action**, **op
 
 ## [Unreleased]
 
+## [0.4.0] - 2026-10-24
+- **no action** `gtm init . --name "<Name>"` sets up the current folder instead of creating a
+  subfolder (slug from the folder name, e.g. `gtm-project-acme` → `acme`, or `--slug`). Built for a
+  freshly cloned repo: `.git` is kept (no `git init` inside an existing repository), `README.md` is
+  kept, `.gitignore` gets gtm rules appended, `CLAUDE.md` gets `@AGENTS.md`. Any other existing gtm
+  file stops init before anything is written; init never overwrites files.
+
 ## [0.3.0] - 2026-10-24
 - **migration** "Clients" are now **projects**: one private repo = one project.
   `client.yaml` → `project.yaml`, `CLIENT.md` → `PROJECT.md`, `client_id` → `project_id` in every YAML

package/README.md

@@ -12,14 +12,15 @@ Source: [Veleads/gtm-core](https://github.com/Veleads/gtm-core) · MIT
 Requires Node.js 22+. npm is enough; pnpm or yarn work too (the repo follows whichever lockfile you commit).
 
 ```bash
-npx @veleads/gtm init acme --name "Acme Corp"
-cd gtm-project-acme
+# in an empty or freshly cloned (private) repo folder:
+npx @veleads/gtm init . --name "Acme Corp"
 npm install
 npx gtm status
 npx gtm validate
 ```
 
-Push the new folder to a **private** repository, then open it in your coding agent. The generated
+`init .` keeps an existing `.git`, README and `.gitignore` (gtm rules are appended) and never overwrites
+files; `init acme --name "Acme Corp"` creates `./gtm-project-acme` instead. Push to a **private** repository, then open it in your coding agent. The generated
 `AGENTS.md` tells the agent how to work in the repo, starting at stage `00-intake`.
 
 ## What you get in a project repo
@@ -43,7 +44,7 @@ command writes**, and examples, without running it.
 
 | Command | What it does | Writes |
 |---|---|---|
-| `init <slug> --name "<Name>"` | scaffold a new project repo | new folder |
+| `init . --name "<Name>"` / `init <slug> --name "<Name>"` | set up the current folder / a new one | target folder, never overwrites |
 | `new-campaign <slug>` | scaffold `campaigns/<slug>/` | that folder |
 | `validate [campaign]` | schemas, gates, cross-references, no lead data, core sync | nothing |
 | `status` | campaigns, stages, gates | nothing |

package/dist/cli.js

@@ -430,8 +430,8 @@ function runApprove(root2, args2, opts) {
 
 // src/commands/init.ts
 import { spawnSync } from "child_process";
-import { existsSync as existsSync4, mkdirSync as mkdirSync3, readdirSync as readdirSync2, writeFileSync as writeFileSync4 } from "fs";
-import { join as join6, resolve } from "path";
+import { appendFileSync, existsSync as existsSync4, readFileSync as readFileSync5 } from "fs";
+import { basename, join as join6, relative as relative2, resolve } from "path";
 
 // src/paths.ts
 import { existsSync as existsSync2, readFileSync as readFileSync2 } from "fs";
@@ -449,7 +449,7 @@ var KIT_DIR = kit;
 var CHANGELOG_FILE = firstExisting([join2(pkgRoot, "CHANGELOG.md"), join2(pkgRoot, "..", "..", "CHANGELOG.md")]);
 
 // src/template.ts
-import { cpSync, mkdirSync, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
+import { mkdirSync, readFileSync as readFileSync3, writeFileSync as writeFileSync2 } from "fs";
 import { dirname as dirname2, join as join4 } from "path";
 
 // src/fsutil.ts
@@ -505,19 +505,22 @@ function destName(rel) {
   const [first, ...rest] = rel.split("/");
   return [DOTFILES.has(first) ? `.${first}` : first, ...rest].join("/");
 }
+function planTemplate(src, vars, rename = destName) {
+  return walk(src).map((rel) => {
+    const raw = readFileSync3(join4(src, rel));
+    if (!/\.(md|ya?ml|json|txt|example)$|gitignore$/.test(rel)) return { rel: rename(rel), content: raw };
+    let text = raw.toString("utf8");
+    for (const [k, v] of Object.entries(vars)) text = text.replaceAll(`__${k}__`, v);
+    return { rel: rename(rel), content: text };
+  });
+}
+function writePlanned(root2, file) {
+  const out = join4(root2, file.rel);
+  mkdirSync(dirname2(out), { recursive: true });
+  writeFileSync2(out, file.content);
+}
 function copyTemplate(src, dest, vars, opts = {}) {
-  for (const rel of walk(src)) {
-    if (opts.only && !opts.only.includes(rel)) continue;
-    const out = join4(dest, (opts.rename ?? destName)(rel));
-    mkdirSync(dirname2(out), { recursive: true });
-    if (/\.(md|ya?ml|json|txt|example)$|gitignore$/.test(rel)) {
-      let text = readFileSync3(join4(src, rel), "utf8");
-      for (const [k, v] of Object.entries(vars)) text = text.replaceAll(`__${k}__`, v);
-      writeFileSync2(out, text);
-    } else {
-      cpSync(join4(src, rel), out);
-    }
-  }
+  for (const file of planTemplate(src, vars, opts.rename)) writePlanned(dest, file);
 }
 
 // src/commands/sync.ts
@@ -584,33 +587,86 @@ function runSync(root2, opts = {}) {
 }
 
 // src/commands/init.ts
-function runInit(slug, opts) {
-  if (!slug || !Slug.safeParse(slug).success || !opts.name) {
-    console.error('Usage: gtm init <project-slug> --name "<Project Name>" [--dir <path>]   (slug: lowercase, digits, hyphens)');
+var USAGE2 = `Usage:
+  gtm init <project-slug> --name "<Project Name>" [--dir <path>]   create ./gtm-project-<slug> (or <path>)
+  gtm init . --name "<Project Name>" [--slug <project-slug>]        set up the current folder
+Slugs: lowercase letters, digits and hyphens.`;
+var MERGEABLE = /* @__PURE__ */ new Set([".gitignore", "README.md", "CLAUDE.md", "campaigns/.gitkeep", "tam/.gitkeep"]);
+function slugFromFolder(path) {
+  return basename(path).toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-+|-+$/g, "").replace(/^gtm-project-/, "");
+}
+function missingIgnoreLines(existing, ours) {
+  const have = new Set(existing.split("\n").map((l) => l.trim()));
+  return ours.split("\n").filter((l) => l.trim() && !l.trim().startsWith("#") && !have.has(l.trim()));
+}
+function runInit(target, opts) {
+  const here = target === "." || opts.dir === ".";
+  const root2 = resolve(opts.cwd, here ? opts.dir ?? "." : opts.dir ?? `gtm-project-${target ?? ""}`);
+  const slug = target && target !== "." ? target : opts.slug ?? slugFromFolder(root2);
+  if (!opts.name || !slug || !Slug.safeParse(slug).success) {
+    console.error(USAGE2);
+    if (!slug && here) console.error(`Couldn't derive a slug from the folder name "${basename(root2)}": pass one with --slug`);
+    else if (slug && !Slug.safeParse(slug).success) console.error(`"${slug}" is not a valid slug: pass one with --slug`);
     return false;
   }
-  const root2 = resolve(opts.cwd, opts.dir ?? `gtm-project-${slug}`);
-  if (existsSync4(root2) && readdirSync2(root2).length > 0) {
-    console.error(`${root2} exists and is not empty`);
+  if (existsSync4(join6(root2, "project.yaml")) || existsSync4(join6(root2, "client.yaml"))) {
+    console.error(`${root2} is already a gtm project. Use \`npx gtm sync\` or \`npx gtm upgrade\` instead.`);
     return false;
   }
   const vars = { PROJECT_ID: slug, PROJECT_NAME: opts.name, TODAY: (/* @__PURE__ */ new Date()).toISOString().slice(0, 10), GTM_VERSION };
   const tpl = join6(KIT_DIR, "templates");
-  copyTemplate(join6(tpl, "repo"), root2, vars);
-  copyTemplate(join6(tpl, "project"), root2, vars, { rename: (rel) => rel === "project.yaml" ? rel : join6("context", rel) });
-  for (const d of ["campaigns", "tam"]) {
-    mkdirSync3(join6(root2, d), { recursive: true });
-    writeFileSync4(join6(root2, d, ".gitkeep"), "");
+  const planned = [
+    ...planTemplate(join6(tpl, "repo"), vars),
+    ...planTemplate(join6(tpl, "project"), vars, (rel) => rel === "project.yaml" ? rel : join6("context", rel)),
+    { rel: "campaigns/.gitkeep", content: "" },
+    { rel: "tam/.gitkeep", content: "" }
+  ];
+  const coreOwned = [...expectedFiles().keys()];
+  const conflicts = [...planned.map((f) => f.rel), ...coreOwned].filter((rel) => existsSync4(join6(root2, rel)) && !MERGEABLE.has(rel));
+  if (existsSync4(join6(root2, ".gtm"))) conflicts.unshift(".gtm/");
+  if (conflicts.length) {
+    console.error(`Cannot set up ${root2}: these files already exist and belong to gtm. Nothing was written.`);
+    for (const c of [...new Set(conflicts)].slice(0, 15)) console.error(`  \u2717 ${c}`);
+    console.error("Move them away (or use an empty folder) and run init again.");
+    return false;
   }
+  const notes = [];
+  for (const file of planned) {
+    const path = join6(root2, file.rel);
+    if (!existsSync4(path)) {
+      writePlanned(root2, file);
+      continue;
+    }
+    if (file.rel === ".gitignore") {
+      const add = missingIgnoreLines(readFileSync5(path, "utf8"), file.content.toString());
+      if (add.length) {
+        appendFileSync(path, `
+# gtm-brain
+${add.join("\n")}
+`);
+        notes.push(`.gitignore: added ${add.length} gtm rule(s)`);
+      }
+    } else if (file.rel === "README.md") {
+      notes.push("README.md: kept yours (see .gtm/templates/repo/README.md for the gtm version)");
+    }
+  }
+  const claude = join6(root2, "CLAUDE.md");
+  const hadClaude = existsSync4(claude);
   runSync(root2);
-  const git = spawnSync("git", ["init", "-q", "-b", "main"], { cwd: root2 });
+  if (hadClaude && !readFileSync5(claude, "utf8").includes("@AGENTS.md")) {
+    appendFileSync(claude, "\n@AGENTS.md\n");
+    notes.push("CLAUDE.md: added @AGENTS.md so Claude Code loads the operating manual");
+  }
+  const inRepo = spawnSync("git", ["rev-parse", "--is-inside-work-tree"], { cwd: root2, encoding: "utf8" }).stdout?.trim() === "true";
+  const gitNote = inRepo ? "existing git repository kept" : spawnSync("git", ["init", "-q", "-b", "main"], { cwd: root2 }).status === 0 ? "git initialised" : "git not initialised";
+  const where = relative2(opts.cwd, root2) || ".";
+  console.log(`
+Set up project "${opts.name}" (${slug}) in ${root2} (core v${GTM_VERSION}; ${gitNote}).`);
+  for (const n of notes) console.log(`  \xB7 ${n}`);
   console.log(`
-Created ${root2} (core v${GTM_VERSION})${git.status === 0 ? " with git initialised" : ""}.
-
 Next:
-  1. Create a PRIVATE GitHub repo for it (e.g. <your-org>/gtm-project-${slug}) and push this folder.
-     Project repos hold project context: never make them public.
-  2. npm install && npx gtm validate     (or pnpm/yarn; TODO warnings remain until intake is done)
+  1. ${where === "." ? "" : `cd ${where} && `}npm install && npx gtm validate     (or pnpm/yarn; TODO warnings remain until intake is done)
+  2. ${inRepo ? "Commit and push to your PRIVATE repo." : `Create a PRIVATE GitHub repo (e.g. <your-org>/gtm-project-${slug}) and push.`} Project repos hold project context: never make them public.
   3. Open the repo in Claude Code or Codex and start with stage 00-intake.`);
   return true;
 }
@@ -626,8 +682,8 @@ Per AGENTS.md this is a mandatory stop: do not improvise the job with ad-hoc scr
 }
 
 // src/commands/migrate.ts
-import { existsSync as existsSync5, readFileSync as readFileSync5, renameSync, writeFileSync as writeFileSync5 } from "fs";
-import { join as join7, relative as relative2 } from "path";
+import { existsSync as existsSync5, readFileSync as readFileSync6, renameSync, writeFileSync as writeFileSync4 } from "fs";
+import { join as join7, relative as relative3 } from "path";
 import { parseDocument as parseDocument2 } from "yaml";
 function projectYamlFiles(root2) {
   const files = [
@@ -651,7 +707,7 @@ function runMigrate(root2, opts = {}) {
     renameSync(join7(root2, from), join7(root2, to));
     if (to.endsWith(".md")) {
       const p = join7(root2, to);
-      writeFileSync5(p, readFileSync5(p, "utf8").replace(new RegExp(`^# ${from.replace(".", "\\.")}`, "m"), `# ${to}`));
+      writeFileSync4(p, readFileSync6(p, "utf8").replace(new RegExp(`^# ${from.replace(".", "\\.")}`, "m"), `# ${to}`));
     }
   }
   if (opts.dryRun && changed) {
@@ -659,8 +715,8 @@ function runMigrate(root2, opts = {}) {
     return ok;
   }
   for (const { kind, file } of projectYamlFiles(root2)) {
-    const rel = relative2(root2, file);
-    const doc = parseDocument2(readFileSync5(file, "utf8"));
+    const rel = relative3(root2, file);
+    const doc = parseDocument2(readFileSync6(file, "utf8"));
     if (doc.errors.length) {
       console.log(`  \u2717 ${rel}: invalid YAML: ${doc.errors[0].message}`);
       ok = false;
@@ -677,7 +733,7 @@ function runMigrate(root2, opts = {}) {
         doc.setIn(["approval", "content_hash"], icpContentHash(doc.toJS()));
         console.log(`  re-pinned ICP approval hash in ${rel} (core migration, content approved by the project approver)`);
       }
-      if (!opts.dryRun) writeFileSync5(file, doc.toString({ flowCollectionPadding: false, lineWidth: 0 }));
+      if (!opts.dryRun) writeFileSync4(file, doc.toString({ flowCollectionPadding: false, lineWidth: 0 }));
     } catch (e) {
       console.log(`  \u2717 ${rel}: ${e.message}`);
       ok = false;
@@ -688,7 +744,7 @@ function runMigrate(root2, opts = {}) {
 }
 
 // src/commands/new-campaign.ts
-import { existsSync as existsSync6, mkdirSync as mkdirSync4, readFileSync as readFileSync6, writeFileSync as writeFileSync6 } from "fs";
+import { existsSync as existsSync6, mkdirSync as mkdirSync3, readFileSync as readFileSync7, writeFileSync as writeFileSync5 } from "fs";
 import { join as join8 } from "path";
 import { parse } from "yaml";
 function runNewCampaign(root2, campaign) {
@@ -706,21 +762,21 @@ function runNewCampaign(root2, campaign) {
     console.error(`campaigns/${campaign} already exists`);
     return false;
   }
-  const projectId = parse(readFileSync6(projectFile, "utf8"))?.project_id ?? "TODO";
+  const projectId = parse(readFileSync7(projectFile, "utf8"))?.project_id ?? "TODO";
   copyTemplate(join8(KIT_DIR, "templates", "campaign"), dest, { PROJECT_ID: projectId, CAMPAIGN_ID: campaign, OWNER: process.env.GTM_USER ?? "TODO" });
-  mkdirSync4(join8(dest, "runs"), { recursive: true });
-  writeFileSync6(join8(dest, "runs", ".gitkeep"), "");
+  mkdirSync3(join8(dest, "runs"), { recursive: true });
+  writeFileSync5(join8(dest, "runs", ".gitkeep"), "");
   console.log(`Created campaigns/${campaign}. Branch: git switch -c campaign/${campaign}`);
   return true;
 }
 
 // src/commands/status.ts
-import { existsSync as existsSync7, readdirSync as readdirSync3, readFileSync as readFileSync7 } from "fs";
+import { existsSync as existsSync7, readdirSync as readdirSync2, readFileSync as readFileSync8 } from "fs";
 import { join as join9 } from "path";
 import { parse as parse2 } from "yaml";
 function readYaml(file) {
   try {
-    return parse2(readFileSync7(file, "utf8"));
+    return parse2(readFileSync8(file, "utf8"));
   } catch {
     return null;
   }
@@ -737,7 +793,7 @@ function runStatus(root2) {
   const rows = subdirs(join9(root2, "campaigns")).map((id) => {
     const cfg = readYaml(join9(root2, "campaigns", id, "config.yaml")) ?? {};
     const runsDir = join9(root2, "campaigns", id, "runs");
-    const last = existsSync7(runsDir) ? readdirSync3(runsDir).filter((f) => f.endsWith(".md")).sort().at(-1) ?? "-" : "-";
+    const last = existsSync7(runsDir) ? readdirSync2(runsDir).filter((f) => f.endsWith(".md")).sort().at(-1) ?? "-" : "-";
     return [id, cfg.stage ?? "?", cfg.gates?.copy?.status ?? "?", cfg.gates?.launch?.status ?? "?", cfg.owner ?? "?", last];
   });
   if (!rows.length) {
@@ -755,7 +811,7 @@ function runStatus(root2) {
 
 // src/commands/upgrade.ts
 import { spawnSync as spawnSync2 } from "child_process";
-import { existsSync as existsSync9, readFileSync as readFileSync9 } from "fs";
+import { existsSync as existsSync9, readFileSync as readFileSync10 } from "fs";
 import { join as join11 } from "path";
 
 // src/changelog.ts
@@ -774,7 +830,7 @@ function changelogBetween(text, from, to) {
 }
 
 // src/commands/validate.ts
-import { existsSync as existsSync8, readdirSync as readdirSync4, readFileSync as readFileSync8 } from "fs";
+import { existsSync as existsSync8, readdirSync as readdirSync3, readFileSync as readFileSync9 } from "fs";
 import { join as join10 } from "path";
 import { parse as parse3 } from "yaml";
 var REQUIRED_CONTEXT = ["intake.md", "icp.md", "icp.yaml", "signals.yaml", "personas.md", "offer.md", "proof.md", "voice.md"];
@@ -787,7 +843,7 @@ var SKIP_DIRS = ["node_modules", ".git", ".gtm"];
 var stageIndex = (s) => Stage.options.indexOf(s);
 function readPackageJson(root2) {
   const p = join10(root2, "package.json");
-  return existsSync8(p) ? JSON.parse(readFileSync8(p, "utf8")) : null;
+  return existsSync8(p) ? JSON.parse(readFileSync9(p, "utf8")) : null;
 }
 function pinnedVersion(root2) {
   const pkg = readPackageJson(root2);
@@ -800,7 +856,7 @@ function loadVersioned(r, file, kind, schema) {
   }
   let raw;
   try {
-    raw = parse3(readFileSync8(file, "utf8"));
+    raw = parse3(readFileSync9(file, "utf8"));
   } catch (e) {
     r.err(file, `invalid YAML: ${e.message}`);
     return null;
@@ -824,7 +880,7 @@ function checkCoreSync(r, root2) {
   if (!pinned) return;
   if (!/^\d+\.\d+\.\d+/.test(pinned)) r.err(join10(root2, "package.json"), `${PACKAGE_NAME} must be pinned exactly (got "${pinned}")`);
   const versionFile = join10(root2, ".gtm", "VERSION");
-  const synced = existsSync8(versionFile) ? readFileSync8(versionFile, "utf8").trim() : null;
+  const synced = existsSync8(versionFile) ? readFileSync9(versionFile, "utf8").trim() : null;
   if (synced !== GTM_VERSION) r.err(versionFile, `is ${synced ?? "missing"}, installed core is ${GTM_VERSION}: run \`npx gtm sync\``);
   if (!existsSync8(join10(root2, "AGENTS.md"))) r.err(join10(root2, "AGENTS.md"), "missing: run `npx gtm sync`");
 }
@@ -836,8 +892,8 @@ function checkNoLeadData(r, root2) {
       continue;
     }
     if (!/\.(md|ya?ml|txt)$/i.test(rel) || rel === "pnpm-lock.yaml") continue;
-    if (/\.ya?ml$/i.test(rel) && /\bTODO\b/.test(readFileSync8(file, "utf8"))) r.warn(file, "still contains TODO placeholders");
-    const found = (readFileSync8(file, "utf8").match(EMAIL) ?? []).filter((e) => !ALLOWED_EMAIL.test(e));
+    if (/\.ya?ml$/i.test(rel) && /\bTODO\b/.test(readFileSync9(file, "utf8"))) r.warn(file, "still contains TODO placeholders");
+    const found = (readFileSync9(file, "utf8").match(EMAIL) ?? []).filter((e) => !ALLOWED_EMAIL.test(e));
     if (found.length) r.warn(file, `contains email address(es) ${[...new Set(found)].slice(0, 3).join(", ")}: confirm none are prospects`);
   }
 }
@@ -882,7 +938,7 @@ function validateCampaign(r, root2, projectId, campaign, icp, signals, icpApprov
       r.err(cfgFile, `stage is "${cfg.stage}" but the ICP gate (context/icp.yaml approval) is not approved, or the ICP changed since approval`);
     }
     const copyFile = join10(dir, "copy.md");
-    const copyApproved = existsSync8(copyFile) ? checkPinnedApproval(r, copyFile, cfg.gates.copy, copyContentHash(readFileSync8(copyFile, "utf8")), "copy", `npx gtm approve copy ${campaign}`) : false;
+    const copyApproved = existsSync8(copyFile) ? checkPinnedApproval(r, copyFile, cfg.gates.copy, copyContentHash(readFileSync9(copyFile, "utf8")), "copy", `npx gtm approve copy ${campaign}`) : false;
     if (stageIndex(cfg.stage) > stageIndex("copy") && !copyApproved) {
       r.err(cfgFile, `stage is "${cfg.stage}" but gates.copy is not approved, or copy.md changed since approval`);
     }
@@ -898,7 +954,7 @@ function validateCampaign(r, root2, projectId, campaign, icp, signals, icpApprov
   }
   const runs = join10(dir, "runs");
   if (existsSync8(runs)) {
-    for (const f of readdirSync4(runs).filter((f2) => !f2.startsWith("."))) {
+    for (const f of readdirSync3(runs).filter((f2) => !f2.startsWith("."))) {
       if (!RUN_LOG_NAME.test(f)) r.err(join10(runs, f), "run logs must be named YYYY-MM-DD-<user>[-n].md");
     }
   }
@@ -923,7 +979,7 @@ function runValidate(root2, onlyCampaign) {
   const signals = existsSync8(sigFile) ? loadVersioned(r, sigFile, "signals", SignalsFile) : null;
   if (meta && icp && icp.project_id !== projectId) r.err(icpFile, `project_id "${icp.project_id}" does not match project.yaml "${projectId}"`);
   if (meta && signals && signals.project_id !== projectId) r.err(sigFile, `project_id "${signals.project_id}" does not match project.yaml "${projectId}"`);
-  const icpApproved = icp ? checkPinnedApproval(r, icpFile, icp.approval, icpContentHash(parse3(readFileSync8(icpFile, "utf8"))), "ICP", "npx gtm approve icp") : false;
+  const icpApproved = icp ? checkPinnedApproval(r, icpFile, icp.approval, icpContentHash(parse3(readFileSync9(icpFile, "utf8"))), "ICP", "npx gtm approve icp") : false;
   checkNoLeadData(r, root2);
   const campaigns = onlyCampaign ? [onlyCampaign] : subdirs(join10(root2, "campaigns"));
   for (const c of campaigns) {
@@ -979,7 +1035,7 @@ function runUpgrade(root2, opts) {
   const after = pinnedVersion(root2) ?? target;
   const changelog = join11(root2, "node_modules", ...PACKAGE_NAME.split("/"), "CHANGELOG.md");
   if (existsSync9(changelog)) {
-    const notes = changelogBetween(readFileSync9(changelog, "utf8"), before, after);
+    const notes = changelogBetween(readFileSync10(changelog, "utf8"), before, after);
     console.log(`
 === Changes ${before} \u2192 ${after} ===
 ${notes || "(no changelog entries)"}
@@ -992,15 +1048,19 @@ ${notes || "(no changelog entries)"}
 // src/help.ts
 var COMMANDS = {
   init: {
-    usage: 'gtm init <project-slug> --name "<Project Name>" [--dir <path>]',
-    summary: "scaffold a new project repo",
+    usage: 'gtm init <project-slug> --name "<Project Name>" [--dir <path>]\ngtm init . --name "<Project Name>" [--slug <project-slug>]',
+    summary: 'scaffold a project repo (new folder, or the current one with ".")',
     details: [
       "Creates a complete project repo: project.yaml, context/ templates, campaigns/, tam/, PROJECT.md,",
-      "CI workflows, .gtm/ (core kit) and AGENTS.md, pinned to this CLI's version, then runs git init.",
+      "CI workflows, .gtm/ (core kit) and AGENTS.md, pinned to this CLI's version.",
+      '"." sets up the current folder; the slug comes from the folder name (gtm-project-acme \u2192 acme) or --slug.',
+      "Works in a fresh clone: .git is kept (no git init inside an existing repo), README.md is kept,",
+      ".gitignore gets gtm rules appended, CLAUDE.md gets @AGENTS.md. Any other existing gtm file",
+      "(e.g. AGENTS.md, .gtm/, package.json) stops init before anything is written.",
       "Push the result to a PRIVATE repo: it will hold project context."
     ],
-    writes: "A new folder (default ./gtm-project-<slug>). Refuses if it exists and is not empty.",
-    examples: ['npx @veleads/gtm init acme --name "Acme Corp"', 'npx @veleads/gtm init acme --name "Acme Corp" --dir ./projects/acme']
+    writes: 'The target folder (new ./gtm-project-<slug>, --dir, or the current folder with "."). Never overwrites existing files.',
+    examples: ['npx @veleads/gtm init . --name "Acme Corp"', 'npx @veleads/gtm init acme --name "Acme Corp"', 'npx @veleads/gtm init . --name "Acme Corp" --slug acme']
   },
   "new-campaign": {
     usage: "gtm new-campaign <campaign-slug>",
@@ -1123,6 +1183,7 @@ var { values, positionals } = parseArgs({
     root: { type: "string" },
     name: { type: "string" },
     dir: { type: "string" },
+    slug: { type: "string" },
     by: { type: "string" },
     notes: { type: "string" },
     date: { type: "string" },
@@ -1159,7 +1220,7 @@ function run() {
   if (values.help) return help(command === "help" ? args[0] : command);
   switch (command) {
     case "init":
-      return runInit(args[0], { name: values.name, dir: values.dir, cwd });
+      return runInit(args[0], { name: values.name, dir: values.dir, slug: values.slug, cwd });
     case "new-campaign":
       return runNewCampaign(root, args[0]);
     case "validate":

package/kit/AGENTS.md

@@ -182,8 +182,9 @@ Every job prints a `run_id`, counts and cost. Copy those into the run log.
 
 ## 9. Onboarding
 
-- **New project:** a GTM engineer runs `npx @veleads/gtm init <slug> --name "<Name>"`, pushes it as a
-  **private** repo (e.g. `<org>/gtm-project-<slug>`), then stage `00-intake` begins.
+- **New project:** create an empty **private** repo (e.g. `<org>/gtm-project-<slug>`), clone it, and in
+  that folder run `npx @veleads/gtm init . --name "<Name>"` (or `init <slug>` to create a new folder).
+  Commit, push, then stage `00-intake` begins.
 - **New campaign:** from up-to-date `main`: `git switch -c campaign/<slug>`,
   `npx gtm new-campaign <slug>`, fill `brief.md`, set `stage`, follow the routing table.
 - **New SDR:** read this file and `PROJECT.md`, run `npx gtm status`, then section 2 with a GTM engineer watching.

package/kit/skills/00-intake/SKILL.md

@@ -13,7 +13,8 @@ Collect everything later stages need, once, in files, so no one has to re-ask th
 - `context/intake.md` (scaffolded from the core template by `gtm init`).
 
 ## Steps
-1. If the project repo does not exist yet, a GTM engineer creates it: `npx @veleads/gtm init <slug> --name "<Name>"`, then pushes it as a **private** repo (e.g. `<org>/gtm-project-<slug>`).
+1. If the project repo does not exist yet, a GTM engineer creates it: an empty **private** repo, cloned,
+   then `npx @veleads/gtm init . --name "<Name>"` inside it (keeps `.git` and README).
 2. Fill `project.yaml`: owners (GTM engineer, SDRs, **project approver**), regions, status `onboarding`.
 3. Walk the questionnaire in `context/intake.md` with the human. For each answer, write what the
    stakeholders said, not your interpretation. Unknown → write `unknown` and add it to open questions.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veleads/gtm",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "gtm-brain core: process kit (AGENTS.md, skills, templates, schemas) and the gtm CLI for client repos",
   "keywords": [
     "gtm",