Merge pull request #34 from itsflaid/codex/ignore-agent-skills-snapshot

Ignore agent metadata in snapshots

Author: itsflaid

docs/for-me-personal/DEBUG.md

@@ -928,3 +928,37 @@ static route `/index.html`.
 Jangan memakai `latest` untuk dependency framework pada repo yang memiliki
 target Node eksplisit. Cek engine package yang ter-resolve di lockfile sebelum
 menganggap build lokal cukup aman untuk CI.
+
+## 18. Agent Skills Terdeteksi Sebagai Fitur AI Project
+
+**Tanggal:** 2026-06-18
+**Status:** Selesai
+
+### Gejala
+
+Snapshot DevMap mendeteksi `.agents/skills` sebagai bagian project dan
+menganggap skill development agent sebagai sistem AI terintegrasi. Padahal
+folder tersebut hanya dipakai untuk instruksi agent saat mengembangkan DevMap.
+
+### Akar Masalah
+
+Scanner belum mengabaikan folder metadata agent development. Akibatnya file
+seperti `.agents/skills/*/SKILL.md` ikut terbaca oleh analyzer fitur dan service.
+
+### Solusi
+
+- Tambahkan `.agent` dan `.agents` ke ignore directory scanner.
+- Tambahkan test scanner untuk memastikan `.agents/skills` tidak masuk hasil
+  scan.
+
+### Verifikasi
+
+```powershell
+pnpm --filter devmap exec tsx --test test/analyzers.test.ts
+```
+
+### Pelajaran
+
+Folder dotfile yang dipakai alat development dapat berisi kata kunci AI, auth,
+atau service. Scanner harus membedakan metadata development dari source project
+agar snapshot tetap merepresentasikan aplikasi yang dianalisis.

docs/for-me-personal/PROGRESS.md

@@ -903,3 +903,17 @@ node packages\cli\dist\index.js doctor
 4. Tambahkan abstraction AI client dan model routing.
 5. Tambahkan Context Builder dengan batas 3–5 file.
 6. Tambahkan prompt template untuk `analyze` dan `ask`.
+
+## Snapshot Scanner Ignore: Agent Development Metadata
+
+**Tanggal:** 2026-06-18
+
+DevMap sekarang mengabaikan folder `.agent/` dan `.agents/` saat scan project.
+Folder tersebut dipakai untuk metadata/skill AI agent saat development dan
+tidak boleh muncul sebagai fitur produk di snapshot.
+
+Verifikasi:
+
+```powershell
+pnpm --filter devmap exec tsx --test test/analyzers.test.ts
+```

docs/for-me-personal/TEST.md

@@ -387,6 +387,12 @@ Analyzer dan snapshot:
 pnpm --filter devmap exec tsx --test test/analyzers.test.ts
 ```
 
+Expected tambahan:
+
+- `.agent/` dan `.agents/` tidak masuk hasil scan;
+- `.agents/skills/*/SKILL.md` tidak terdeteksi sebagai fitur AI project;
+- snapshot tetap hanya merepresentasikan source project yang dianalisis.
+
 AI client:
 
 ```powershell

packages/cli/src/analyzers/filterEngine.ts

@@ -1,6 +1,8 @@
 const IGNORED_DIRECTORIES = new Set([
   ".git",
   ".devmap",
+  ".agent",
+  ".agents",
   ".next",
   ".turbo",
   ".vercel",

packages/cli/test/analyzers.test.ts

@@ -33,6 +33,28 @@ test("scanner ignores generated and secret paths", async () => {
   assert.ok(!paths.some((path) => path.startsWith(".env")));
 });
 
+test("scanner ignores agent development metadata", async () => {
+  const projectRoot = await mkdtemp(join(tmpdir(), "devmap-agent-metadata-test-"));
+
+  try {
+    await writeFile(join(projectRoot, "package.json"), JSON.stringify({ name: "agent-metadata-test" }));
+    await mkdir(join(projectRoot, "src"), { recursive: true });
+    await writeFile(join(projectRoot, "src", "index.ts"), "export const app = true;\n");
+    await mkdir(join(projectRoot, ".agents", "skills", "ai-helper"), { recursive: true });
+    await writeFile(
+      join(projectRoot, ".agents", "skills", "ai-helper", "SKILL.md"),
+      "# AI Helper\n\nThis development-only skill mentions OpenAI, Groq, and agents.\n"
+    );
+
+    const paths = (await scanFiles(projectRoot)).map((file) => file.path);
+
+    assert.ok(paths.includes("src/index.ts"));
+    assert.ok(!paths.some((path) => path.startsWith(".agents/")));
+  } finally {
+    await rm(projectRoot, { recursive: true, force: true });
+  }
+});
+
 test("scanner ignores package manager lockfiles", () => {
   for (const lockfile of [
     "package-lock.json",