lee-spec-kit 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Lee Yoonsu
+
+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,112 @@
+# lee-spec-kit
+
+프로젝트 문서 구조 생성기 - AI 에이전트 기반 개발을 위한 docs 템플릿 CLI
+
+[![npm version](https://img.shields.io/npm/v/lee-spec-kit.svg)](https://www.npmjs.com/package/lee-spec-kit)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+
+## 설치
+
+```bash
+# npx로 바로 사용
+npx lee-spec-kit init
+
+# 또는 전역 설치
+npm install -g lee-spec-kit
+```
+
+## 사용법
+
+### 프로젝트 초기화
+
+```bash
+# 대화형 모드
+npx lee-spec-kit init
+
+# 옵션 지정
+npx lee-spec-kit init --name my-project --type fullstack --lang ko
+```
+
+**옵션:**
+
+| 옵션                | 설명                           | 기본값      |
+| ------------------- | ------------------------------ | ----------- |
+| `-n, --name <name>` | 프로젝트 이름                  | 현재 폴더명 |
+| `-t, --type <type>` | `single` 또는 `fullstack`      | 대화형 선택 |
+| `-l, --lang <lang>` | `ko` (한국어) 또는 `en` (영어) | `ko`        |
+| `-d, --dir <dir>`   | 설치 디렉토리                  | `./docs`    |
+| `-y, --yes`         | 대화형 프롬프트 스킵           | -           |
+
+### 새 기능 생성
+
+```bash
+# Single 프로젝트
+lee-spec-kit feature user-auth
+
+# Fullstack 프로젝트
+lee-spec-kit feature --repo be user-auth
+lee-spec-kit feature --repo fe user-profile
+```
+
+### 상태 확인
+
+```bash
+# 터미널에 출력
+lee-spec-kit status
+
+# 파일로 저장
+lee-spec-kit status --write
+```
+
+## 생성되는 구조
+
+### Fullstack (FE/BE 분리)
+
+```
+docs/
+├── README.md
+├── agents/
+│   ├── agents.md           # 에이전트 운영 규칙
+│   ├── constitution.md     # 프로젝트 원칙
+│   ├── git-workflow.md     # Git 자동화 규칙
+│   ├── issue-template.md
+│   └── pr-template.md
+├── prd/
+│   └── README.md
+└── features/
+    ├── README.md
+    ├── feature-base/       # 공용 템플릿
+    ├── be/                 # Backend Features
+    └── fe/                 # Frontend Features
+```
+
+### Single (단일 레포)
+
+```
+docs/
+├── README.md
+├── agents/
+├── prd/
+└── features/
+    ├── feature-base/
+    └── F001-feature/       # 개별 기능
+```
+
+## 프로젝트 타입
+
+| 타입        | 설명                                         |
+| ----------- | -------------------------------------------- |
+| `single`    | 단일 레포 프로젝트 (모노레포 또는 단일 스택) |
+| `fullstack` | FE/BE 분리 프로젝트                          |
+
+## Feature 워크플로우
+
+1. `spec.md` 작성 - **무엇을, 왜** 만드는지
+2. 사용자 리뷰 요청
+3. `plan.md` 작성 - **어떻게** 만드는지 (기술 스택)
+4. `tasks.md` 작성 - 태스크 분해
+5. `decisions.md` - 기술 결정 기록 (ADR)
+
+## 라이선스
+
+MIT

package/dist/index.js

@@ -0,0 +1,461 @@
+#!/usr/bin/env node
+import { program } from 'commander';
+import prompts from 'prompts';
+import chalk from 'chalk';
+import path4 from 'path';
+import fs5 from 'fs-extra';
+import { glob } from 'glob';
+import { fileURLToPath } from 'url';
+
+async function copyTemplates(src, dest) {
+  await fs5.copy(src, dest, {
+    overwrite: true,
+    errorOnExist: false
+  });
+}
+async function replaceInFiles(dir, replacements) {
+  const files = await glob("**/*.md", { cwd: dir, absolute: true });
+  for (const file of files) {
+    let content = await fs5.readFile(file, "utf-8");
+    for (const [search, replace] of Object.entries(replacements)) {
+      content = content.replaceAll(search, replace);
+    }
+    await fs5.writeFile(file, content, "utf-8");
+  }
+  const shFiles = await glob("**/*.sh", { cwd: dir, absolute: true });
+  for (const file of shFiles) {
+    let content = await fs5.readFile(file, "utf-8");
+    for (const [search, replace] of Object.entries(replacements)) {
+      content = content.replaceAll(search, replace);
+    }
+    await fs5.writeFile(file, content, "utf-8");
+  }
+}
+var __filename2 = fileURLToPath(import.meta.url);
+var __dirname2 = path4.dirname(__filename2);
+function getTemplatesDir() {
+  const rootDir = path4.resolve(__dirname2, "..");
+  return path4.join(rootDir, "templates");
+}
+
+// src/commands/init.ts
+function initCommand(program2) {
+  program2.command("init").description("Initialize project documentation structure").option("-n, --name <name>", "Project name (default: current folder name)").option("-t, --type <type>", "Project type: single | fullstack").option("-l, --lang <lang>", "Language: ko | en (default: ko)").option("-d, --dir <dir>", "Target directory (default: ./docs)", "./docs").option("-y, --yes", "Skip prompts and use defaults").action(async (options) => {
+    try {
+      await runInit(options);
+    } catch (error) {
+      if (error instanceof Error && error.message === "canceled") {
+        console.log(chalk.yellow("\n\uC791\uC5C5\uC774 \uCDE8\uC18C\uB418\uC5C8\uC2B5\uB2C8\uB2E4."));
+        process.exit(0);
+      }
+      console.error(chalk.red("\uC624\uB958:"), error);
+      process.exit(1);
+    }
+  });
+}
+async function runInit(options) {
+  const cwd = process.cwd();
+  const defaultName = path4.basename(cwd);
+  let projectName = options.name || defaultName;
+  let projectType = options.type;
+  let lang = options.lang || "ko";
+  const targetDir = path4.resolve(cwd, options.dir || "./docs");
+  if (!options.yes) {
+    const response = await prompts(
+      [
+        {
+          type: options.name ? null : "text",
+          name: "projectName",
+          message: "\uD504\uB85C\uC81D\uD2B8 \uC774\uB984\uC744 \uC785\uB825\uD558\uC138\uC694:",
+          initial: defaultName
+        },
+        {
+          type: options.type ? null : "select",
+          name: "projectType",
+          message: "\uD504\uB85C\uC81D\uD2B8 \uD0C0\uC785\uC744 \uC120\uD0DD\uD558\uC138\uC694:",
+          choices: [
+            {
+              title: "Single - \uB2E8\uC77C \uB808\uD3EC \uD504\uB85C\uC81D\uD2B8",
+              value: "single",
+              description: "features/ \uD3F4\uB354 \uD558\uB098\uB85C \uAD00\uB9AC"
+            },
+            {
+              title: "Fullstack - FE/BE \uBD84\uB9AC \uD504\uB85C\uC81D\uD2B8",
+              value: "fullstack",
+              description: "features/be/, features/fe/ \uBD84\uB9AC \uAD00\uB9AC"
+            }
+          ],
+          initial: 0
+        },
+        {
+          type: options.lang ? null : "select",
+          name: "lang",
+          message: "\uBB38\uC11C \uC5B8\uC5B4\uB97C \uC120\uD0DD\uD558\uC138\uC694:",
+          choices: [
+            { title: "\uD55C\uAD6D\uC5B4 (ko)", value: "ko" },
+            { title: "English (en)", value: "en" }
+          ],
+          initial: 0
+        }
+      ],
+      {
+        onCancel: () => {
+          throw new Error("canceled");
+        }
+      }
+    );
+    projectName = response.projectName || projectName;
+    projectType = response.projectType || projectType;
+    lang = response.lang || lang;
+  }
+  if (!projectType) {
+    projectType = "single";
+  }
+  if (await fs5.pathExists(targetDir)) {
+    const files = await fs5.readdir(targetDir);
+    if (files.length > 0) {
+      const { overwrite } = await prompts({
+        type: "confirm",
+        name: "overwrite",
+        message: `${targetDir} \uD3F4\uB354\uAC00 \uC774\uBBF8 \uC874\uC7AC\uD569\uB2C8\uB2E4. \uB36E\uC5B4\uC4F0\uC2DC\uACA0\uC2B5\uB2C8\uAE4C?`,
+        initial: false
+      });
+      if (!overwrite) {
+        console.log(chalk.yellow("\uC791\uC5C5\uC774 \uCDE8\uC18C\uB418\uC5C8\uC2B5\uB2C8\uB2E4."));
+        return;
+      }
+    }
+  }
+  console.log();
+  console.log(chalk.blue("\u{1F4C1} docs \uAD6C\uC870 \uC0DD\uC131 \uC911..."));
+  console.log(chalk.gray(`  \uD504\uB85C\uC81D\uD2B8: ${projectName}`));
+  console.log(chalk.gray(`  \uD0C0\uC785: ${projectType}`));
+  console.log(chalk.gray(`  \uC5B8\uC5B4: ${lang}`));
+  console.log(chalk.gray(`  \uACBD\uB85C: ${targetDir}`));
+  console.log();
+  const templatesDir = getTemplatesDir();
+  const templatePath = path4.join(templatesDir, lang, projectType);
+  if (!await fs5.pathExists(templatePath)) {
+    throw new Error(`\uD15C\uD50C\uB9BF\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4: ${templatePath}`);
+  }
+  await copyTemplates(templatePath, targetDir);
+  const replacements = {
+    "{{projectName}}": projectName,
+    "{{date}}": (/* @__PURE__ */ new Date()).toISOString().split("T")[0]
+  };
+  await replaceInFiles(targetDir, replacements);
+  console.log(chalk.green("\u2705 docs \uAD6C\uC870 \uC0DD\uC131 \uC644\uB8CC!"));
+  console.log();
+  console.log(chalk.blue("\uB2E4\uC74C \uB2E8\uACC4:"));
+  console.log(chalk.gray(`  1. ${targetDir}/prd/README.md \uC791\uC131`));
+  console.log(chalk.gray("  2. lee-spec-kit feature <name> \uC73C\uB85C \uAE30\uB2A5 \uCD94\uAC00"));
+  console.log();
+}
+async function getConfig(cwd) {
+  const possibleDirs = [
+    path4.join(cwd, "docs"),
+    cwd
+    // 이미 docs 폴더 안에 있을 수 있음
+  ];
+  for (const docsDir of possibleDirs) {
+    const agentsPath = path4.join(docsDir, "agents");
+    const featuresPath = path4.join(docsDir, "features");
+    if (await fs5.pathExists(agentsPath) && await fs5.pathExists(featuresPath)) {
+      const bePath = path4.join(featuresPath, "be");
+      const fePath = path4.join(featuresPath, "fe");
+      const projectType = await fs5.pathExists(bePath) || await fs5.pathExists(fePath) ? "fullstack" : "single";
+      const agentsMdPath = path4.join(agentsPath, "agents.md");
+      let lang = "ko";
+      if (await fs5.pathExists(agentsMdPath)) {
+        const content = await fs5.readFile(agentsMdPath, "utf-8");
+        if (!/[가-힣]/.test(content)) {
+          lang = "en";
+        }
+      }
+      return { docsDir, projectType, lang };
+    }
+  }
+  return null;
+}
+
+// src/commands/feature.ts
+function featureCommand(program2) {
+  program2.command("feature <name>").description("Create a new feature folder").option("-r, --repo <repo>", "Repository type: be | fe (fullstack only)").option("--id <id>", "Feature ID (default: auto)").action(async (name, options) => {
+    try {
+      await runFeature(name, options);
+    } catch (error) {
+      if (error instanceof Error && error.message === "canceled") {
+        console.log(chalk.yellow("\n\uC791\uC5C5\uC774 \uCDE8\uC18C\uB418\uC5C8\uC2B5\uB2C8\uB2E4."));
+        process.exit(0);
+      }
+      console.error(chalk.red("\uC624\uB958:"), error);
+      process.exit(1);
+    }
+  });
+}
+async function runFeature(name, options) {
+  const cwd = process.cwd();
+  const config = await getConfig(cwd);
+  if (!config) {
+    console.error(
+      chalk.red("docs \uD3F4\uB354\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 init\uC744 \uC2E4\uD589\uD558\uC138\uC694.")
+    );
+    process.exit(1);
+  }
+  const { docsDir, projectType, lang } = config;
+  let repo = options.repo;
+  if (projectType === "fullstack" && !repo) {
+    const response = await prompts(
+      {
+        type: "select",
+        name: "repo",
+        message: "\uB808\uD3EC\uC9C0\uD1A0\uB9AC\uB97C \uC120\uD0DD\uD558\uC138\uC694:",
+        choices: [
+          { title: "Backend (be)", value: "be" },
+          { title: "Frontend (fe)", value: "fe" }
+        ]
+      },
+      {
+        onCancel: () => {
+          throw new Error("canceled");
+        }
+      }
+    );
+    repo = response.repo;
+  }
+  const featureId = options.id || await getNextFeatureId(docsDir, projectType);
+  let featuresDir;
+  if (projectType === "fullstack" && repo) {
+    featuresDir = path4.join(docsDir, "features", repo);
+  } else {
+    featuresDir = path4.join(docsDir, "features");
+  }
+  const featureFolderName = `${featureId}-${name}`;
+  const featureDir = path4.join(featuresDir, featureFolderName);
+  if (await fs5.pathExists(featureDir)) {
+    console.error(chalk.red(`\uC774\uBBF8 \uC874\uC7AC\uD558\uB294 \uD3F4\uB354\uC785\uB2C8\uB2E4: ${featureDir}`));
+    process.exit(1);
+  }
+  const featureBasePath = path4.join(docsDir, "features", "feature-base");
+  if (!await fs5.pathExists(featureBasePath)) {
+    console.error(chalk.red("feature-base \uD15C\uD50C\uB9BF\uC744 \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+    process.exit(1);
+  }
+  await fs5.copy(featureBasePath, featureDir);
+  const idNumber = featureId.replace("F", "");
+  const repoName = projectType === "fullstack" && repo ? `{{projectName}}-${repo}` : "{{projectName}}";
+  const replacements = {
+    "{\uAE30\uB2A5\uBA85}": name,
+    "{\uBC88\uD638}": idNumber,
+    "YYYY-MM-DD": (/* @__PURE__ */ new Date()).toISOString().split("T")[0],
+    "{be|fe}": repo || "",
+    "git-dungeon-{be|fe}": repoName,
+    "{\uC774\uC288\uBC88\uD638}": ""
+  };
+  if (lang === "en") {
+    replacements["\uAE30\uB2A5 ID"] = "Feature ID";
+    replacements["\uAE30\uB2A5\uBA85"] = "Feature Name";
+    replacements["\uB300\uC0C1 \uB808\uD3EC"] = "Target Repo";
+    replacements["\uC774\uC288 \uBC88\uD638"] = "Issue Number";
+    replacements["\uC791\uC131\uC77C"] = "Created";
+    replacements["\uC0C1\uD0DC"] = "Status";
+  }
+  await replaceInFiles(featureDir, replacements);
+  console.log();
+  console.log(chalk.green(`\u2705 Feature \uD3F4\uB354 \uC0DD\uC131 \uC644\uB8CC: ${featureDir}`));
+  console.log();
+  console.log(chalk.blue("\uB2E4\uC74C \uB2E8\uACC4:"));
+  console.log(chalk.gray(`  1. ${featureDir}/spec.md \uC791\uC131`));
+  console.log(chalk.gray("  2. \uC0AC\uC6A9\uC790 \uB9AC\uBDF0 \uC694\uCCAD"));
+  console.log(chalk.gray("  3. \uC2B9\uC778 \uD6C4 plan.md \uC791\uC131"));
+  console.log();
+}
+async function getNextFeatureId(docsDir, projectType) {
+  const featuresDir = path4.join(docsDir, "features");
+  let max = 0;
+  const scanDirs = [];
+  if (projectType === "fullstack") {
+    scanDirs.push(path4.join(featuresDir, "be"));
+    scanDirs.push(path4.join(featuresDir, "fe"));
+  } else {
+    scanDirs.push(featuresDir);
+  }
+  for (const dir of scanDirs) {
+    if (!await fs5.pathExists(dir)) continue;
+    const entries = await fs5.readdir(dir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+      const match = entry.name.match(/^F(\d+)-/);
+      if (match) {
+        const num = parseInt(match[1], 10);
+        if (num > max) max = num;
+      }
+    }
+  }
+  const next = max + 1;
+  const width = Math.max(3, String(next).length);
+  return `F${String(next).padStart(width, "0")}`;
+}
+function statusCommand(program2) {
+  program2.command("status").description("Show feature status").option("-w, --write", "Write status.md file").option("-s, --strict", "Fail on missing/duplicate feature IDs").action(async (options) => {
+    try {
+      await runStatus(options);
+    } catch (error) {
+      console.error(chalk.red("\uC624\uB958:"), error);
+      process.exit(1);
+    }
+  });
+}
+async function runStatus(options) {
+  const cwd = process.cwd();
+  const config = await getConfig(cwd);
+  if (!config) {
+    console.error(
+      chalk.red("docs \uD3F4\uB354\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4. \uBA3C\uC800 init\uC744 \uC2E4\uD589\uD558\uC138\uC694.")
+    );
+    process.exit(1);
+  }
+  const { docsDir, projectType } = config;
+  const featuresDir = path4.join(docsDir, "features");
+  const features = [];
+  const idMap = /* @__PURE__ */ new Map();
+  const scopes = projectType === "fullstack" ? ["be", "fe"] : [""];
+  for (const scope of scopes) {
+    const scanDir = scope ? path4.join(featuresDir, scope) : featuresDir;
+    if (!await fs5.pathExists(scanDir)) continue;
+    const entries = await fs5.readdir(scanDir, { withFileTypes: true });
+    for (const entry of entries) {
+      if (!entry.isDirectory()) continue;
+      if (entry.name === "feature-base") continue;
+      const featureDir = path4.join(scanDir, entry.name);
+      const specPath = path4.join(featureDir, "spec.md");
+      const tasksPath = path4.join(featureDir, "tasks.md");
+      if (!await fs5.pathExists(specPath)) continue;
+      if (!await fs5.pathExists(tasksPath)) continue;
+      const specContent = await fs5.readFile(specPath, "utf-8");
+      const tasksContent = await fs5.readFile(tasksPath, "utf-8");
+      const id = extractSpecValue(specContent, "\uAE30\uB2A5 ID") || extractSpecValue(specContent, "Feature ID") || "UNKNOWN";
+      const name = extractSpecValue(specContent, "\uAE30\uB2A5\uBA85") || extractSpecValue(specContent, "Feature Name") || entry.name;
+      const repo = extractSpecValue(specContent, "\uB300\uC0C1 \uB808\uD3EC") || extractSpecValue(specContent, "Target Repo") || (scope ? `{{projectName}}-${scope}` : "{{projectName}}");
+      const issue = extractSpecValue(specContent, "\uC774\uC288 \uBC88\uD638") || extractSpecValue(specContent, "Issue Number") || "-";
+      const relPath = path4.relative(docsDir, featureDir);
+      if (!idMap.has(id)) {
+        idMap.set(id, []);
+      }
+      idMap.get(id).push(relPath);
+      const { total, done, doing, todo } = countTasks(tasksContent);
+      let status = "TODO";
+      if (total > 0 && done === total) {
+        status = "DONE";
+      } else if (doing > 0) {
+        status = "DOING";
+      } else if (todo > 0) {
+        status = "TODO";
+      } else if (total === 0) {
+        status = "NO_TASKS";
+      }
+      features.push({
+        id,
+        name,
+        repo,
+        issue,
+        status,
+        progress: `${done}/${total}`,
+        path: relPath
+      });
+    }
+  }
+  if (features.length === 0) {
+    console.log(chalk.yellow("Feature\uB97C \uCC3E\uC744 \uC218 \uC5C6\uC2B5\uB2C8\uB2E4."));
+    return;
+  }
+  if (options.strict) {
+    const duplicates = [...idMap.entries()].filter(
+      ([, paths]) => paths.length > 1
+    );
+    if (duplicates.length > 0) {
+      console.error(chalk.red("\uC911\uBCF5 Feature ID \uBC1C\uACAC:"));
+      for (const [id, paths] of duplicates) {
+        console.error(chalk.red(`  ${id}:`));
+        for (const p of paths) {
+          console.error(chalk.red(`    - ${p}`));
+        }
+      }
+      process.exit(1);
+    }
+    const unknowns = [...idMap.entries()].filter(([id]) => id === "UNKNOWN");
+    if (unknowns.length > 0) {
+      console.error(chalk.red("Feature ID\uAC00 \uC5C6\uB294 \uD56D\uBAA9:"));
+      for (const [, paths] of unknowns) {
+        for (const p of paths) {
+          console.error(chalk.red(`  - ${p}`));
+        }
+      }
+      process.exit(1);
+    }
+  }
+  features.sort((a, b) => a.id.localeCompare(b.id));
+  const header = "| ID | Name | Repo | Issue | Status | Progress | Path |";
+  const separator = "| --- | --- | --- | --- | --- | --- | --- |";
+  console.log();
+  console.log(header);
+  console.log(separator);
+  for (const f of features) {
+    const statusColor = f.status === "DONE" ? chalk.green : f.status === "DOING" ? chalk.yellow : chalk.gray;
+    console.log(
+      `| ${f.id} | ${f.name} | ${f.repo} | ${f.issue} | ${statusColor(f.status)} | ${f.progress} | ${f.path} |`
+    );
+  }
+  console.log();
+  if (options.write) {
+    const outputPath = path4.join(featuresDir, "status.md");
+    const date = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
+    const content = [
+      "# Feature Status",
+      "",
+      `- Generated: ${date}`,
+      "- Source: `tasks.md`, `spec.md`",
+      "",
+      header,
+      separator,
+      ...features.map(
+        (f) => `| ${f.id} | ${f.name} | ${f.repo} | ${f.issue} | ${f.status} | ${f.progress} | ${f.path} |`
+      ),
+      ""
+    ].join("\n");
+    await fs5.writeFile(outputPath, content, "utf-8");
+    console.log(chalk.green(`\u2705 ${outputPath} \uC0DD\uC131 \uC644\uB8CC`));
+  }
+}
+function extractSpecValue(content, key) {
+  const regex = new RegExp(`^- \\*\\*${key}\\*\\*:\\s*(.*)$`, "m");
+  const match = content.match(regex);
+  return match ? match[1].trim() : "";
+}
+function countTasks(content) {
+  let total = 0;
+  let done = 0;
+  let doing = 0;
+  let todo = 0;
+  const lines = content.split("\n");
+  for (const line of lines) {
+    const match = line.match(/^- \[([A-Z]+)\]/);
+    if (match) {
+      total++;
+      const status = match[1];
+      if (status === "DONE") done++;
+      else if (status === "DOING" || status === "REVIEW") doing++;
+      else if (status === "TODO") todo++;
+    }
+  }
+  return { total, done, doing, todo };
+}
+
+// src/index.ts
+program.name("lee-spec-kit").description(
+  "Project documentation structure generator for AI-assisted development"
+).version("0.1.0");
+initCommand(program);
+featureCommand(program);
+statusCommand(program);
+program.parse();

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "lee-spec-kit",
+  "version": "0.1.0",
+  "description": "Project documentation structure generator for AI-assisted development",
+  "type": "module",
+  "bin": {
+    "lee-spec-kit": "./dist/index.js",
+    "lsk": "./dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "templates"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "lint": "eslint src",
+    "format": "prettier --write .",
+    "prepublishOnly": "pnpm build"
+  },
+  "keywords": [
+    "docs",
+    "template",
+    "cli",
+    "ai",
+    "agent",
+    "specification",
+    "documentation"
+  ],
+  "author": "Lee Yoonsu",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/leeyoonsu/lee-spec-kit"
+  },
+  "dependencies": {
+    "chalk": "^5.6.2",
+    "commander": "^14.0.2",
+    "fs-extra": "^11.3.3",
+    "glob": "^13.0.0",
+    "prompts": "^2.4.2"
+  },
+  "devDependencies": {
+    "@types/fs-extra": "^11.0.4",
+    "@types/node": "^25.0.3",
+    "@types/prompts": "^2.4.9",
+    "@typescript-eslint/eslint-plugin": "^8.51.0",
+    "@typescript-eslint/parser": "^8.51.0",
+    "eslint": "^9.39.2",
+    "eslint-config-prettier": "^10.1.8",
+    "prettier": "^3.7.4",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3"
+  },
+  "packageManager": "pnpm@10.7.0"
+}

package/templates/en/fullstack/README.md

@@ -0,0 +1,12 @@
+# {{projectName}} Documentation Guide
+
+This documentation is organized by feature to help agents quickly understand the project.
+
+## Directory Structure
+
+| Path                | Purpose               | Key Documents                                                 |
+| ------------------- | --------------------- | ------------------------------------------------------------- |
+| `docs/agents/`      | Agent operating rules | `agents.md`, `constitution.md`, `git-workflow.md`             |
+| `docs/prd/`         | Product requirements  | Project-specific                                              |
+| `docs/features/be/` | Backend features      | `{feature-id}/spec.md`, `plan.md`, `tasks.md`, `decisions.md` |
+| `docs/features/fe/` | Frontend features     | `{feature-id}/spec.md`, `plan.md`, `tasks.md`, `decisions.md` |