heymark 1.0.2 → 1.1.1

package/README.md

@@ -14,12 +14,12 @@ AI 코딩 도구의 컨벤션을 중앙에서 관리하고, 각 도구 형식으
 
 프로젝트마다 AI 도구별 규칙 파일을 따로 작성하면 관리가 파편화된다.
 이 시스템은 단일 진실 공급원(Single Source of Truth) 원칙에 따라, 한 곳에서 작성한 규칙을 여러 AI 도구 형식으로 자동 변환한다.
-규칙을 한 번만 작성하면 Cursor, Claude Code, GitHub Copilot, OpenAI Codex 등에서 즉시 사용할 수 있다.
+규칙을 한 번만 작성하면 Cursor, Claude Code, GitHub Copilot, OpenAI Codex, Antigravity 등에서 즉시 사용할 수 있다.
 
 ## Features
 
 - **단일 소스 관리**: 마크다운 파일 하나로 모든 AI 도구의 규칙 통합 관리
-- **자동 형식 변환**: 4종 AI 도구의 네이티브 형식으로 자동 변환 (YAML frontmatter, AGENTS.md 등)
+- **자동 형식 변환**: 5종 AI 도구의 네이티브 형식으로 자동 변환 (YAML frontmatter, AGENTS.md 등)
 - **선택적 변환**: 특정 도구만 선택하여 변환 가능
 - **NPM 패키지 배포**: NPM registry를 통한 public 배포로 간편한 설치 및 버전 관리
 - **플러그인 구조**: 변환 모듈 추가만으로 새 도구 지원 확장
@@ -73,16 +73,7 @@ npm publish
 
 ## Integration
 
-### Installation
-
-```bash
-# 패키지 설치
-npm install --save-dev heymark
-```
-
-### 초기 설정 (규칙 소스 = 원격 GitHub 저장소)
-
-규칙은 **원격 GitHub 저장소(Public/Private)** 에서 읽습니다.  
+Rule/Skill은 **원격 GitHub 저장소(Public/Private)** 에서 읽습니다.  
 최초 1회만 설정하면 됩니다.
 
 ```bash
@@ -90,8 +81,6 @@ npm install --save-dev heymark
 npx heymark init <GitHub-저장소-URL>
 ```
 
-예시:
-
 ```bash
 # HTTPS (Private이면 Git credential/토큰 설정 필요)
 npx heymark init https://github.com/org/my-rules.git
@@ -103,17 +92,9 @@ npx heymark init git@github.com:org/my-rules.git
 npx heymark init https://github.com/org/my-rules.git --dir rules --branch main
 ```
 
-설정은 **`.heymark/config.json`**에, 캐시(클론된 저장소)는 `.heymark/cache/`에 생성됩니다.
-
-```gitignore
-.heymark/
-```
-
-이후 `heymark` 실행 시 해당 저장소를 clone/pull 한 뒤 `.md` 파일들을 변환합니다.
-
 ### Usage with npx
 
-설치 없이 바로 실행하거나, 설치 후 npx로 실행할 수 있습니다.  
+설치 없이 npx로 바로 실행할 수 있습니다.  
 규칙은 **원격 GitHub 저장소**에서 가져오며, 해당 저장소 안의 마크다운 파일을 각 AI 도구 형식으로 변환해 현재 프로젝트에 생성합니다.
 
 ```bash
@@ -136,29 +117,8 @@ npx heymark --clean
 npx heymark --help
 ```
 
-**설치 없이 바로 사용:**
-
-```bash
-# 설치 없이 최신 버전으로 실행
-npx heymark@latest
-```
-
-**패키지 업데이트:**
-
-```bash
-npm update heymark
-npx heymark
-```
-
-**동작 방식:**
-
-- 기본적으로 기존 생성된 파일을 삭제한 후 새로 생성합니다
-- 이를 통해 이전 버전의 파일이 남지 않고 깔끔하게 동기화됩니다
-
 ## Getting Started
 
-규칙을 작성하고 로컬에서 테스트하는 방법.
-
 ### Writing Rules
 
 규칙 소스 디렉터리(외부 레포)에 마크다운 파일 작성. YAML frontmatter로 메타데이터 정의:
@@ -199,15 +159,6 @@ node scripts/sync.js --clean
 
 ## Tool Support
 
