@juho0719/cckit 0.2.0 → 0.2.1

package/assets/claudemd/CLAUDE.md

@@ -0,0 +1,69 @@
+---
+name: Claude Behavioral Guidelines
+description: LLM coding best practices - think before coding, simplicity, surgical changes, goal-driven execution
+---
+# Claude Behavioral Guidelines
+
+Behavioral guidelines to reduce common LLM coding mistakes. Merge with project-specific instructions as needed.
+
+**Tradeoff:** These guidelines bias toward caution over speed. For trivial tasks, use judgment.
+
+## 1. Think Before Coding
+
+**Don't assume. Don't hide confusion. Surface tradeoffs.**
+
+Before implementing:
+- State your assumptions explicitly. If uncertain, ask.
+- If multiple interpretations exist, present them - don't pick silently.
+- If a simpler approach exists, say so. Push back when warranted.
+- If something is unclear, stop. Name what's confusing. Ask.
+
+## 2. Simplicity First
+
+**Minimum code that solves the problem. Nothing speculative.**
+
+- No features beyond what was asked.
+- No abstractions for single-use code.
+- No "flexibility" or "configurability" that wasn't requested.
+- No error handling for impossible scenarios.
+- If you write 200 lines and it could be 50, rewrite it.
+
+Ask yourself: "Would a senior engineer say this is overcomplicated?" If yes, simplify.
+
+## 3. Surgical Changes
+
+**Touch only what you must. Clean up only your own mess.**
+
+When editing existing code:
+- Don't "improve" adjacent code, comments, or formatting.
+- Don't refactor things that aren't broken.
+- Match existing style, even if you'd do it differently.
+- If you notice unrelated dead code, mention it - don't delete it.
+
+When your changes create orphans:
+- Remove imports/variables/functions that YOUR changes made unused.
+- Don't remove pre-existing dead code unless asked.
+
+The test: Every changed line should trace directly to the user's request.
+
+## 4. Goal-Driven Execution
+
+**Define success criteria. Loop until verified.**
+
+Transform tasks into verifiable goals:
+- "Add validation" → "Write tests for invalid inputs, then make them pass"
+- "Fix the bug" → "Write a test that reproduces it, then make it pass"
+- "Refactor X" → "Ensure tests pass before and after"
+
+For multi-step tasks, state a brief plan:
+```
+1. [Step] → verify: [check]
+2. [Step] → verify: [check]
+3. [Step] → verify: [check]
+```
+
+Strong success criteria let you loop independently. Weak criteria ("make it work") require constant clarification.
+
+---
+
+**These guidelines are working if:** fewer unnecessary changes in diffs, fewer rewrites due to overcomplication, and clarifying questions come before implementation rather than after mistakes.

package/dist/{chunk-6B46AIFM.js → chunk-OLLOS3GG.js}

@@ -98,6 +98,21 @@ async function getRuleCategories() {
   }
   return categories;
 }
