@qualisoft/ai-skills 1.0.0

package/skills/project-interview/templates/open-questions.md

@@ -0,0 +1,40 @@
+---
+id: discovery-open-questions
+title: 인터뷰 미결 사항
+summary: 1단계에서 답이 나오지 않은 것. 2단계가 등급을 매겨 리스크 대장으로 올린다.
+date: {{YYYY-MM-DD}}
+---
+
+# 인터뷰 미결 사항
+
+> **1단계 기록이다.** 2단계의 리스크 대장과 별개다.
+> 여기는 *묻고 답을 못 받은 것*이 쌓이고,
+> 2단계는 그중 프로젝트를 막는 것을 `B-`/`H-`/`M-` 등급으로 승격시킨다.
+
+## 기록 규칙
+
+- 사용자가 **"모르겠다" / "나중에" / "확인해봐야 안다"** 라고 한 항목을 그대로 적는다.
+- 대신 정하지 않는다. 추정으로 채우면 2단계가 이걸 리스크로 인식할 기회를 잃는다.
+- ID는 `OQ-01` 형식. 2단계의 `B-01` `H-01` `M-01`과 구분된다.
+
+## 미결 목록
+
+| ID | 일자 | AI | 계정 | 항목 | 왜 필요한가 | 답이 없으면 무엇이 막히는가 | 결정 주체 |
+| --- | --- | --- | --- | --- | --- | --- | --- |
+| OQ-01 | `{{YYYY-MM-DD HH:mm}}` | `{{AI}}` | `{{계정}}` | | | | |
+
+## 답을 못 받은 이유 (선택)
+
+같은 질문이 반복되지 않도록, 왜 답이 안 나왔는지 남겨두면 도움이 된다.
+
+| ID | 사유 |
+| --- | --- |
+| | 아직 내부 논의 전 / 담당자 부재 / 예산 확정 전 / 질문이 이해되지 않음 |
+
+## 2단계 승격 상태
+
+> 2단계가 원본 OQ를 지우지 않고 `리스크 ID`, `차단 단계`, `현재 상태`, `해소 결정 ID`를 채운다.
+
+| OQ | 리스크 ID | 차단 단계 | 현재 상태 | 해소 결정 ID |
+| --- | --- | --- | --- | --- |
+| OQ-01 | | | 미승격 | |

package/skills/project-interview/validate.mjs

@@ -0,0 +1,49 @@
+#!/usr/bin/env node
+import { readFileSync } from "node:fs";
+
+const [briefPath, decisionsPath, questionsPath] = process.argv.slice(2);
+if (!briefPath || !decisionsPath || !questionsPath) {
+  console.error("사용법: node validate.mjs <기획안> <결정기록> <미결기록>");
+  process.exit(1);
+}
+
+const read = (path) => readFileSync(path, "utf8");
+const brief = read(briefPath);
+const decisions = read(decisionsPath);
+const questions = read(questionsPath);
+const optionIds = [
+  "seo", "naver", "geo", "analytics", "tagmanager", "adtracking", "consent",
+  "a11y", "perfbudget", "i18n", "cms", "contactform", "darkmode",
+];
+const errors = [];
+
+const profileAxes = {
+  scale: ["solo", "small", "standard", "large"],
+  risk: ["low", "standard", "regulated"],
+  delivery: ["prototype", "mvp", "production"],
+};
+for (const [axis, levels] of Object.entries(profileAxes)) {
+  if (!new RegExp(`^  ${axis}: (${levels.join("|")})$`, "m").test(brief)) {
+    errors.push(`profile.${axis} 누락 또는 값 오류 (${levels.join(" | ")})`);
+  }
+}
+for (const id of optionIds) {
+  if (!new RegExp(`^  ${id}: (true|false|unknown)$`, "m").test(brief)) {
+    errors.push(`option_hints 누락 또는 값 오류: ${id}`);
+  }
+}
+for (const title of ["최종 목표 범위", "첫 출시 범위", "이번에 하지 않는 것",
+                     "산출물 범위", "만들지 않기로 한 것"]) {
+  if (!brief.includes(title)) errors.push(`기획안 필수 항목 누락: ${title}`);
+}
+const meta = /\| `\d{4}-\d{2}-\d{2} \d{2}:\d{2}` \| `[^`]+` \| `[^`]+` \|/;
+if (/DI-\d+/.test(decisions) && !meta.test(decisions)) errors.push("DI 작성자 속성 표 누락");
+if (/OQ-\d+/.test(questions) && !/\d{4}-\d{2}-\d{2} \d{2}:\d{2}/.test(questions)) {
+  errors.push("OQ 일자(분 단위) 누락");
+}
+
+if (errors.length) {
+  for (const error of errors) console.error("- " + error);
+  process.exit(1);
+}
+console.log("project-interview 전달 계약 검증 통과");