@ofelixdev/cc-kit 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ofelixdev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,149 @@
+# cc-kit
+
+CLI que instala uma knowledge base completa no Claude Code — agents, skills, workflows, scripts de validacao.
+
+Um comando e seu Claude Code ganha **20 agents especialistas**, **37+ skills**, **11 workflows** e **scripts Python de validacao**. Tudo vai pra `.claude/` do seu projeto.
+
+---
+
+## O que e isso?
+
+O Claude Code por padrao nao sabe nada sobre seu projeto. Ele e poderoso, mas generico.
+
+O **cc-kit** resolve isso instalando uma base de conhecimento curada dentro do `.claude/` — agents que funcionam como especialistas (backend, frontend, seguranca, mobile, etc), skills com patterns e boas praticas, workflows pra tarefas estruturadas, e scripts Python pra validacao automatica.
+
+Basicamente: **seu Claude Code vira um time de especialistas**.
+
+---
+
+## Instalacao
+
+```bash
+npx @ofelixdev/cc-kit init
+```
+
+Ou global:
+
+```bash
+npm i -g @ofelixdev/cc-kit
+cc-kit init
+```
+
+---
+
+## O que instala
+
+```
+.claude/
+├── agents/           # 20 agents especialistas (.md)
+├── skills/           # 37+ skills com patterns e boas praticas
+├── workflows/        # 11 workflows estruturados
+├── scripts/          # Scripts Python de validacao (checklist, verify_all, etc)
+├── rules/CLAUDE.md   # Regras estendidas de coding standards
+├── .shared/          # Dados compartilhados (UI/UX datasets, etc)
+├── ARCHITECTURE.md   # Indice completo da knowledge base
+└── mcp_config.json   # Config MCP servers (com placeholder API key)
+
+CLAUDE.md             # Regras do projeto na raiz (criado se nao existir)
+```
+
+---
+
+## Comandos
+
+### `cc-kit init`
+
+Baixa e instala a knowledge base no `.claude/`.
+
+- **Merge inteligente**: se `.claude/` ja existe, faz merge — seu conteudo existente e preservado
+- **Paths protegidos**: `settings.json`, `settings.local.json`, `plans/`, `memory/`, `projects/` **nunca** sao tocados
+- `CLAUDE.md` da raiz so e criado se nao existir (use `--force` pra sobrescrever)
+
+```bash
+cc-kit init                        # Instala no diretorio atual
+cc-kit init --force                # Sobrescreve tudo, incluindo CLAUDE.md da raiz
+cc-kit init --path ./meu-projeto   # Instala em outro diretorio
+cc-kit init --dry-run              # Mostra o que seria feito sem escrever nada
+cc-kit init --quiet                # Sem output
+cc-kit init --branch dev           # Baixa de uma branch especifica
+```
+
+### `cc-kit update`
+
+Re-baixa e sobrescreve a knowledge base (equivalente a `init --force`).
+
+```bash
+cc-kit update
+```
+
+### `cc-kit status`
+
+Mostra info da instalacao e contagem de arquivos.
+
+```bash
+cc-kit status
+```
+
+---
+
+## O que vem dentro
+
+### Agents (20)
+
+Arquivos de conhecimento especialista que o Claude le on-demand:
+
+`orchestrator` · `project-planner` · `security-auditor` · `backend-specialist` · `frontend-specialist` · `mobile-developer` · `debugger` · `game-developer` · `test-engineer` · `database-architect` · `devops-engineer` · `performance-optimizer` · `seo-specialist` · `penetration-tester` · `documentation-writer` · `qa-automation-engineer` · `code-archaeologist` · `explorer-agent` · `product-manager` · `product-owner`
+
+### Skills (37+)
+
+Patterns, boas praticas e conhecimento por dominio:
+
+`clean-code` · `api-patterns` · `database-design` · `frontend-design` · `mobile-design` · `testing-patterns` · `vulnerability-scanner` · `brainstorming` · `plan-writing` · `architecture` · `tailwind-patterns` · `nextjs-react-expert` · `nodejs-best-practices` · `python-patterns` · `rust-pro` · `bash-linux` · `game-development` · `seo-fundamentals` · `performance-profiling` · `webapp-testing` · `tdd-workflow` · `code-review-checklist` · `deployment-procedures` · `mcp-builder` · e mais...
+
+### Workflows (11)
+
+Fluxos estruturados de execucao de tarefas:
+
+`brainstorm` · `create` · `debug` · `deploy` · `enhance` · `orchestrate` · `plan` · `preview` · `status` · `test` · `ui-ux-pro-max`
+
+### Scripts de Validacao
+
+Scripts Python pra rodar checks no seu projeto:
+
+```bash
+python .claude/scripts/checklist.py .              # Validacao por prioridade
+python .claude/scripts/verify_all.py . --url <URL> # Suite completa pre-deploy
+```
+
+---
+
+## Como funciona
+
+1. Baixa o template do GitHub via [giget](https://github.com/unjs/giget)
+2. Faz merge dos agents, skills, workflows e scripts no `.claude/`
+3. Cria um `CLAUDE.md` generico na raiz do projeto (se nao existir)
+4. Nunca toca em configs do usuario (settings, memory, plans)
+
+---
+
+## Pre-requisitos
+
+- **Node.js** 18+ (pra rodar o CLI)
+- **Python** 3.10+ (pra rodar os scripts de validacao — opcional)
+- **Claude Code** CLI instalado (o que vai consumir a knowledge base)
+
+---
+
+## Creditos
+
+Este projeto foi inspirado no [`@vudovn/ag-kit`](https://www.npmjs.com/package/@vudovn/ag-kit) (Antigravity Kit), que instala agents/skills/workflows pro Gemini CLI no diretorio `.agent/`.
+
+O **cc-kit** adapta esse mesmo conceito pro ecossistema **Claude Code** — todo o conteudo foi reescrito e adaptado pra funcionar com a estrutura `.claude/`, sem nenhuma referencia ao Gemini ou Antigravity.
+
+Obrigado ao [@vudovn](https://github.com/vudovn) pela ideia original e pelo trabalho no ag-kit.
+
+---
+
+## Licenca
+
+MIT

package/bin/index.js

@@ -0,0 +1,246 @@
+#!/usr/bin/env node
+
+import { Command } from 'commander';
+import chalk from 'chalk';
+import ora from 'ora';
+import fs from 'fs-extra';
+import path from 'path';
+import { downloadTemplate } from 'giget';
+import { fileURLToPath } from 'url';
+
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+
+const VERSION = '1.0.0';
+const REPO = 'github:ofelixdev/cc-kit/template';
+const TARGET_DIR = '.claude';
+const ROOT_CLAUDE_MD = 'CLAUDE.md';
+
+const PROTECTED_PATHS = [
+  'settings.json',
+  'settings.local.json',
+  'plans',
+  'memory',
+  'projects',
+];
+
+const MERGE_DIRS = [
+  'agents',
+  'skills',
+  'workflows',
+  'scripts',
+  'rules',
+  '.shared',
+];
+
+const MERGE_FILES = [
+  'ARCHITECTURE.md',
+  'mcp_config.json',
+];
+
+function resolveTarget(optPath) {
+  const base = optPath || process.cwd();
+  return {
+    root: path.resolve(base),
+    claude: path.resolve(base, TARGET_DIR),
+  };
+}
+
+function isProtected(relativePath) {
+  return PROTECTED_PATHS.some(
+    (p) => relativePath === p || relativePath.startsWith(p + '/')
+  );
+}
+
+async function mergeDir(src, dest) {
+  let copied = 0;
+  const entries = await fs.readdir(src, { withFileTypes: true });
+
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const destPath = path.join(dest, entry.name);
+
+    if (entry.isDirectory()) {
+      await fs.ensureDir(destPath);
+      copied += await mergeDir(srcPath, destPath);
+    } else {
+      await fs.copy(srcPath, destPath, { overwrite: true });
+      copied++;
+    }
+  }
+
+  return copied;
+}
+
+async function installTemplate({ force, targetPath, branch, quiet, dryRun }) {
+  const { root, claude } = resolveTarget(targetPath);
+  const claudeExists = await fs.pathExists(claude);
+  const rootMdExists = await fs.pathExists(path.join(root, ROOT_CLAUDE_MD));
+
+  if (!quiet) {
+    console.log(chalk.bold('\n  cc-kit') + chalk.dim(' — Claude Code Knowledge Base\n'));
+  }
+
+  if (claudeExists && !force) {
+    if (!quiet) {
+      console.log(chalk.yellow('  .claude/ already exists — merging (protected files untouched)'));
+    }
+  }
+
+  if (dryRun) {
+    console.log(chalk.cyan('\n  Dry run — no files will be written.\n'));
+    console.log(chalk.dim('  Would download template from: ') + REPO);
+    console.log(chalk.dim('  Would install to: ') + claude);
+    if (!rootMdExists || force) {
+      console.log(chalk.dim('  Would create: ') + path.join(root, ROOT_CLAUDE_MD));
+    }
+    return;
+  }
+
+  const spinner = quiet ? null : ora('Downloading template...').start();
+  let tempDir;
+
+  try {
+    const source = branch ? `${REPO}#${branch}` : REPO;
+    const result = await downloadTemplate(source, { force: true });
+    tempDir = result.dir;
+
+    if (spinner) spinner.text = 'Installing knowledge base...';
+
+    await fs.ensureDir(claude);
+
+    let totalCopied = 0;
+
+    for (const dir of MERGE_DIRS) {
+      const src = path.join(tempDir, dir);
+      if (await fs.pathExists(src)) {
+        const dest = path.join(claude, dir);
+        await fs.ensureDir(dest);
+        totalCopied += await mergeDir(src, dest);
+      }
+    }
+
+    for (const file of MERGE_FILES) {
+      const src = path.join(tempDir, file);
+      if (await fs.pathExists(src)) {
+        await fs.copy(src, path.join(claude, file), { overwrite: true });
+        totalCopied++;
+      }
+    }
+
+    if (!rootMdExists || force) {
+      const templateMd = path.join(tempDir, ROOT_CLAUDE_MD);
+      if (await fs.pathExists(templateMd)) {
+        await fs.copy(templateMd, path.join(root, ROOT_CLAUDE_MD), { overwrite: force });
+        if (!quiet) {
+          console.log(chalk.dim(`  ${force ? 'Overwrote' : 'Created'} ${ROOT_CLAUDE_MD} in project root`));
+        }
+      }
+    } else if (!quiet) {
+      console.log(chalk.dim(`  ${ROOT_CLAUDE_MD} already exists — skipped (use --force to overwrite)`));
+    }
+
+    if (spinner) spinner.succeed(chalk.green(`Installed ${totalCopied} files into ${TARGET_DIR}/`));
+
+    if (!quiet) {
+      console.log('');
+      console.log(chalk.dim('  Agents:    ') + await countItems(path.join(claude, 'agents')));
+      console.log(chalk.dim('  Skills:    ') + await countItems(path.join(claude, 'skills')));
+      console.log(chalk.dim('  Workflows: ') + await countItems(path.join(claude, 'workflows')));
+      console.log(chalk.dim('  Scripts:   ') + await countItems(path.join(claude, 'scripts')));
+      console.log('');
+      console.log(chalk.green('  Done!') + chalk.dim(' Run ') + chalk.cyan('cc-kit status') + chalk.dim(' to verify.'));
+      console.log('');
+    }
+  } catch (err) {
+    if (spinner) spinner.fail(chalk.red('Installation failed'));
+    console.error(chalk.red(`\n  Error: ${err.message}\n`));
+    process.exit(1);
+  } finally {
+    if (tempDir) {
+      await fs.remove(tempDir).catch(() => {});
+    }
+  }
+}
+
+async function countItems(dir) {
+  try {
+    const entries = await fs.readdir(dir);
+    return String(entries.length);
+  } catch {
+    return '0';
+  }
+}
+
+async function showStatus(targetPath) {
+  const { claude } = resolveTarget(targetPath);
+
+  console.log(chalk.bold('\n  cc-kit status\n'));
+
+  const exists = await fs.pathExists(path.join(claude, 'agents'));
+
+  if (!exists) {
+    console.log(chalk.yellow('  Not installed.') + chalk.dim(' Run ') + chalk.cyan('cc-kit init') + chalk.dim(' to install.\n'));
+    return;
+  }
+
+  console.log(chalk.dim('  Path:      ') + claude);
+
+  try {
+    const stat = await fs.stat(path.join(claude, 'agents'));
+    console.log(chalk.dim('  Modified:  ') + stat.mtime.toISOString().slice(0, 19).replace('T', ' '));
+  } catch {}
+
+  console.log('');
+  console.log(chalk.dim('  Agents:    ') + await countItems(path.join(claude, 'agents')));
+  console.log(chalk.dim('  Skills:    ') + await countItems(path.join(claude, 'skills')));
+  console.log(chalk.dim('  Workflows: ') + await countItems(path.join(claude, 'workflows')));
+  console.log(chalk.dim('  Scripts:   ') + await countItems(path.join(claude, 'scripts')));
+  console.log(chalk.dim('  Rules:     ') + await countItems(path.join(claude, 'rules')));
+  console.log('');
+}
+
+const program = new Command();
+
+program
+  .name('cc-kit')
+  .description('Claude Code knowledge base installer — agents, skills, workflows')
+  .version(VERSION);
+
+program
+  .command('init')
+  .description('Install or merge the Claude Code knowledge base into .claude/')
+  .option('-f, --force', 'Overwrite existing files including root CLAUDE.md')
+  .option('-p, --path <dir>', 'Target project directory (default: cwd)')
+  .option('-b, --branch <name>', 'GitHub branch to download from')
+  .option('-q, --quiet', 'Suppress output')
+  .option('--dry-run', 'Show what would be done without writing files')
+  .action((opts) => installTemplate({
+    force: opts.force,
+    targetPath: opts.path,
+    branch: opts.branch,
+    quiet: opts.quiet,
+    dryRun: opts.dryRun,
+  }));
+
+program
+  .command('update')
+  .description('Re-download and overwrite the knowledge base (force merge)')
+  .option('-p, --path <dir>', 'Target project directory (default: cwd)')
+  .option('-b, --branch <name>', 'GitHub branch to download from')
+  .option('-q, --quiet', 'Suppress output')
+  .action((opts) => installTemplate({
+    force: true,
+    targetPath: opts.path,
+    branch: opts.branch,
+    quiet: opts.quiet,
+    dryRun: false,
+  }));
+
+program
+  .command('status')
+  .description('Show installation status and counts')
+  .option('-p, --path <dir>', 'Target project directory (default: cwd)')
+  .action((opts) => showStatus(opts.path));
+
+program.parse();

package/package.json

@@ -0,0 +1,35 @@
+{
+  "name": "@ofelixdev/cc-kit",
+  "version": "1.0.0",
+  "type": "module",
+  "description": "Claude Code knowledge base installer - agents, skills, workflows",
+  "main": "bin/index.js",
+  "bin": {
+    "cc-kit": "bin/index.js"
+  },
+  "files": [
+    "bin"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "ai",
+    "agents",
+    "skills",
+    "knowledge-base",
+    "cli"
+  ],
+  "author": "ofelixdev",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ofelixdev/cc-kit.git"
+  },
+  "dependencies": {
+    "chalk": "^5.4.1",
+    "commander": "^12.1.0",
+    "fs-extra": "^11.3.0",
+    "giget": "^2.0.0",
+    "ora": "^8.2.0"
+  }
+}