ai-dev-cli 2.0.0 → 2.0.1

package/README.md

@@ -17,7 +17,7 @@ npx ai-dev-cli init
 | 0 — Minimal | `CLAUDE.md` + `.claude/settings.json` (permissions) |
 | 1 — Commands | + `/plan` `/review` `/commit` custom commands |
 | 2 — Quality | + Hook scripts (bash firewall, format guard, size guard, dep guard) |
-| 3 — Full | + MCP config, coding standards skill, approved-deps, ADR directory |
+| 3 — Full | + MCP config, skills (code-standards, spec), approved-deps, ADR directory |
 
 Each level includes all lower levels.
 
@@ -64,9 +64,11 @@ your-project/
       pre-bash-firewall.sh
       post-edit-format.sh
       ...
-    skills/              # Coding standards skill
+    skills/              # Skills
       code-standards/
         SKILL.md
+      spec/
+        SKILL.md
   .mcp.json              # MCP server config
   docs/
     approved-deps.md

package/dist/index.js

@@ -472,6 +472,10 @@ function initLevel3(vars) {
     ".claude/skills/code-standards/SKILL.md",
     loadTemplate("level-3/code-standards.md")
   );
+  safeWrite(
+    ".claude/skills/spec/SKILL.md",
+    loadTemplate("level-3/spec.md")
+  );
   safeWrite("docs/approved-deps.md", loadAndRender("level-3/approved-deps.md", vars));
   const adrKeep = "docs/adr/.gitkeep";
   if (!import_node_fs4.default.existsSync(adrKeep)) {
@@ -511,6 +515,8 @@ async function runCheck(options) {
   checkGitignore(options.fix);
   checkEnvSafety();
   checkLongFiles();
+  checkAnyType();
+  checkDefaultExport();
   checkBannedDeps();
   checkEnvFilesTracked();
   console.log("");
@@ -621,6 +627,53 @@ ${longFiles.map((f) => `       - ${f}`).join("\n")}`);
     pass("All .ts/.tsx files are within 300 lines");
   }
 }
+function checkAnyType() {
+  const anyFiles = [];
+  walkDir(".", (filepath) => {
+    if (!filepath.match(/\.(ts|tsx)$/) || filepath.includes("node_modules") || filepath.includes(".next") || filepath.includes("dist")) {
+      return;
+    }
+    const content = import_node_fs5.default.readFileSync(filepath, "utf-8");
+    const lines = content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+      const line = lines[i];
+      if (line.match(/:\s*any\b/) || line.match(/as\s+any\b/)) {
+        anyFiles.push(`${filepath}:${i + 1}`);
+      }
+    }
+  });
+  if (anyFiles.length > 0) {
+    warning(
+      `Found ${anyFiles.length} any type usage(s):
+${anyFiles.map((f) => `       - ${f}`).join("\n")}`
+    );
+  } else {
+    pass("No any type usage found in .ts/.tsx files");
+  }
+}
+function checkDefaultExport() {
+  const defaultExports = [];
+  walkDir(".", (filepath) => {
+    if (!filepath.match(/\.(ts|tsx)$/) || filepath.includes("node_modules") || filepath.includes(".next") || filepath.includes("dist")) {
+      return;
+    }
+    const content = import_node_fs5.default.readFileSync(filepath, "utf-8");
+    const lines = content.split("\n");
+    for (let i = 0; i < lines.length; i++) {
+      if (lines[i].match(/\bexport\s+default\b/)) {
+        defaultExports.push(`${filepath}:${i + 1}`);
+      }
+    }
+  });
+  if (defaultExports.length > 0) {
+    warning(
+      `Found ${defaultExports.length} default export(s):
+${defaultExports.map((f) => `       - ${f}`).join("\n")}`
+    );
+  } else {
+    pass("No default exports found in .ts/.tsx files");
+  }
+}
 function checkBannedDeps() {
   const pkg = readJsonFile("package.json");
   if (!pkg) return;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ai-dev-cli",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "AI Dev Lifecycle — scaffold & audit tool for Claude Code projects",
   "bin": {
     "ai-dev-cli": "dist/index.js"

package/templates/level-3/spec.md

@@ -0,0 +1,56 @@
+---
+name: spec
+description: >
+  Requirement analysis and product definition. Use when you have a new idea,
+  feature request, or business need that requires formalization.
+  Produces a structured spec.md through Socratic questioning, as input for /plan.
+---
+
+# Requirement Analysis & Product Definition
+
+Transform vague ideas into a validated spec.md — the upstream input for /plan.
+
+## Process
+
+1. **Capture Raw Idea** — Let user express freely, then summarize back in one sentence
+2. **Socratic Questioning** — 5 Whys to find root problem + probe 3-5 key dimensions:
+   Clarification / Assumptions / Evidence / Perspectives / Implications / Meta-questions
+3. **Clarity Scoring** — Rate requirement on 100-point scale:
+   Business Context /20, Functional Clarity /30, Technical Specificity /25, Scope /25.
+   Must reach ≥ 90 before proceeding.
+4. **Strategy Exploration** — Compare 2-3 approaches (trade-offs, effort). User chooses.
+5. **User Stories** — Given/When/Then acceptance criteria (happy path + errors + edge cases)
+6. **Feature Breakdown** — Dependency graph + data model + API surface (when applicable)
+7. **Multi-Perspective Review** — Engineer / User / Business viewpoints
+8. **Generate spec.md** — Wait for user approval before proceeding to /plan
+
+## Output
+
+Single file `docs/spec.md` (or `docs/[feature]-spec.md`) containing:
+- Background & root problem (5 Whys chain)
+- Objectives & anti-goals
+- Target users with pain level
+- Strategy chosen with rationale
+- User stories with acceptance criteria
+- Feature dependency graph
+- Data model & API surface (if applicable)
+- Risks from multi-perspective review
+- Scope boundaries (in/out)
+- Success metrics
+
+## When to Use
+
+- New feature ideas that are still vague or need validation
+- Medium-to-large features (cross-module, new data models, new APIs)
+- Skip for small changes (< 3 files) — use /plan directly
+
+## Quality Gate
+
+Before moving to /plan:
+- [ ] Clarity Score ≥ 90
+- [ ] Root problem identified (not surface request)
+- [ ] ≥ 3 user stories with ≥ 3 acceptance criteria each
+- [ ] Scope boundaries explicit (in AND out)
+- [ ] ≥ 2 measurable success metrics
+- [ ] Multi-perspective review completed
+- [ ] User approved