-### Supported Tools
-
-| Tool           | Output Format               | Key Features                    |
-| :------------- | :-------------------------- | :------------------------------ |
-| Cursor         | `.cursor/rules/*.mdc`       | YAML frontmatter, glob 매칭     |
-| Claude Code    | `.claude/skills/*/SKILL.md` | 스킬 디렉토리 구조              |
-| GitHub Copilot | `.github/instructions/*.md` | applyTo 패턴 매칭               |
-| OpenAI Codex   | `AGENTS.md`                 | 단일 파일 병합 (Agent Rules v1) |
-
 ### Adding New Tools
 
 변환 모듈을 추가하면 자동 인식된다. 필수 export 인터페이스:
@@ -224,3 +175,15 @@ module.exports = {
     },
 };
 ```
+
+### Supported Tools
+
+| Tool           | Output Format                            | Key Features                                             |
+| :------------- | :--------------------------------------- | :------------------------------------------------------- |
+| Cursor         | `.cursor/rules/*.mdc`                    | YAML frontmatter (`description`, `globs`, `alwaysApply`) |
+| Claude Code    | `.claude/skills/*/SKILL.md`              | 스킬 디렉토리 구조 + YAML frontmatter                    |
+| GitHub Copilot | `.github/instructions/*.instructions.md` | `applyTo` 다중 패턴 매핑                                 |
+| OpenAI Codex   | `.agents/skills/*/SKILL.md`              | 스킬 디렉토리 구조 + YAML frontmatter                    |
+| Antigravity    | `.agent/skills/*/SKILL.md`               | 스킬 디렉토리 구조 + YAML frontmatter                    |
+
+Antigravity 스킬 파일 경로: `/.agent/skills/<skill-folder>/SKILL.md`

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "heymark",
-    "version": "1.0.2",
+    "version": "1.1.1",
     "description": "Centralized AI coding tool conventions with auto-conversion to multiple formats",
     "main": "scripts/sync.js",
     "bin": {

package/scripts/lib/config.js

@@ -32,8 +32,10 @@ function loadConfig(projectRoot) {
         }
         return {
             rulesSource: data.rulesSource.trim(),
-            branch: typeof data.branch === "string" && data.branch.trim() ? data.branch.trim() : "main",
-            rulesSourceDir: typeof data.rulesSourceDir === "string" ? data.rulesSourceDir.trim() : "",
+            branch:
+                typeof data.branch === "string" && data.branch.trim() ? data.branch.trim() : "main",
+            rulesSourceDir:
+                typeof data.rulesSourceDir === "string" ? data.rulesSourceDir.trim() : "",
         };
     } catch {
         return null;

package/scripts/lib/repo.js

@@ -14,7 +14,8 @@ const CACHE_DIR_NAME = path.join(".heymark", "cache");
 function sanitizeRepoName(url) {
     let s = url.trim();
     if (s.endsWith(".git")) s = s.slice(0, -4);
-    const match = s.match(/github\.com[:/]([^/]+\/[^/]+?)(?:\/|$)/) || s.match(/([^/]+\/[^/]+?)(?:\/|$)/);
+    const match =
+        s.match(/github\.com[:/]([^/]+\/[^/]+?)(?:\/|$)/) || s.match(/([^/]+\/[^/]+?)(?:\/|$)/);
     if (match) {
         return match[1].replace(/\//g, "-");
     }
@@ -52,10 +53,13 @@ function getRulesDirFromRepo(projectRoot, config) {
         }
     } else {
         try {
-            execSync("git fetch origin && git checkout --quiet . && git pull --quiet origin " + branch, {
-                stdio: "pipe",
-                cwd: clonePath,
-            });
+            execSync(
+                "git fetch origin && git checkout --quiet . && git pull --quiet origin " + branch,
+                {
+                    stdio: "pipe",
+                    cwd: clonePath,
+                }
+            );
         } catch (err) {
             // pull 실패 시(네트워크 등) 기존 클론 내용으로 진행
         }

package/scripts/sync.js

@@ -138,7 +138,9 @@ function runInit(initArgs) {
     }
     const config = { rulesSource: repoUrl.trim(), branch, rulesSourceDir };
     const configPath = writeConfig(PROJECT_ROOT, config);
-    console.log(`[Init] Rules source saved to ${path.relative(PROJECT_ROOT, configPath) || configPath}`);
+    console.log(
+        `[Init] Rules source saved to ${path.relative(PROJECT_ROOT, configPath) || configPath}`
+    );
     console.log(`  rulesSource: ${config.rulesSource}`);
     if (branch !== "main") console.log(`  branch: ${branch}`);
     if (rulesSourceDir) console.log(`  rulesSourceDir: ${rulesSourceDir}`);

package/scripts/tools/antigravity.js

@@ -0,0 +1,41 @@
+"use strict";
+
+const fs = require("fs");
+const path = require("path");
+
+module.exports = {
+    name: "Antigravity",
+    output: ".agent/skills/*/SKILL.md",
+
+    generate(rules, projectRoot) {
+        for (const rule of rules) {
+            const skillDir = path.join(projectRoot, ".agent", "skills", rule.name);
+            fs.mkdirSync(skillDir, { recursive: true });
+
+            const lines = [
+                "---",
+                `name: ${rule.name}`,
+                `description: "${rule.description}"`,
+                "---",
+            ];
+            const content = lines.join("\n") + "\n\n" + rule.body + "\n";
+            fs.writeFileSync(path.join(skillDir, "SKILL.md"), content);
+        }
+
+        return rules.length;
+    },
+
+    clean(ruleNames, projectRoot) {
+        const cleaned = [];
+
+        for (const name of ruleNames) {
+            const skillDir = path.join(projectRoot, ".agent", "skills", name);
+            if (fs.existsSync(skillDir)) {
+                fs.rmSync(skillDir, { recursive: true });
+                cleaned.push(path.join(".agent", "skills", name));
+            }
+        }
+
+        return cleaned;
+    },
+};

