@evertonferreira96/agents 0.1.3 → 0.1.4

package/scripts/bootstrap.mjs

@@ -7,6 +7,8 @@
 //   node scripts/bootstrap.mjs <target> --force    update --force: also overwrite files edited in the project
 //   node scripts/bootstrap.mjs --sync              inside a project bootstrapped from a local clone: pull it, then update
 // Protected (never written over): CLAUDE.md, .claude/settings.local.json, .claude/agent-memory/**
+// Project-owned (never shipped, written over or deleted, even with --force): GLOSSARY.md and GLOSSARY-MAP.md, docs/plans/** and docs/adr/**
+// except their README.md templates, .claude/agent-memory/**, .claude/handoffs/**. check-catalog.mjs fails if SYNC would ship one.
 // .claude/config-manifest.json records the hash of every file the config installed. `update` uses it to tell a file that is
 // only outdated (overwritten) from one edited in the project (kept unless --force), and deletes files that left the config
 // only when the project copy is untouched.
@@ -20,6 +22,9 @@ export const SYNC = [".claude/agents", ".claude/hooks", ".claude/rules", ".claud
   "docs/plans/README.md", "docs/adr/README.md", "docs/brief-template.md", "scripts/skills-update.mjs", "scripts/check-catalog.mjs", "scripts/bootstrap.mjs", "skills-lock.json"];
 export const SKIP = /(^|\/)(scripts\/bin|__pycache__|node_modules|\.context-band)(\/|$)|\.pyc$/;
 export const PROTECTED = /^(CLAUDE\.md|\.claude\/settings\.local\.json|\.claude\/agent-memory\/.*)$/;
+// What the project's work produces: plans, wayfinder maps, ADRs, glossaries, agent memory, handoffs. The config only ships the two READMEs.
+export const PROJECT_OWNED = /^((?!\.claude\/)(.+\/)?GLOSSARY\.md|GLOSSARY-MAP\.md|docs\/plans\/(?!README\.md$).+|((?!\.claude\/).+\/)?docs\/adr\/(?!README\.md$).+|\.claude\/agent-memory\/.+|\.claude\/handoffs\/.+)$/;
+const isProtected = (rel) => PROTECTED.test(rel) || PROJECT_OWNED.test(rel);
 export const GITIGNORE = [".claude/worktrees/", ".claude/handoffs/", ".claude/.context-band", ".claude/.stop-verify-ran", ".claude/settings.local.json",
   ".claude/agent-memory-local/", "graphify-out/", ".claude/skills/impeccable/scripts/bin/", "__pycache__/", "*.pyc"];
 export const MANIFEST = ".claude/config-manifest.json";
@@ -45,14 +50,15 @@ export function readPackage(src = DEFAULT_SRC) {
 }
 
 // Every file the config installs, keyed by its path relative to the config root (forward slashes).
