@kybird/llm-wiki 0.2.0 → 0.2.2

package/README.md

@@ -73,6 +73,7 @@ your-repo/
 │       ├── cards/         # active: todo / doing / review (frontmatter status)
 │       ├── done/ superseded/ abandoned/   # termination = the folder
 │       └── activity.jsonl # append-only audit log (10k line cap)
+├── AGENTS.md             # seeded once if absent — "which skill when" for every session
 ├── .agents/skills/        # canonical skills (ZCode, Cursor, …)
 ├── .claude/skills/        # mirror for Claude Code
 ├── scripts/               # doc/skill sync scripts (marker-protected copies)

package/lib/init.js

@@ -179,6 +179,16 @@ function init(options = {}) {
     console.log('✓ Created doc/kanban/ (board.yml, cards/, done/, superseded/, abandoned/, activity.jsonl)');
   }
 
+  // 1c. AGENTS.md 시드 — 매 세션이 무조건 읽는 파일에 "언제 어떤 스킬"을 심는다.
+  //     존재하면 절대 건드리지 않는다: 갱신은 레포의 몫 (plan.md 6.4 — 각 레포가 직접 쓴다).
+  const agentsPath = path.join(cwd, 'AGENTS.md');
+  if (!exists(agentsPath)) {
+    fs.copyFileSync(path.join(PKG_ROOT, 'templates', 'AGENTS.md'), agentsPath);
+    console.log('✓ Created AGENTS.md (seed — 이 레포의 것으로 자유롭게 편집)');
+  } else {
+    console.log('✓ AGENTS.md already exists, untouched.');
+  }
+
   // 2. skills/ (정본 → 복사본). 마커 규칙: skill-version이 살아있는 복사본만 갱신하고,
   //    마커를 지운 파일(사용자 수정)은 건너뛴다 — syncSkills 주석 참고.
   const skillsSrc = path.join(PKG_ROOT, 'skills');

package/lib/wiki-compile.js

@@ -42,6 +42,13 @@ function loadCompileState(wikiRoot) {
   }
 }
 
+// "오늘"은 현지 날짜로 — raw 로그 헤더(# YYYY-MM-DD)가 현지 날짜로 쓰이므로
+// UTC 기준과 섞으면 KST 자정~9시 사이에 전부 "new"로 재보고된다(2026-08-30 실측).
+function localToday(date = new Date()) {
+  const pad = n => String(n).padStart(2, '0');
+  return `${date.getFullYear()}-${pad(date.getMonth() + 1)}-${pad(date.getDate())}`;
+}
+
 // 상태 재생성 — compile index 말미에서만 호출된다 (컴파일 완료 선언의 기록).
 function writeCompileState(wikiRoot, rawRoot, lastCompiled, previous) {
   const files = {};
@@ -189,7 +196,7 @@ function rebuildIndex() {
   // 컴파일 상태 — 여기가 유일한 쓰기점. lastCompiled 단조 가드(max)로 시계 오차
   // 머신이 날짜를 미래로 점프시키지 않게 하고, index.md의 Last updated와 같은 값을 쓴다.
   const previous = loadCompileState(wikiRoot);
-  const today = new Date().toISOString().split('T')[0];
+  const today = localToday();
   const lastCompiled = previous && previous.lastCompiled > today ? previous.lastCompiled : today;
   indexContent += `- Last updated: ${lastCompiled}\n`;
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kybird/llm-wiki",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "LLM-friendly knowledge graph + kanban for AI coding agents. Raw daily logs → compiled wiki → merged semantic+grep search, and a card-per-file kanban the work-loop skill consumes unattended. Drop-in for any repo.",
   "license": "MIT",
   "author": "kybird",

package/templates/AGENTS.md

@@ -0,0 +1,24 @@
+# AGENTS.md
+
+<!-- Seeded by `llm-wiki init`. This file is YOURS — edit freely; init never overwrites it. -->
+
+This repo uses **llm-wiki**: `doc/` is the knowledge base, `doc/kanban/` is the work board.
+Files are the source of truth. Kanban card files are written ONLY via the CLI — people read them.
+
+## Skill usage — when to use what
+
+| Moment | Skill / command |
+|---|---|
+| Before starting any task | `llm-wiki search "<keywords>"` — paste the verbatim error string when debugging |
+| After fixing a bug / making a decision / discovering something | `wiki-log` skill → a Case in `doc/raw/YYYY-MM-DD.md` with verbatim error + `hash:` grounding |
+| When raw logs have accumulated | `wiki-compile` skill → promote to `doc/wiki/` pages, then `llm-wiki compile index` |
+| Sanity check of the knowledge base | `wiki-lint` skill or `llm-wiki lint` |
+| Planning work (person present) | `kanban-plan` skill → cards via `llm-wiki card new "<title>"` |
+| Unattended execution | `work-loop` skill → `llm-wiki pick --claim <name>`, park judgment calls with `handoff` |
+
+## Rules
+
+- Quote error messages **character-for-character** in logs and wiki pages — `llm-wiki lint`
+  back-checks every quote and `hash:` against `doc/raw/`.
+- Follow `status: deprecated` → `superseded_by` when reading wiki pages.
+- Expand this file with this repo's own conventions. Keep it short — it loads every session.