lee-spec-kit 0.4.4 → 0.4.5

package/README.md

@@ -180,6 +180,9 @@ npx lee-spec-kit update
 # agents/ 폴더만 업데이트
 npx lee-spec-kit update --agents
 
+# agents/skills 폴더만 업데이트
+npx lee-spec-kit update --skills
+
 # feature-base/ 폴더만 업데이트
 npx lee-spec-kit update --templates
 

package/dist/index.js

@@ -85,7 +85,9 @@ var I18N = {
       "update.langLabel": "\uC5B8\uC5B4",
       "update.typeLabel": "\uD0C0\uC785",
       "update.updatingAgents": "\u{1F4C1} agents/ \uD3F4\uB354 \uC5C5\uB370\uC774\uD2B8 \uC911...",
+      "update.updatingSkills": "\u{1F4C1} agents/skills \uD3F4\uB354 \uC5C5\uB370\uC774\uD2B8 \uC911...",
       "update.agentsUpdated": "agents/ \uC5C5\uB370\uC774\uD2B8 \uC644\uB8CC",
+      "update.skillsUpdated": "agents/skills \uC5C5\uB370\uC774\uD2B8 \uC644\uB8CC",
       "update.updatingFeatureBase": "\u{1F4C1} features/feature-base/ \uD3F4\uB354 \uC5C5\uB370\uC774\uD2B8 \uC911...",
       "update.filesUpdated": "{count}\uAC1C \uD30C\uC77C \uC5C5\uB370\uC774\uD2B8 \uC644\uB8CC",
       "update.updatedTotal": "\uCD1D {count}\uAC1C \uD30C\uC77C \uC5C5\uB370\uC774\uD2B8 \uC644\uB8CC!",
@@ -256,7 +258,9 @@ var I18N = {
       "update.langLabel": "Lang",
       "update.typeLabel": "Type",
       "update.updatingAgents": "\u{1F4C1} Updating agents/ folder...",
+      "update.updatingSkills": "\u{1F4C1} Updating agents/skills folder...",
       "update.agentsUpdated": "agents/ updated",
+      "update.skillsUpdated": "agents/skills updated",
       "update.updatingFeatureBase": "\u{1F4C1} Updating features/feature-base/ folder...",
       "update.filesUpdated": "{count} files updated",
       "update.updatedTotal": "Updated {count} files!",
@@ -1281,9 +1285,9 @@ function getStepDefinitions(lang) {
     {
       step: 9,
       name: tr(lang, "steps", "branchCreate"),
-      checklist: { done: (f) => f.git.onExpectedBranch },
+      checklist: { done: (f) => f.git.onExpectedBranch || isImplementationDone(f) || isFeatureDone(f) },
       current: {
-        when: (f) => !!f.issueNumber && !isImplementationDone(f) && !isFeatureDone(f) && (!f.git.projectBranchAvailable || !f.git.onExpectedBranch),
+        when: (f) => !!f.issueNumber && f.tasks.total > 0 && f.tasks.done < f.tasks.total && !isFeatureDone(f) && (!f.git.projectBranchAvailable || !f.git.onExpectedBranch),
         actions: (f) => {
           if (!f.git.projectBranchAvailable || !f.git.projectGitCwd) {
             return [
@@ -1316,10 +1320,10 @@ function getStepDefinitions(lang) {
         detail: (f) => f.tasks.total > 0 ? `(${f.tasks.done}/${f.tasks.total})` : ""
       },
       current: {
-        when: (f) => f.git.onExpectedBranch && f.docs.tasksExists && f.tasks.total > 0 && (f.tasks.done < f.tasks.total || !isCompletionChecklistDone(f)),
+        when: (f) => f.docs.tasksExists && f.tasks.total > 0 && (f.tasks.done < f.tasks.total || !isCompletionChecklistDone(f)) && (f.git.onExpectedBranch || f.tasks.done === f.tasks.total),
         actions: (f) => {
           if (f.tasks.total === f.tasks.done && !isCompletionChecklistDone(f)) {
-            return [
+            const actions = [
               {
                 type: "instruction",
                 requiresUserOk: true,
@@ -1329,6 +1333,14 @@ function getStepDefinitions(lang) {
                 })
               }
             ];
+            if (!isPrMetadataConfigured(f)) {
+              actions.push({
+                type: "instruction",
+                requiresUserOk: true,
+                message: tr(lang, "messages", "prLegacyAsk")
+              });
+            }
+            return actions;
           }
           if (f.activeTask) {
             return [
@@ -2050,7 +2062,7 @@ async function getFeatureNameFromSpec(featureDir, fallbackSlug, fallbackFolderNa
   return fallbackSlug || fallbackFolderName;
 }
 function updateCommand(program2) {
-  program2.command("update").description("Update docs templates to the latest version").option("--agents", "Update agents/ folder only").option("--templates", "Update feature-base/ folder only").option("-f, --force", "Force overwrite without confirmation").action(async (options) => {
+  program2.command("update").description("Update docs templates to the latest version").option("--agents", "Update agents/ folder only").option("--skills", "Update agents/skills folder only").option("--templates", "Update feature-base/ folder only").option("-f, --force", "Force overwrite without confirmation").action(async (options) => {
     try {
       await runUpdate(options);
     } catch (error) {
@@ -2081,8 +2093,10 @@ async function runUpdate(options) {
   const { docsDir, projectType, lang } = config;
   const templatesDir = getTemplatesDir();
   const sourceDir = path4.join(templatesDir, lang, projectType);
-  const updateAgents = options.agents || !options.agents && !options.templates;
-  const updateTemplates = options.templates || !options.agents && !options.templates;
+  const hasExplicitSelection = !!(options.agents || options.skills || options.templates);
+  const updateAgents = options.agents || options.skills || !hasExplicitSelection;
+  const updateTemplates = options.templates || !hasExplicitSelection;
+  const agentsMode = options.skills && !options.agents ? "skills" : "all";
   console.log(chalk6.blue(tr(lang, "cli", "update.start")));
   console.log(chalk6.gray(`  - ${tr(lang, "cli", "update.langLabel")}: ${lang}`));
   console.log(
@@ -2091,10 +2105,17 @@ async function runUpdate(options) {
   console.log();
   let updatedCount = 0;
   if (updateAgents) {
-    console.log(chalk6.blue(tr(lang, "cli", "update.updatingAgents")));
-    const commonAgents = path4.join(templatesDir, lang, "common", "agents");
-    const typeAgents = path4.join(templatesDir, lang, projectType, "agents");
-    const targetAgents = path4.join(docsDir, "agents");
+    console.log(
+      chalk6.blue(
+        agentsMode === "skills" ? tr(lang, "cli", "update.updatingSkills") : tr(lang, "cli", "update.updatingAgents")
+      )
+    );
+    const commonAgentsBase = path4.join(templatesDir, lang, "common", "agents");
+    const typeAgentsBase = path4.join(templatesDir, lang, projectType, "agents");
+    const targetAgentsBase = path4.join(docsDir, "agents");
+    const commonAgents = agentsMode === "skills" ? path4.join(commonAgentsBase, "skills") : commonAgentsBase;
+    const typeAgents = agentsMode === "skills" ? path4.join(typeAgentsBase, "skills") : typeAgentsBase;
+    const targetAgents = agentsMode === "skills" ? path4.join(targetAgentsBase, "skills") : targetAgentsBase;
     const featurePath = projectType === "fullstack" ? "docs/features/{be|fe}" : "docs/features";
     const replacements = {
       "{{featurePath}}": featurePath
@@ -2119,7 +2140,11 @@ async function runUpdate(options) {
       );
       updatedCount += count;
     }
-    console.log(chalk6.green(`  \u2705 ${tr(lang, "cli", "update.agentsUpdated")}`));
+    console.log(
+      chalk6.green(
+        `  \u2705 ${agentsMode === "skills" ? tr(lang, "cli", "update.skillsUpdated") : tr(lang, "cli", "update.agentsUpdated")}`
+      )
+    );
   }
   if (updateTemplates) {
     console.log(chalk6.blue(tr(lang, "cli", "update.updatingFeatureBase")));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lee-spec-kit",
-  "version": "0.4.4",
+  "version": "0.4.5",
   "description": "Project documentation structure generator for AI-assisted development",
   "type": "module",
   "bin": {

package/templates/en/common/agents/skills/execute-task.md

@@ -30,6 +30,22 @@ Keep `tasks.md` aligned with reality.
 - Do not mark `[DONE]` without actually completing the work and verifying criteria.
 - If you need to change a completed task, add a new task instead of rewriting history.
 
+### Step 3.5: Record decisions (strongly recommended, effectively required)
+
+To avoid “why did we implement it like this?” losing context, **record any non-obvious or tradeoff-heavy implementation choice** in `decisions.md`.
+
+Record a decision if any of these apply:
+
+- There was a tradeoff (performance / reliability / security / maintainability)
+- You introduced a new rule/heuristic/state transition (e.g., context detection logic, exception criteria)
+- The user asked “why did you do it this way?” (requested rationale/justification)
+- The user explicitly asked to change behavior (requirements/policy/criteria changes)
+- You changed behavior for compatibility or as a workaround
+- You changed data shape, file structure, or CLI output rules
+- You expect future readers to ask “why this way?”
+
+Use the feature’s `decisions.md` template format. (Context/Options/Decision/Rationale/Consequences)
+
 ### Step 4: Repeat
 
 After finishing a meaningful chunk of work, run `context` again.

package/templates/ko/common/agents/skills/execute-task.md

@@ -28,6 +28,24 @@ CLI가 가리키는 **Active Task** 또는 **Next Action**을 수행합니다.
 
 ### 3단계: 기록 및 반복 (Record & Loop)
 
+#### 3-1) Decision 기록 (매우 권장, 사실상 필수)
+
+에이전트가 “왜 이렇게 구현했지?” 라는 질문에 답할 수 있도록, **비직관적이거나 선택의 여지가 있었던 구현**이 들어갔다면 `decisions.md`에 반드시 기록합니다.
+
+다음 중 하나라도 해당되면 기록하세요:
+
+- 구현 방식에 대한 **트레이드오프(성능/안정성/보안/유지보수성)** 가 있었다
+- **새로운 규칙/휴리스틱/상태 전이**가 추가되었다 (예: context 판단 로직, 예외 처리 기준)
+- 사용자가 “왜 이렇게 했나요?” 라고 **이유/근거**를 물었다
+- 사용자가 “이렇게 바꿔주세요” 처럼 **직접 변경을 요청**했다 (요구사항/정책/기준 변경 포함)
+- 기존 동작을 **호환성/버그 회피** 목적으로 변경했다
+- 데이터 구조/파일 구조/CLI 출력 규칙이 바뀌었다
+- “나중에 보면 헷갈릴 것 같은” 결정이 있었다
+
+작성 형식은 Feature의 `decisions.md` 템플릿을 따르세요. (Context/Options/Decision/Rationale/Consequences)
+
+#### 3-2) 태스크/체크리스트 업데이트 + 커밋
+
 1. 작업이 끝나면 해당 태스크의 상태를 `[DONE]`으로 변경하고, `Acceptance/Checklist` 항목을 `[x]`로 체크합니다.
 2. 커밋을 생성합니다 (코드 커밋 + 문서 커밋).
 3. **즉시 1단계로 돌아가** 다음 할 일을 CLI에게 물어봅니다.