-export function configFiles(src = DEFAULT_SRC) {
+// Project-owned paths are never installed; `includeProjectOwned` lists them anyway, for check-catalog.mjs.
+export function configFiles(src = DEFAULT_SRC, { includeProjectOwned = false } = {}) {
   const files = new Map();
   for (const entry of SYNC) {
     const abs = join(src, entry);
     if (!existsSync(abs)) continue;
     for (const f of walk(abs)) {
       const rel = relative(src, f).split(sep).join("/");
-      if (!SKIP.test(rel)) files.set(rel, f);
+      if (!SKIP.test(rel) && (includeProjectOwned || !PROJECT_OWNED.test(rel))) files.set(rel, f);
     }
   }
   return files;
@@ -184,7 +190,7 @@ export function install({ src = DEFAULT_SRC, target, mode = "init", force = fals
     }
     const untouched = installed?.[rel] === have;
     if (mode === "check") { (untouched ? r.outdated : r.edited).push(rel); continue; }
-    if (mode === "update" && (untouched || force) && !PROTECTED.test(rel)) {
+    if (mode === "update" && (untouched || force) && !isProtected(rel)) {
       if (write) copyFileSync(abs, dst);
       r.updated.push(rel); next[rel] = want;
       continue;
@@ -196,11 +202,12 @@ export function install({ src = DEFAULT_SRC, target, mode = "init", force = fals
 
   for (const [rel, hash] of Object.entries(installed ?? {})) {
     if (files.has(rel)) continue;
+    if (PROJECT_OWNED.test(rel)) continue; // an older config shipped it: it is the project's now, so stop tracking it, never delete it
     const dst = join(target, rel);
     if (!existsSync(dst)) continue;
     const untouched = sha(dst) === hash;
     if (mode === "check") { r.obsolete.push(rel); continue; }
-    if (mode === "update" && untouched && !PROTECTED.test(rel)) {
+    if (mode === "update" && untouched && !isProtected(rel)) {
       if (write) { rmSync(dst); removeEmptyParents(target, rel); }
       r.removed.push(rel);
       continue;

package/scripts/check-catalog.mjs

@@ -1,7 +1,9 @@
 #!/usr/bin/env node
-// Drift checks: skills on disk vs docs/skills.md vs frontmatter vs skills-lock.json vs agents' skills: vs settings hooks.
+// Drift checks: skills on disk vs docs/skills.md vs frontmatter vs skills-lock.json vs agents' skills: vs settings hooks,
+// and no project-owned path (plans, ADRs, glossary, agent memory, handoffs) among the files the config ships.
 // Exit 1 on any error. Warnings do not fail.
 import { existsSync, readFileSync, readdirSync } from "node:fs";
+import { configFiles, PROJECT_OWNED } from "./bootstrap.mjs";
 const errors = [], warnings = [];
 const read = (p) => readFileSync(p, "utf8");
 const fm = (p) => read(p).split("---")[1] ?? "";
@@ -37,6 +39,7 @@ for (const list of Object.values(settings.hooks ?? {})) for (const e of list) fo
   const m = /\$CLAUDE_PROJECT_DIR\/(\.claude\/hooks\/[^" ]+)/.exec(h.command ?? "");
   if (m && !existsSync(m[1])) errors.push(`settings.json: hook file ${m[1]} does not exist`);
 }
+for (const rel of configFiles(undefined, { includeProjectOwned: true }).keys()) if (PROJECT_OWNED.test(rel)) errors.push(`${rel}: project-owned path shipped by the config (scripts/bootstrap.mjs SYNC)`);
 for (const w of warnings) console.log(`warn  ${w}`);
 for (const e of errors) console.log(`ERROR ${e}`);
 console.log(`${skills.length} skills, ${rows.size} catalog rows, ${Object.keys(lock).length} lock entries: ${errors.length} error(s), ${warnings.length} warning(s)`);

package/skills-lock.json

@@ -69,6 +69,13 @@
       "skillPath": "skills/engineering/diagnosing-bugs/SKILL.md",
       "sha256": "849198df88cdb65fd0d97236604c1fca7ff2f22d2f705f9724a800d0266b118d"
     },
+    "domain-modeling": {
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "sourceCommit": "49dd158",
+      "skillPath": "skills/engineering/domain-modeling/SKILL.md",
+      "sha256": "7b925d7b1e341a2eeae33ad68a8a8c0ab889a38ddd22a7598e4c240e5a7556a3"
+    },
     "emil-design-eng": {
       "source": "emilkowalski/skills",
       "sourceType": "github",
@@ -107,10 +114,9 @@
       "sourceType": "github",
       "sourceCommit": "49dd158",
       "skillPath": "skills/engineering/grill-with-docs/SKILL.md",
-      "note": "adapted: upstream calls grilling + domain-modeling; local version inlines glossary/ADR rules and adds docs/plans read-first, graphify and the decisions block for the orchestrator",
+      "note": "adapted: calls grilling + domain-modeling like upstream; adds docs/plans read-first, graphify, the Grill record, the ADR template and lifecycle of docs/adr/README.md (which wins over domain-modeling's ADR-FORMAT.md) and the decisions block for the orchestrator",
       "adapted": true,
-      "sha256": "4a6d8bb82e01431ecee9a13b06ccfc4b911f6ee2efcf09bc6686a8e4cee58f72",
-      "sha256Note": "baseline taken from the local file on 2026-10-17; replaced by the upstream hash on the next `skills-update.mjs --lock`"
+      "sha256": "7de372c13488f1ee96cc11cd8907b56b6809cc93eef776eeddd37de6b6cbe3fe"
     },
     "grilling": {
       "source": "mattpocock/skills",
@@ -253,6 +259,15 @@
       "adapted": true,
       "adaptedNote": "frontmatter only: disable-model-invocation: true (preloaded by the agents that use it)"
     },
+    "wayfinder": {
+      "source": "mattpocock/skills",
+      "sourceType": "github",
+      "sourceCommit": "49dd158",
+      "skillPath": "skills/engineering/wayfinder/SKILL.md",
+      "sha256": "9be7b478c389605a24517d27752f278933588da97a1b5921b165f455edf4c5b7",
+      "adapted": true,
+      "adaptedNote": "no issue tracker: the map is docs/plans/<effort>/map.md (with a Status line for the post-compact hook) and tickets are docs/plans/<effort>/decisions/NN-<slug>.md with Type, Status and Blocked by lines (upstream's local-markdown layout, moved under docs/plans); research tickets run as a read-only subagent with a brief instead of skill research (not vendored); prototype tickets go to /ui (skill prototype, emilkowalski) or the owning implementer in a spike worktree, never merged or pushed, since this repo's prototype is a different skill; sessions end with /clear; adds the hand-off to an L task in orchestrate when the way is clear (ADR 0012)"
+    },
     "writing-for-agents": {
       "source": "mattpocock/skills",
       "sourceType": "github",