package/scripts/tools/codex.js

@@ -2,23 +2,40 @@
 
 const fs = require("fs");
 const path = require("path");
-const { writeMergedFile } = require("../lib/parser");
 
 module.exports = {
-  name: "OpenAI Codex",
-  output: "AGENTS.md",
-
-  generate(rules, projectRoot) {
-    writeMergedFile(path.join(projectRoot, "AGENTS.md"), rules);
-    return rules.length;
-  },
-
-  clean(_ruleNames, projectRoot) {
-    const filePath = path.join(projectRoot, "AGENTS.md");
-    if (fs.existsSync(filePath)) {
-      fs.unlinkSync(filePath);
-      return ["AGENTS.md"];
-    }
-    return [];
-  },
+    name: "OpenAI Codex",
+    output: ".agents/skills/*/SKILL.md",
+
+    generate(rules, projectRoot) {
+        for (const rule of rules) {
+            const skillDir = path.join(projectRoot, ".agents", "skills", rule.name);
+            fs.mkdirSync(skillDir, { recursive: true });
+
+            const lines = [
+                "---",
+                `name: ${rule.name}`,
+                `description: "${rule.description}"`,
+                "---",
+            ];
+            const content = lines.join("\n") + "\n\n" + rule.body + "\n";
+            fs.writeFileSync(path.join(skillDir, "SKILL.md"), content);
+        }
+
+        return rules.length;
+    },
+
+    clean(ruleNames, projectRoot) {
+        const cleaned = [];
+
+        for (const name of ruleNames) {
+            const skillDir = path.join(projectRoot, ".agents", "skills", name);
+            if (fs.existsSync(skillDir)) {
+                fs.rmSync(skillDir, { recursive: true });
+                cleaned.push(path.join(".agents", "skills", name));
+            }
+        }
+
+        return cleaned;
+    },
 };

package/scripts/tools/copilot.js