+async function getClaudemdItems() {
+  const dir = join(getAssetsDir(), "claudemd");
+  const files = (await readdir(dir)).filter((f) => f.endsWith(".md"));
+  const items = [];
+  for (const file of files) {
+    const content = await readFile(join(dir, file), "utf-8");
+    const fm = parseFrontmatter(content);
+    items.push({
+      name: fm["name"] || basename(file, ".md"),
+      description: fm["description"] || "",
+      file
+    });
+  }
+  return items;
+}
 async function getMcpServers() {
   const filePath = join(getAssetsDir(), "mcps", "mcp-servers.json");
   const content = await readFile(filePath, "utf-8");
@@ -132,5 +147,6 @@ export {
   getCommands,
   getHooks,
   getRuleCategories,
+  getClaudemdItems,
   getMcpServers
 };

package/dist/chunk-SW3OJLHC.js

@@ -0,0 +1,35 @@
+import {
+  getAssetsDir
+} from "./chunk-5XOKKPAA.js";
+
+// src/installers/claudemd.ts
+import { join } from "path";
+import { readFile, writeFile, access } from "fs/promises";
+import { constants } from "fs";
+async function installClaudemd(items, targetDir) {
+  const claudemdDir = join(getAssetsDir(), "claudemd");
+  const targetClaudeMd = join(targetDir, "CLAUDE.md");
+  let existing = "";
+  try {
+    await access(targetClaudeMd, constants.F_OK);
+    existing = await readFile(targetClaudeMd, "utf-8");
+  } catch {
+  }
+  const toAppend = [];
+  for (const item of items) {
+    const raw = await readFile(join(claudemdDir, item.file), "utf-8");
+    const content = raw.replace(/^---\s*\n[\s\S]*?\n---\s*\n/, "").trim();
+    const headerMatch = content.match(/^#{1,2}\s+.+/m);
+    if (headerMatch) {
+      if (existing.includes(headerMatch[0])) continue;
+    }
+    toAppend.push(content);
+  }
+  if (toAppend.length === 0) return;
+  const appendContent = (existing.endsWith("\n") ? "" : "\n") + toAppend.join("\n\n") + "\n";
+  await writeFile(targetClaudeMd, existing + appendContent, "utf-8");
+}
+
+export {
+  installClaudemd
+};

package/dist/claudemd-KKQ2DL7P.js

@@ -0,0 +1,7 @@
+import {
+  installClaudemd
+} from "./chunk-SW3OJLHC.js";
+import "./chunk-5XOKKPAA.js";
+export {
+  installClaudemd
+};

package/dist/{cli-H6IDWH7Q.js → cli-D2Q5QUO7.js}

@@ -1,14 +1,18 @@
 import {
   installMcps
 } from "./chunk-W63UKEIT.js";
+import {
+  installClaudemd
+} from "./chunk-SW3OJLHC.js";
 import {
   getAgents,
+  getClaudemdItems,
   getCommands,
   getHooks,
   getMcpServers,
   getRuleCategories,
   getSkills
-} from "./chunk-6B46AIFM.js";
+} from "./chunk-OLLOS3GG.js";
 import {
   installAgents
 } from "./chunk-EYY2IZ7N.js";
@@ -74,7 +78,8 @@ async function runCli() {
       { name: "Commands - Slash commands", value: "commands" },
       { name: "Hooks    - Post-tool hooks", value: "hooks" },
       { name: "Rules    - CLAUDE.md rules", value: "rules" },
-      { name: "MCPs     - MCP server configs", value: "mcps" }
+      { name: "MCPs     - MCP server configs", value: "mcps" },
+      { name: "ClaudeMd - Behavioral guidelines", value: "claudemd" }
     ]
   });
   if (selectedCategories.length === 0) {
@@ -89,7 +94,8 @@ async function runCli() {
     hooks: [],
     ruleCategories: [],
     mcps: [],
-    mcpEnvValues: /* @__PURE__ */ new Map()
+    mcpEnvValues: /* @__PURE__ */ new Map(),
+    claudemds: []
   };
   const skippedMcps = /* @__PURE__ */ new Map();
   if (selectedCategories.includes("agents")) {
@@ -147,6 +153,17 @@ async function runCli() {
       }))
     });
   }
+  if (selectedCategories.includes("claudemd")) {
+    const allClaudemds = await getClaudemdItems();
+    plan.claudemds = await checkbox({
+      message: "Select claudemd items:",
+      choices: allClaudemds.map((c) => ({
+        name: `${chalk.bold(c.name.padEnd(35))} ${chalk.gray(c.description.slice(0, 55))}`,
+        value: c,
+        checked: false
+      }))
+    });
+  }
   if (selectedCategories.includes("mcps")) {
     const allMcps = await getMcpServers();
     plan.mcps = await checkbox({
@@ -196,8 +213,9 @@ async function runCli() {
   if (plan.hooks.length) console.log(`  Hooks   : ${plan.hooks.map((h) => h.name).join(", ")}`);
   if (plan.ruleCategories.length) console.log(`  Rules   : ${plan.ruleCategories.join(", ")}`);
   if (plan.mcps.length) console.log(`  MCPs    : ${plan.mcps.map((m) => m.name).join(", ")}`);
+  if (plan.claudemds.length) console.log(`  ClaudeMd: ${plan.claudemds.map((c) => c.name).join(", ")}`);
   console.log("");
-  const totalItems = plan.agents.length + plan.skills.length + plan.commands.length + plan.hooks.length + plan.ruleCategories.length + plan.mcps.length;
+  const totalItems = plan.agents.length + plan.skills.length + plan.commands.length + plan.hooks.length + plan.ruleCategories.length + plan.mcps.length + plan.claudemds.length;
   if (totalItems === 0) {
     console.log(chalk.yellow("  Nothing selected. Exiting."));
     return;
@@ -235,6 +253,10 @@ async function runCli() {
       spinner.text = "Installing MCP servers...";
       await installMcps(plan.mcps, plan.scope, plan.mcpEnvValues);
     }
+    if (plan.claudemds.length) {
+      spinner.text = "Installing claudemd...";
+      await installClaudemd(plan.claudemds, targetDir);
+    }
     spinner.succeed(chalk.green("Installation complete!"));
     console.log("");
     if (plan.agents.length) console.log(`  ${chalk.green("\u2713")} ${plan.agents.length} agent(s) \u2192 ${join(targetDir, "agents")}`);
@@ -243,6 +265,7 @@ async function runCli() {
     if (plan.hooks.length) console.log(`  ${chalk.green("\u2713")} ${plan.hooks.length} hook(s) \u2192 ${join(targetDir, "hooks")}`);
     if (plan.ruleCategories.length) console.log(`  ${chalk.green("\u2713")} Rules appended \u2192 ${join(targetDir, "CLAUDE.md")}`);
     if (plan.mcps.length) console.log(`  ${chalk.green("\u2713")} ${plan.mcps.length} MCP server(s) \u2192 ${scope === "global" ? "~/.claude.json" : "./.claude.json"}`);
+    if (plan.claudemds.length) console.log(`  ${chalk.green("\u2713")} ClaudeMd appended \u2192 ${join(targetDir, "CLAUDE.md")}`);
     console.log("");
     if (skippedMcps.size > 0) {
       console.log(chalk.yellow("  \u26A0  The following MCP servers have placeholder env vars:"));

package/dist/index.js

@@ -51,33 +51,38 @@ Installing all to ${targetDir}...
       { getHooks },
       { getRuleCategories },
       { getMcpServers },
+      { getClaudemdItems },
       { installAgents },
       { installSkills },
       { installCommands },
       { installHooks },
       { installRules },
-      { installMcps }
+      { installMcps },
+      { installClaudemd }
     ] = await Promise.all([
-      import("./registry-EGXWYWWK.js"),
-      import("./registry-EGXWYWWK.js"),
-      import("./registry-EGXWYWWK.js"),
-      import("./registry-EGXWYWWK.js"),
-      import("./registry-EGXWYWWK.js"),
-      import("./registry-EGXWYWWK.js"),
+      import("./registry-BU55RMHU.js"),
+      import("./registry-BU55RMHU.js"),
+      import("./registry-BU55RMHU.js"),
+      import("./registry-BU55RMHU.js"),
+      import("./registry-BU55RMHU.js"),
+      import("./registry-BU55RMHU.js"),
+      import("./registry-BU55RMHU.js"),
       import("./agents-AEKT67A6.js"),
       import("./skills-ULMW3UCM.js"),
       import("./commands-P5LILVZ5.js"),
       import("./hooks-IIG2XK4I.js"),
       import("./rules-2CPBVNNJ.js"),
-      import("./mcps-67Q7TBGW.js")
+      import("./mcps-67Q7TBGW.js"),
+      import("./claudemd-KKQ2DL7P.js")
     ]);
-    const [agents, skills, commands, hooks, ruleCategories, mcps] = await Promise.all([
+    const [agents, skills, commands, hooks, ruleCategories, mcps, claudemds] = await Promise.all([
       getAgents(),
       getSkills(),
       getCommands(),
       getHooks(),
       getRuleCategories(),
-      getMcpServers()
+      getMcpServers(),
+      getClaudemdItems()
     ]);
     spinner.text = "Installing agents...";
     await installAgents(agents, targetDir);
@@ -92,6 +97,8 @@ Installing all to ${targetDir}...
     await installRules(ruleCategories.map((rc) => rc.category), claudeMd);
     spinner.text = "Installing MCP servers...";
     await installMcps(mcps, scope, /* @__PURE__ */ new Map());
+    spinner.text = "Installing claudemd...";
+    await installClaudemd(claudemds, targetDir);
     spinner.succeed(chalk.green("All items installed successfully!"));
     console.log(`
   ${chalk.green("\u2713")} ${agents.length} agents`);
@@ -99,7 +106,8 @@ Installing all to ${targetDir}...
     console.log(`  ${chalk.green("\u2713")} ${commands.length} commands`);
     console.log(`  ${chalk.green("\u2713")} ${hooks.length} hooks`);
     console.log(`  ${chalk.green("\u2713")} Rules (${ruleCategories.length} categories)`);
-    console.log(`  ${chalk.green("\u2713")} ${mcps.length} MCP servers
+    console.log(`  ${chalk.green("\u2713")} ${mcps.length} MCP servers`);
+    console.log(`  ${chalk.green("\u2713")} ${claudemds.length} claudemd item(s)
 `);
   } catch (err) {
     spinner.fail("Installation failed");
@@ -117,7 +125,7 @@ async function main() {
     return;
   }
   if (args.includes("--uninstall") || args.includes("-u")) {
-    const { runUninstallCli } = await import("./uninstall-cli-KYQTJCKO.js");
+    const { runUninstallCli } = await import("./uninstall-cli-VCOZGDBM.js");
     await runUninstallCli();
     return;
   }
@@ -127,7 +135,7 @@ async function main() {
     await installAll(scope);
     return;
   }
-  const { runCli } = await import("./cli-H6IDWH7Q.js");
+  const { runCli } = await import("./cli-D2Q5QUO7.js");
   await runCli();
 }
 main().catch((err) => {

package/dist/{registry-EGXWYWWK.js → registry-BU55RMHU.js}

@@ -1,14 +1,16 @@
 import {
   getAgents,
+  getClaudemdItems,
   getCommands,
   getHooks,
   getMcpServers,
   getRuleCategories,
   getSkills
-} from "./chunk-6B46AIFM.js";
+} from "./chunk-OLLOS3GG.js";
 import "./chunk-5XOKKPAA.js";
 export {
   getAgents,
+  getClaudemdItems,
   getCommands,
   getHooks,
   getMcpServers,

package/dist/{uninstall-cli-KYQTJCKO.js → uninstall-cli-VCOZGDBM.js}

@@ -1,11 +1,12 @@
 import {
   getAgents,
+  getClaudemdItems,
   getCommands,
   getHooks,
   getMcpServers,
   getRuleCategories,
   getSkills
-} from "./chunk-6B46AIFM.js";
+} from "./chunk-OLLOS3GG.js";
 import {
   getAssetsDir,
   getGlobalDir,
@@ -16,7 +17,7 @@ import {
 import { checkbox, select, confirm } from "@inquirer/prompts";
 import chalk from "chalk";
 import ora from "ora";
-import { join as join8 } from "path";
+import { join as join9 } from "path";
 
 // src/scanner.ts
 import { readdir, readFile, access } from "fs/promises";
@@ -108,6 +109,35 @@ async function getInstalledRuleCategories(targetDir) {
   }
   return installedCategories;
 }
+async function getInstalledClaudemd(targetDir) {
+  const claudeMdPath = join(targetDir, "CLAUDE.md");
+  let content = "";
+  try {
+    await access(claudeMdPath, constants.F_OK);
+    content = await readFile(claudeMdPath, "utf-8");
+  } catch {
+    return [];
+  }
+  const installedHeaders = /* @__PURE__ */ new Set();
+  for (const line of content.split("\n")) {
+    const match = line.match(/^(#{1,2}\s+.+)/);
+    if (match) installedHeaders.add(match[1].trim());
+  }
+  const allItems = await getClaudemdItems();
+  const result = [];
+  for (const item of allItems) {
+    try {
+      const raw = await readFile(join(getAssetsDir(), "claudemd", item.file), "utf-8");
+      const itemContent = raw.replace(/^---\s*\n[\s\S]*?\n---\s*\n/, "");
+      const headerMatch = itemContent.match(/^(#{1,2}\s+.+)/m);
+      if (headerMatch && installedHeaders.has(headerMatch[1].trim())) {
+        result.push(item);
+      }
+    } catch {
+    }
+  }
+  return result;
+}
 async function getInstalledMcps(scope) {
   const filePath = getClaudeJsonPath(scope);
   let claudeJson = {};
@@ -307,6 +337,58 @@ async function uninstallMcps(serverNames, scope) {
   await writeFile3(filePath, JSON.stringify(claudeJson, null, 2) + "\n", "utf-8");
 }
 
+// src/uninstallers/claudemd.ts
+import { readFile as readFile5, writeFile as writeFile4, access as access8 } from "fs/promises";
+import { constants as constants8 } from "fs";
+import { join as join8 } from "path";
+async function uninstallClaudemd(items, targetDir) {
+  const claudeMdPath = join8(targetDir, "CLAUDE.md");
+  let existing = "";
+  try {
+    await access8(claudeMdPath, constants8.F_OK);
+    existing = await readFile5(claudeMdPath, "utf-8");
+  } catch {
+    return;
+  }
+  const headersToRemove = /* @__PURE__ */ new Set();
+  for (const item of items) {
+    try {
+      const raw = await readFile5(join8(getAssetsDir(), "claudemd", item.file), "utf-8");
+      const content = raw.replace(/^---\s*\n[\s\S]*?\n---\s*\n/, "");
+      const headerMatch = content.match(/^(#{1,2}\s+.+)/m);
+      if (headerMatch) {
+        headersToRemove.add(headerMatch[1].trim());
+      }
+    } catch {
+    }
+  }
+  if (headersToRemove.size === 0) return;
+  const lines = existing.split("\n");
+  const result = [];
+  let inRemovedSection = false;
+  let currentDepth = 0;
+  for (const line of lines) {
+    const headerMatch = line.match(/^(#{1,2})\s+/);
+    if (headerMatch) {
+      const depth = headerMatch[1].length;
+      const trimmed = line.trim();
+      if (headersToRemove.has(trimmed)) {
+        inRemovedSection = true;
+        currentDepth = depth;
+        continue;
+      }
+      if (inRemovedSection && depth <= currentDepth) {
+        inRemovedSection = false;
+      }
+    }
+    if (!inRemovedSection) {
+      result.push(line);
+    }
+  }
+  const cleaned = result.join("\n").replace(/\n{3,}/g, "\n\n");
+  await writeFile4(claudeMdPath, cleaned, "utf-8");
+}
+
 // src/uninstall-cli.ts
 function printBanner() {
   console.log(
@@ -344,16 +426,18 @@ async function runUninstallCli() {
     installedCommands,
     installedHooks,
     installedRuleCategories,
-    installedMcpNames
+    installedMcpNames,
+    installedClaudemds
   ] = await Promise.all([
     getInstalledAgents(targetDir),
     getInstalledSkills(targetDir),
     getInstalledCommands(targetDir),
     getInstalledHooks(targetDir),
     getInstalledRuleCategories(targetDir),
-    getInstalledMcps(scope)
+    getInstalledMcps(scope),
+    getInstalledClaudemd(targetDir)
   ]);
-  const totalInstalled = installedAgents.length + installedSkills.length + installedCommands.length + installedHooks.length + installedRuleCategories.length + installedMcpNames.length;
+  const totalInstalled = installedAgents.length + installedSkills.length + installedCommands.length + installedHooks.length + installedRuleCategories.length + installedMcpNames.length + installedClaudemds.length;
   if (totalInstalled === 0) {
     console.log(chalk.yellow("  Nothing installed. Exiting."));
     return;
@@ -389,6 +473,11 @@ async function runUninstallCli() {
       name: `MCPs     ${chalk.gray(`(${installedMcpNames.length} installed)`)}`,
       value: "mcps"
     });
+  if (installedClaudemds.length > 0)
+    availableCategories.push({
+      name: `ClaudeMd ${chalk.gray(`(${installedClaudemds.length} installed)`)}`,
+      value: "claudemd"
+    });
   const selectedCategories = await checkbox({
     message: "Select categories to uninstall:",
     choices: availableCategories
@@ -404,7 +493,8 @@ async function runUninstallCli() {
     commands: [],
     hooks: [],
     ruleCategories: [],
-    mcpNames: []
+    mcpNames: [],
+    claudemds: []
   };
   if (selectedCategories.includes("agents") && installedAgents.length > 0) {
     plan.agents = await checkbox({
@@ -466,7 +556,17 @@ async function runUninstallCli() {
       }))
     });
   }
-  const totalToRemove = plan.agents.length + plan.skills.length + plan.commands.length + plan.hooks.length + plan.ruleCategories.length + plan.mcpNames.length;
+  if (selectedCategories.includes("claudemd") && installedClaudemds.length > 0) {
+    plan.claudemds = await checkbox({
+      message: "Select claudemd items to uninstall:",
+      choices: installedClaudemds.map((c) => ({
+        name: `${chalk.bold(c.name.padEnd(35))} ${chalk.gray(c.description.slice(0, 55))}`,
+        value: c,
+        checked: false
+      }))
+    });
+  }
+  const totalToRemove = plan.agents.length + plan.skills.length + plan.commands.length + plan.hooks.length + plan.ruleCategories.length + plan.mcpNames.length + plan.claudemds.length;
   if (totalToRemove === 0) {
     console.log(chalk.yellow("\n  Nothing selected. Exiting."));
     return;
@@ -482,6 +582,7 @@ async function runUninstallCli() {
   if (plan.ruleCategories.length)
     console.log(`  Rules   : ${plan.ruleCategories.join(", ")}`);
   if (plan.mcpNames.length) console.log(`  MCPs    : ${plan.mcpNames.join(", ")}`);
+  if (plan.claudemds.length) console.log(`  ClaudeMd: ${plan.claudemds.map((c) => c.name).join(", ")}`);
   console.log("");
   const ok = await confirm({
     message: chalk.red("Proceed with uninstallation? This cannot be undone."),
@@ -512,13 +613,17 @@ async function runUninstallCli() {
     }
     if (plan.ruleCategories.length) {
       spinner.text = "Removing rules...";
-      const claudeMd = join8(targetDir, "CLAUDE.md");
+      const claudeMd = join9(targetDir, "CLAUDE.md");
       await uninstallRules(plan.ruleCategories, claudeMd);
     }
     if (plan.mcpNames.length) {
       spinner.text = "Removing MCP servers...";
       await uninstallMcps(plan.mcpNames, scope);
     }
+    if (plan.claudemds.length) {
+      spinner.text = "Removing claudemd...";
+      await uninstallClaudemd(plan.claudemds, targetDir);
+    }
     spinner.succeed(chalk.green("Uninstallation complete!"));
     console.log("");
     if (plan.agents.length)
@@ -533,6 +638,8 @@ async function runUninstallCli() {
       console.log(`  ${chalk.red("\u2717")} Rules removed (${plan.ruleCategories.join(", ")})`);
     if (plan.mcpNames.length)
       console.log(`  ${chalk.red("\u2717")} ${plan.mcpNames.length} MCP server(s) removed`);
+    if (plan.claudemds.length)
+      console.log(`  ${chalk.red("\u2717")} ClaudeMd removed (${plan.claudemds.map((c) => c.name).join(", ")})`);
     console.log("");
   } catch (err) {
     spinner.fail(chalk.red("Uninstallation failed"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@juho0719/cckit",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "Claude Code Harness Installer - Interactive CLI for installing Claude Code agents, skills, commands, hooks, rules, and MCP servers",
   "type": "module",
   "bin": {