@@ -4,45 +4,38 @@ const fs = require("fs");
 const path = require("path");
 
 module.exports = {
-  name: "GitHub Copilot",
-  output: ".github/instructions/*.instructions.md",
-
-  generate(rules, projectRoot) {
-    const destDir = path.join(projectRoot, ".github", "instructions");
-    fs.mkdirSync(destDir, { recursive: true });
-
-    for (const rule of rules) {
-      const globs = rule.globs
-        ? rule.globs.split(",").map((g) => g.trim())
-        : ["**"];
-
-      const applyToLines = globs.map((g) => `  - "${g}"`).join("\n");
-      const header = `applyTo:\n${applyToLines}\n---`;
-
-      const content = header + "\n\n" + rule.body + "\n";
-      fs.writeFileSync(
-        path.join(destDir, `${rule.name}.instructions.md`),
-        content
-      );
-    }
-
-    return rules.length;
-  },
-
-  clean(ruleNames, projectRoot) {
-    const cleaned = [];
-    const destDir = path.join(projectRoot, ".github", "instructions");
-
-    for (const name of ruleNames) {
-      const filePath = path.join(destDir, `${name}.instructions.md`);
-      if (fs.existsSync(filePath)) {
-        fs.unlinkSync(filePath);
-        cleaned.push(
-          path.join(".github", "instructions", `${name}.instructions.md`)
-        );
-      }
-    }
-
-    return cleaned;
-  },
+    name: "GitHub Copilot",
+    output: ".github/instructions/*.instructions.md",
+
+    generate(rules, projectRoot) {
+        const destDir = path.join(projectRoot, ".github", "instructions");
+        fs.mkdirSync(destDir, { recursive: true });
+
+        for (const rule of rules) {
+            const globs = rule.globs ? rule.globs.split(",").map((g) => g.trim()) : ["**"];
+
+            const applyToLines = globs.map((g) => `  - "${g}"`).join("\n");
+            const header = `applyTo:\n${applyToLines}\n---`;
+
+            const content = header + "\n\n" + rule.body + "\n";
+            fs.writeFileSync(path.join(destDir, `${rule.name}.instructions.md`), content);
+        }
+
+        return rules.length;
+    },
+
+    clean(ruleNames, projectRoot) {
+        const cleaned = [];
+        const destDir = path.join(projectRoot, ".github", "instructions");
+
+        for (const name of ruleNames) {
+            const filePath = path.join(destDir, `${name}.instructions.md`);
+            if (fs.existsSync(filePath)) {
+                fs.unlinkSync(filePath);
+                cleaned.push(path.join(".github", "instructions", `${name}.instructions.md`));
+            }
+        }
+
+        return cleaned;
+    },
 };

package/scripts/tools/cursor.js

@@ -4,38 +4,38 @@ const fs = require("fs");
 const path = require("path");
 
 module.exports = {
-  name: "Cursor",
-  output: ".cursor/rules/*.mdc",
-
-  generate(rules, projectRoot) {
-    const destDir = path.join(projectRoot, ".cursor", "rules");
-    fs.mkdirSync(destDir, { recursive: true });
-
-    for (const rule of rules) {
-      const lines = ["---", `description: "${rule.description}"`];
-      if (rule.globs) lines.push(`globs: "${rule.globs}"`);
-      lines.push(`alwaysApply: ${rule.alwaysApply}`);
-      lines.push("---");
-
-      const content = lines.join("\n") + "\n\n" + rule.body + "\n";
-      fs.writeFileSync(path.join(destDir, `${rule.name}.mdc`), content);
-    }
-
-    return rules.length;
-  },
-
-  clean(ruleNames, projectRoot) {
-    const cleaned = [];
-    const destDir = path.join(projectRoot, ".cursor", "rules");
-
-    for (const name of ruleNames) {
-      const filePath = path.join(destDir, `${name}.mdc`);
-      if (fs.existsSync(filePath)) {
-        fs.unlinkSync(filePath);
-        cleaned.push(path.join(".cursor", "rules", `${name}.mdc`));
-      }
-    }
-
-    return cleaned;
-  },
+    name: "Cursor",
+    output: ".cursor/rules/*.mdc",
+
+    generate(rules, projectRoot) {
+        const destDir = path.join(projectRoot, ".cursor", "rules");
+        fs.mkdirSync(destDir, { recursive: true });
+
+        for (const rule of rules) {
+            const lines = ["---", `description: "${rule.description}"`];
+            if (rule.globs) lines.push(`globs: "${rule.globs}"`);
+            lines.push(`alwaysApply: ${rule.alwaysApply}`);
+            lines.push("---");
+
+            const content = lines.join("\n") + "\n\n" + rule.body + "\n";
+            fs.writeFileSync(path.join(destDir, `${rule.name}.mdc`), content);
+        }
+
+        return rules.length;
+    },
+
+    clean(ruleNames, projectRoot) {
+        const cleaned = [];
+        const destDir = path.join(projectRoot, ".cursor", "rules");
+
+        for (const name of ruleNames) {
+            const filePath = path.join(destDir, `${name}.mdc`);
+            if (fs.existsSync(filePath)) {
+                fs.unlinkSync(filePath);
+                cleaned.push(path.join(".cursor", "rules", `${name}.mdc`));
+            }
+        }
+
+        return cleaned;
+    },
 };