@esthernandez/vibe-doc 0.2.0 → 0.2.2

package/dist/classifier/index.js

@@ -106,6 +106,8 @@ function buildLowConfidenceClassification(ruleResults, inventory) {
 function mapCategoryToDeploymentContext(category, contexts) {
     const result = [];
     // Determine platform based on category
+    // TODO: these platform/environment/scale strings are untyped magic strings —
+    // worth promoting to enums when the classifier gets its next overhaul.
     let platform = 'cloud';
     if (category === scoring_engine_1.Category.MobileApplication) {
         platform = 'mobile';
@@ -113,6 +115,9 @@ function mapCategoryToDeploymentContext(category, contexts) {
     else if (category === scoring_engine_1.Category.InfrastructurePlatform) {
         platform = 'kubernetes';
     }
+    else if (category === scoring_engine_1.Category.ClaudeCodePlugin) {
+        platform = 'plugin';
+    }
     // Check for EdgeEmbedded context
     if (contexts.includes(scoring_engine_1.Context.EdgeEmbedded)) {
         platform = 'edge';
@@ -122,6 +127,10 @@ function mapCategoryToDeploymentContext(category, contexts) {
     if (contexts.includes(scoring_engine_1.Context.InternalTooling)) {
         environment = 'staging';
     }
+    if (category === scoring_engine_1.Category.ClaudeCodePlugin) {
+        // Plugins are distributed, not deployed in the SaaS sense
+        environment = 'distribution';
+    }
     // Determine scale based on contexts
     let scale = 'small';
     if (contexts.includes(scoring_engine_1.Context.CustomerFacing)) {

package/dist/classifier/llm-prompt.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"llm-prompt.d.ts","sourceRoot":"","sources":["../../src/classifier/llm-prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAA+B,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE9E;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,iBAAiB,EAC5B,WAAW,EAAE,aAAa,GACzB,MAAM,CA0DR"}
+{"version":3,"file":"llm-prompt.d.ts","sourceRoot":"","sources":["../../src/classifier/llm-prompt.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAA+B,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAE9E;;;GAGG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,iBAAiB,EAC5B,WAAW,EAAE,aAAa,GACzB,MAAM,CA2DR"}

package/dist/classifier/llm-prompt.js

@@ -39,6 +39,7 @@ Choose ONE primary category that best describes this project:
 - **MobileApplication**: Native or cross-platform mobile apps
 - **AIMLSystem**: ML/AI-focused projects with models, training, inference
 - **IntegrationConnector**: Adapters, SDKs, connectors for third-party services
+- **ClaudeCodePlugin**: A Claude Code plugin or plugin marketplace — characterized by a .claude-plugin/plugin.json manifest, skills/*/SKILL.md files, commands/*.md files, or a .claude-plugin/marketplace.json. No runtime deployment in the traditional sense; distributed to users via npm or a marketplace.
 
 ## Operational Contexts
 

package/dist/classifier/scoring-engine.d.ts

@@ -10,7 +10,8 @@ export declare enum Category {
     InfrastructurePlatform = "InfrastructurePlatform",
     MobileApplication = "MobileApplication",
     AIMLSystem = "AIMLSystem",
-    IntegrationConnector = "IntegrationConnector"
+    IntegrationConnector = "IntegrationConnector",
+    ClaudeCodePlugin = "ClaudeCodePlugin"
 }
 export declare enum Context {
     Regulated = "Regulated",

package/dist/classifier/scoring-engine.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scoring-engine.d.ts","sourceRoot":"","sources":["../../src/classifier/scoring-engine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,oBAAY,QAAQ;IAClB,cAAc,mBAAmB;IACjC,eAAe,oBAAoB;IACnC,YAAY,iBAAiB;IAC7B,sBAAsB,2BAA2B;IACjD,iBAAiB,sBAAsB;IACvC,UAAU,eAAe;IACzB,oBAAoB,yBAAyB;CAC9C;AAED,oBAAY,OAAO;IACjB,SAAS,cAAc;IACvB,cAAc,mBAAmB;IACjC,eAAe,oBAAoB;IACnC,WAAW,gBAAgB;IAC3B,YAAY,iBAAiB;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EAAE,EACjB,mBAAmB,GAAE,MAAa,GACjC,aAAa,CAuMf"}
+{"version":3,"file":"scoring-engine.d.ts","sourceRoot":"","sources":["../../src/classifier/scoring-engine.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAGnC,oBAAY,QAAQ;IAClB,cAAc,mBAAmB;IACjC,eAAe,oBAAoB;IACnC,YAAY,iBAAiB;IAC7B,sBAAsB,2BAA2B;IACjD,iBAAiB,sBAAsB;IACvC,UAAU,eAAe;IACzB,oBAAoB,yBAAyB;IAC7C,gBAAgB,qBAAqB;CACtC;AAED,oBAAY,OAAO;IACjB,SAAS,cAAc;IACvB,cAAc,mBAAmB;IACjC,eAAe,oBAAoB;IACnC,WAAW,gBAAgB;IAC3B,YAAY,iBAAiB;CAC9B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,QAAQ,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,aAAa;IAC5B,UAAU,EAAE,aAAa,EAAE,CAAC;IAC5B,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EAAE,EACjB,mBAAmB,GAAE,MAAa,GACjC,aAAa,CA0Nf"}

package/dist/classifier/scoring-engine.js

@@ -16,6 +16,7 @@ var Category;
     Category["MobileApplication"] = "MobileApplication";
     Category["AIMLSystem"] = "AIMLSystem";
     Category["IntegrationConnector"] = "IntegrationConnector";
+    Category["ClaudeCodePlugin"] = "ClaudeCodePlugin";
 })(Category || (exports.Category = Category = {}));
 var Context;
 (function (Context) {
@@ -160,6 +161,21 @@ function scoreClassification(signals, confidenceThreshold = 0.85) {
             case 'has-github-actions':
                 contextScores[Context.InternalTooling] += 1 * w;
                 break;
+            // Claude Code Plugin signals
+            // Weighted to dominate: plugin.json is an unambiguous marker that
+            // overrides any incidental web/framework signals in the repo.
+            case 'has-claude-plugin-manifest':
+                categoryScores[Category.ClaudeCodePlugin] += 20 * w;
+                break;
+            case 'has-claude-skill-files':
+                categoryScores[Category.ClaudeCodePlugin] += 8 * w;
+                break;
+            case 'has-claude-command-files':
+                categoryScores[Category.ClaudeCodePlugin] += 6 * w;
+                break;
+            case 'has-claude-marketplace':
+                categoryScores[Category.ClaudeCodePlugin] += 10 * w;
+                break;
             default:
                 logger_1.logger.warn(`Unknown signal: ${signal.name}`);
         }

package/dist/classifier/signals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../../src/classifier/signals.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAgWrE"}
+{"version":3,"file":"signals.d.ts","sourceRoot":"","sources":["../../src/classifier/signals.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGpD,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,iBAAiB,GAAG,MAAM,EAAE,CAkZrE"}

package/dist/classifier/signals.js

@@ -12,16 +12,20 @@ const logger_1 = require("../utils/logger");
  */
 function extractSignals(inventory) {
     const signals = [];
+    // Normalize paths to forward slashes before any substring matching —
+    // otherwise Windows backslash paths break signal detection for anything
+    // that looks across path components (.github/workflows, .claude-plugin/...)
+    const norm = (s) => s.replace(/\\/g, '/').toLowerCase();
     // Source code patterns
-    const sourceFiles = inventory.categories.sourceCode.files.join('|').toLowerCase();
-    const configFiles = inventory.categories.configuration.files.join('|').toLowerCase();
-    const infraFiles = inventory.categories.infrastructure.files.join('|').toLowerCase();
-    const docFiles = inventory.categories.documentation.files.join('|').toLowerCase();
-    const allFiles = inventory.categories.sourceCode.files
+    const sourceFiles = norm(inventory.categories.sourceCode.files.join('|'));
+    const configFiles = norm(inventory.categories.configuration.files.join('|'));
+    const infraFiles = norm(inventory.categories.infrastructure.files.join('|'));
+    const docFiles = norm(inventory.categories.documentation.files.join('|'));
+    const allFiles = norm(inventory.categories.sourceCode.files
         .concat(inventory.categories.configuration.files)
         .concat(inventory.categories.infrastructure.files)
-        .join('|')
-        .toLowerCase();
+        .concat(inventory.categories.documentation.files)
+        .join('|'));
     // Express/Fastify/Koa routes
     if (sourceFiles.includes('routes') || sourceFiles.includes('controller')) {
         if (allFiles.includes('express') ||
@@ -300,6 +304,41 @@ function extractSignals(inventory) {
             weight: 1,
         });
     }
+    // Claude Code Plugin manifest — the dominant signal for plugin repos.
+    // Path-anchored to avoid false positives on stray files named plugin.json.
+    if (configFiles.includes('.claude-plugin/plugin.json') ||
+        allFiles.includes('.claude-plugin/plugin.json')) {
+        signals.push({
+            name: 'has-claude-plugin-manifest',
+            source: 'file-scanner',
+            weight: 10,
+        });
+    }
+    // Claude Code marketplace manifest (multi-plugin repo)
+    if (configFiles.includes('.claude-plugin/marketplace.json') ||
+        allFiles.includes('.claude-plugin/marketplace.json')) {
+        signals.push({
+            name: 'has-claude-marketplace',
+            source: 'file-scanner',
+            weight: 8,
+        });
+    }
+    // SKILL.md files under a skills/ directory (plugin skill surface)
+    if (docFiles.match(/\/skills\/[^/|]+\/skill\.md/)) {
+        signals.push({
+            name: 'has-claude-skill-files',
+            source: 'file-scanner',
+            weight: 6,
+        });
+    }
+    // Command markdown files under a commands/ directory
+    if (docFiles.match(/\/commands\/[^/|]+\.md/)) {
+        signals.push({
+            name: 'has-claude-command-files',
+            source: 'file-scanner',
+            weight: 5,
+        });
+    }
     logger_1.logger.debug(`Extracted ${signals.length} signals from inventory`);
     return signals;
 }

package/dist/gap-analyzer/breadcrumbs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"breadcrumbs.d.ts","sourceRoot":"","sources":["../../src/gap-analyzer/breadcrumbs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAsT1D"}
+{"version":3,"file":"breadcrumbs.d.ts","sourceRoot":"","sources":["../../src/gap-analyzer/breadcrumbs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAC;IACnB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,gBAAgB,EAAE,MAAM,EAAE,CAAC;IAC3B,YAAY,EAAE,MAAM,EAAE,CAAC;CACxB;AAED;;GAEG;AACH,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CAuY1D"}

package/dist/gap-analyzer/breadcrumbs.js

@@ -296,6 +296,83 @@ function getBreadcrumbs(docType) {
                 'What indexing strategy do you use?',
             ],
         },
+        readme: {
+            docType: 'readme',
+            keywords: ['readme'],
+            filePatterns: ['**/README.md', '**/README', '**/README.*'],
+            gitPatterns: ['readme:', 'docs: readme', 'docs:readme'],
+            codePatterns: [],
+            // Single-file docs: presence of the file is the satisfaction signal.
+            // The generate-time template enforces the sections; the gap analyzer
+            // only needs to know "does a README exist anywhere?"
+            requiredSections: ['present'],
+            gapQuestions: [
+                'What does your project actually do, in one sentence?',
+                'How does a new user install and run it for the first time?',
+                'What does a minimal working example look like?',
+                'Where should someone go next after reading the README?',
+            ],
+        },
+        'install-guide': {
+            docType: 'install-guide',
+            keywords: ['install', 'setup', 'getting-started'],
+            filePatterns: [
+                '**/INSTALL.md',
+                '**/INSTALLATION.md',
+                '**/docs/install*',
+                '**/docs/setup*',
+                '**/docs/getting-started*',
+            ],
+            gitPatterns: ['install:', 'setup:', 'docs: install'],
+            codePatterns: [],
+            requiredSections: ['present'],
+            gapQuestions: [
+                'What does a user need before installing (OS, runtimes, accounts)?',
+                'What is the exact command or set of steps to install?',
+                'How does a user verify the install worked?',
+                'What are the most common installation problems and fixes?',
+            ],
+        },
+        'skill-command-reference': {
+            docType: 'skill-command-reference',
+            keywords: ['skill', 'command'],
+            filePatterns: [
+                '**/SKILL.md',
+                '**/skills/**',
+                '**/commands/**',
+                '**/docs/commands*',
+                '**/docs/skills*',
+            ],
+            gitPatterns: ['skill:', 'command:', 'docs: skill'],
+            codePatterns: ['SKILL.md', 'description:', 'commands/'],
+            requiredSections: ['present'],
+            gapQuestions: [
+                'What skills or slash commands does this plugin expose?',
+                'For each, what does it do and when should someone reach for it?',
+                'What arguments or inputs does each command accept?',
+                'What does typical output look like?',
+            ],
+        },
+        'changelog-contributing': {
+            docType: 'changelog-contributing',
+            keywords: ['changelog', 'contributing', 'history'],
+            filePatterns: [
+                '**/CHANGELOG.md',
+                '**/CONTRIBUTING.md',
+                '**/HISTORY.md',
+                '**/docs/releases*',
+                '**/docs/contributing*',
+            ],
+            gitPatterns: ['release:', 'changelog:', 'docs: changelog'],
+            codePatterns: [],
+            requiredSections: ['present'],
+            gapQuestions: [
+                'Where do you track notable changes between releases?',
+                'How should a contributor get set up and propose changes?',
+                'What is the review and merge process?',
+                'Is there a code of conduct for contributors?',
+            ],
+        },
     };
     const breadcrumb = breadcrumbs[docType];
     if (!breadcrumb) {

package/dist/gap-analyzer/matrix.d.ts

@@ -9,7 +9,11 @@ export declare enum DocType {
     APISpec = "api-spec",
     DeploymentProcedure = "deployment-procedure",
     TestPlan = "test-plan",
-    DataModel = "data-model"
+    DataModel = "data-model",
+    README = "readme",
+    InstallGuide = "install-guide",
+    SkillCommandReference = "skill-command-reference",
+    ChangelogContributing = "changelog-contributing"
 }
 export declare enum Tier {
     Required = "required",

package/dist/gap-analyzer/matrix.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"matrix.d.ts","sourceRoot":"","sources":["../../src/gap-analyzer/matrix.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,oBAAY,OAAO;IACjB,GAAG,QAAQ;IACX,OAAO,YAAY;IACnB,WAAW,iBAAiB;IAC5B,OAAO,aAAa;IACpB,mBAAmB,yBAAyB;IAC5C,QAAQ,cAAc;IACtB,SAAS,eAAe;CACzB;AAED,oBAAY,IAAI;IACd,QAAQ,aAAa;IACrB,WAAW,gBAAgB;IAC3B,QAAQ,aAAa;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAuED;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAAE,GACjB,cAAc,EAAE,CAmDlB"}
+{"version":3,"file":"matrix.d.ts","sourceRoot":"","sources":["../../src/gap-analyzer/matrix.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,oBAAY,OAAO;IACjB,GAAG,QAAQ;IACX,OAAO,YAAY;IACnB,WAAW,iBAAiB;IAC5B,OAAO,aAAa;IACpB,mBAAmB,yBAAyB;IAC5C,QAAQ,cAAc;IACtB,SAAS,eAAe;IACxB,MAAM,WAAW;IACjB,YAAY,kBAAkB;IAC9B,qBAAqB,4BAA4B;IACjD,qBAAqB,2BAA2B;CACjD;AAED,oBAAY,IAAI;IACd,QAAQ,aAAa;IACrB,WAAW,gBAAgB;IAC3B,QAAQ,aAAa;CACtB;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAsHD;;GAEG;AACH,wBAAgB,eAAe,CAC7B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAAE,GACjB,cAAc,EAAE,CAmDlB"}

package/dist/gap-analyzer/matrix.js

@@ -16,6 +16,10 @@ var DocType;
     DocType["DeploymentProcedure"] = "deployment-procedure";
     DocType["TestPlan"] = "test-plan";
     DocType["DataModel"] = "data-model";
+    DocType["README"] = "readme";
+    DocType["InstallGuide"] = "install-guide";
+    DocType["SkillCommandReference"] = "skill-command-reference";
+    DocType["ChangelogContributing"] = "changelog-contributing";
 })(DocType || (exports.DocType = DocType = {}));
 var Tier;
 (function (Tier) {
@@ -35,6 +39,7 @@ const BASE_MATRIX = {
         MobileApplication: Tier.Recommended,
         AIMLSystem: Tier.Recommended,
         IntegrationConnector: Tier.Recommended,
+        ClaudeCodePlugin: Tier.Recommended,
     },
     [DocType.Runbook]: {
         WebApplication: Tier.Required,
@@ -44,6 +49,7 @@ const BASE_MATRIX = {
         MobileApplication: Tier.Required,
         AIMLSystem: Tier.Required,
         IntegrationConnector: Tier.Recommended,
+        ClaudeCodePlugin: Tier.Optional,
     },
     [DocType.ThreatModel]: {
         WebApplication: Tier.Recommended,
@@ -53,6 +59,7 @@ const BASE_MATRIX = {
         MobileApplication: Tier.Required,
         AIMLSystem: Tier.Required,
         IntegrationConnector: Tier.Recommended,
+        ClaudeCodePlugin: Tier.Optional,
     },
     [DocType.APISpec]: {
         WebApplication: Tier.Required,
@@ -62,6 +69,7 @@ const BASE_MATRIX = {
         MobileApplication: Tier.Recommended,
         AIMLSystem: Tier.Recommended,
         IntegrationConnector: Tier.Required,
+        ClaudeCodePlugin: Tier.Optional,
     },
     [DocType.DeploymentProcedure]: {
         WebApplication: Tier.Required,
@@ -71,6 +79,7 @@ const BASE_MATRIX = {
         MobileApplication: Tier.Required,
         AIMLSystem: Tier.Required,
         IntegrationConnector: Tier.Recommended,
+        ClaudeCodePlugin: Tier.Optional,
     },
     [DocType.TestPlan]: {
         WebApplication: Tier.Recommended,
@@ -80,6 +89,7 @@ const BASE_MATRIX = {
         MobileApplication: Tier.Required,
         AIMLSystem: Tier.Required,
         IntegrationConnector: Tier.Recommended,
+        ClaudeCodePlugin: Tier.Recommended,
     },
     [DocType.DataModel]: {
         WebApplication: Tier.Required,
@@ -89,6 +99,47 @@ const BASE_MATRIX = {
         MobileApplication: Tier.Recommended,
         AIMLSystem: Tier.Required,
         IntegrationConnector: Tier.Optional,
+        ClaudeCodePlugin: Tier.Optional,
+    },
+    [DocType.README]: {
+        WebApplication: Tier.Required,
+        APIMicroservice: Tier.Required,
+        DataPipeline: Tier.Required,
+        InfrastructurePlatform: Tier.Required,
+        MobileApplication: Tier.Required,
+        AIMLSystem: Tier.Required,
+        IntegrationConnector: Tier.Required,
+        ClaudeCodePlugin: Tier.Required,
+    },
+    [DocType.InstallGuide]: {
+        WebApplication: Tier.Recommended,
+        APIMicroservice: Tier.Recommended,
+        DataPipeline: Tier.Recommended,
+        InfrastructurePlatform: Tier.Required,
+        MobileApplication: Tier.Required,
+        AIMLSystem: Tier.Recommended,
+        IntegrationConnector: Tier.Required,
+        ClaudeCodePlugin: Tier.Required,
+    },
+    [DocType.SkillCommandReference]: {
+        WebApplication: Tier.Optional,
+        APIMicroservice: Tier.Optional,
+        DataPipeline: Tier.Optional,
+        InfrastructurePlatform: Tier.Optional,
+        MobileApplication: Tier.Optional,
+        AIMLSystem: Tier.Optional,
+        IntegrationConnector: Tier.Recommended,
+        ClaudeCodePlugin: Tier.Required,
+    },
+    [DocType.ChangelogContributing]: {
+        WebApplication: Tier.Recommended,
+        APIMicroservice: Tier.Recommended,
+        DataPipeline: Tier.Recommended,
+        InfrastructurePlatform: Tier.Recommended,
+        MobileApplication: Tier.Recommended,
+        AIMLSystem: Tier.Recommended,
+        IntegrationConnector: Tier.Recommended,
+        ClaudeCodePlugin: Tier.Recommended,
     },
 };
 /**

package/dist/gap-analyzer/tier-assigner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tier-assigner.d.ts","sourceRoot":"","sources":["../../src/gap-analyzer/tier-assigner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAkB,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3D,MAAM,WAAW,GAAG;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,YAAY,EAAE,cAAc,EAAE,EAC9B,SAAS,EAAE,iBAAiB,EAC5B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GACnC,GAAG,EAAE,CA+BP;AAmGD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}
+{"version":3,"file":"tier-assigner.d.ts","sourceRoot":"","sources":["../../src/gap-analyzer/tier-assigner.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAEpD,OAAO,EAAE,cAAc,EAAE,IAAI,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAkB,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3D,MAAM,WAAW,GAAG;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,IAAI,CAAC;IACX,QAAQ,EAAE,MAAM,CAAC;IACjB,gBAAgB,EAAE,MAAM,CAAC;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;GAEG;AACH,wBAAgB,UAAU,CACxB,YAAY,EAAE,cAAc,EAAE,EAC9B,SAAS,EAAE,iBAAiB,EAC5B,WAAW,EAAE,GAAG,CAAC,MAAM,EAAE,UAAU,CAAC,GACnC,GAAG,EAAE,CA+BP;AAiHD,OAAO,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC"}

package/dist/gap-analyzer/tier-assigner.js

@@ -67,19 +67,31 @@ function searchForDocumentationEvidence(breadcrumb, inventory) {
 }
 /**
  * Simple glob pattern matcher
+ * Normalizes Windows backslashes to forward slashes so glob patterns
+ * that reference path segments (e.g., "** /docs/adr/**") work cross-platform.
  */
 function matchPattern(filePath, pattern) {
     const regex = patternToRegex(pattern);
-    return regex.test(filePath.toLowerCase());
+    const normalized = filePath.replace(/\\/g, '/').toLowerCase();
+    return regex.test(normalized);
 }
 /**
  * Convert glob pattern to regex
+ *
+ * Uses a placeholder for `**` to prevent the subsequent `*` → `[^/]*`
+ * replacement from clobbering the `*` inside `.*`. A naive two-pass
+ * replacement silently produced `.[^/]*` for every `**` pattern,
+ * which broke glob matching for every doc type.
  */
 function patternToRegex(pattern) {
+    // Escape regex-special characters first
     const escaped = pattern.replace(/[.+^${}()|[\]\\]/g, '\\$&');
+    // Use a placeholder token that can't appear in a normal path
+    const DOUBLE_STAR = '\u0000DOUBLESTAR\u0000';
     const globRegex = escaped
-        .replace(/\*\*/g, '.*')
+        .replace(/\*\*/g, DOUBLE_STAR)
         .replace(/\*/g, '[^/]*')
+        .replace(new RegExp(DOUBLE_STAR, 'g'), '.*')
         .replace(/\?/g, '.');
     return new RegExp(`^${globRegex}$`, 'i');
 }

package/dist/index.js

@@ -50,10 +50,12 @@ const generator_1 = require("./generator");
 const templates_1 = require("./templates");
 const extractor_1 = require("./generator/extractor");
 const program = new commander_1.Command();
+const pkgJsonPath = path.resolve(__dirname, '..', 'package.json');
+const pkgVersion = JSON.parse(fs.readFileSync(pkgJsonPath, 'utf-8')).version;
 program
     .name('vibe-doc')
     .description('AI-powered documentation gap analyzer for any codebase')
-    .version('0.1.0');
+    .version(pkgVersion);
 /**
  * Scan command: Run artifact scanner and save inventory
  */

package/dist/scanner/file-scanner.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"file-scanner.d.ts","sourceRoot":"","sources":["../../src/scanner/file-scanner.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,UAAU,cAAc;IACtB,YAAY,EAAE,eAAe,CAAC;IAC9B,cAAc,EAAE,eAAe,CAAC;IAChC,cAAc,EAAE,eAAe,CAAC;IAChC,aAAa,EAAE,eAAe,CAAC;IAC/B,cAAc,EAAE,eAAe,CAAC;IAChC,WAAW,EAAE,eAAe,CAAC;IAC7B,cAAc,EAAE,eAAe,CAAC;IAChC,SAAS,EAAE,eAAe,CAAC;IAC3B,QAAQ,EAAE,eAAe,CAAC;IAC1B,UAAU,EAAE,eAAe,CAAC;CAC7B;AA8CD,wBAAsB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA2B5E"}
+{"version":3,"file":"file-scanner.d.ts","sourceRoot":"","sources":["../../src/scanner/file-scanner.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAElD,UAAU,cAAc;IACtB,YAAY,EAAE,eAAe,CAAC;IAC9B,cAAc,EAAE,eAAe,CAAC;IAChC,cAAc,EAAE,eAAe,CAAC;IAChC,aAAa,EAAE,eAAe,CAAC;IAC/B,cAAc,EAAE,eAAe,CAAC;IAChC,WAAW,EAAE,eAAe,CAAC;IAC7B,cAAc,EAAE,eAAe,CAAC;IAChC,SAAS,EAAE,eAAe,CAAC;IAC3B,QAAQ,EAAE,eAAe,CAAC;IAC1B,UAAU,EAAE,eAAe,CAAC;CAC7B;AAmDD,wBAAsB,SAAS,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CA2B5E"}

package/dist/scanner/file-scanner.js

@@ -46,6 +46,14 @@ function categorizeFile(filePath) {
     const n = filePath.replace(/\\/g, '/');
     if (n.endsWith('CLAUDE.md'))
         return 'configAsDocs';
+    // Claude Code plugin manifests (plugin.json, marketplace.json inside .claude-plugin/)
+    if (n.includes('/.claude-plugin/') && n.endsWith('.json'))
+        return 'packageConfigs';
+    // SKILL.md files and command docs are plugin surface area
+    if (n.match(/\/skills\/[^/]+\/SKILL\.md$/i))
+        return 'documentation';
+    if (n.match(/\/commands\/[^/]+\.md$/i))
+        return 'documentation';
     if (n.includes('/.ai/') || n.includes('/.agent/skills/'))
         return 'agentArtifacts';
     if (n.includes('/.claude/'))
@@ -64,7 +72,7 @@ function categorizeFile(filePath) {
         return 'apiSpecs';
     return 'sourceCode';
 }
-function walkDir(dir, maxDepth = 4, currentDepth = 0) {
+function walkDir(dir, maxDepth = 6, currentDepth = 0) {
     const files = [];
     if (currentDepth > maxDepth)
         return files;
@@ -73,7 +81,7 @@ function walkDir(dir, maxDepth = 4, currentDepth = 0) {
         for (const entry of entries) {
             if (EXCLUDE_DIRS.has(entry.name))
                 continue;
-            if (entry.name.startsWith('.') && entry.name !== '.ai' && entry.name !== '.agent' && entry.name !== '.claude' && entry.name !== '.github')
+            if (entry.name.startsWith('.') && entry.name !== '.ai' && entry.name !== '.agent' && entry.name !== '.claude' && entry.name !== '.claude-plugin' && entry.name !== '.github')
                 continue;
             const fullPath = path.join(dir, entry.name);
             if (entry.isFile()) {

package/dist/templates/embedded/adr.md

@@ -0,0 +1,45 @@
+---
+docType: adr
+version: 1.0
+templateVersion: 1
+---
+
+# Architecture Decision Record
+
+## Status
+
+{{user.status}}
+
+<!-- NEEDS INPUT: What is the status of this decision? (Proposed, Accepted, Deprecated, Superseded) -->
+
+## Context
+
+{{extracted.context}}
+
+{{user.context}}
+
+<!-- NEEDS INPUT: What is the issue that motivated this decision or any context you should record here? -->
+
+## Decision
+
+{{extracted.decision}}
+
+{{user.decision}}
+
+<!-- NEEDS INPUT: What is the change that we're proposing or have agreed to do? -->
+
+## Consequences
+
+{{extracted.consequences}}
+
+{{user.consequences}}
+
+<!-- NEEDS INPUT: What becomes easier or more difficult to do because of this change? Include positive and negative consequences. -->
+
+## Alternatives
+
+{{extracted.alternatives}}
+
+{{user.alternatives}}
+
+<!-- NEEDS INPUT: What other options did you consider and why were they rejected? -->

package/dist/templates/embedded/api-spec.md

@@ -0,0 +1,55 @@
+---
+docType: api-spec
+version: 1.0
+templateVersion: 1
+---
+
+# API Specification
+
+## Base URL
+
+{{extracted.base-url}}
+
+{{user.base-url}}
+
+<!-- NEEDS INPUT: What is the base URL for your API? Include protocol, hostname, and port. -->
+
+## Endpoints
+
+{{extracted.endpoints}}
+
+{{user.endpoints}}
+
+<!-- NEEDS INPUT: List your primary endpoints. Include HTTP method, path, and brief description. -->
+
+## Request Format
+
+{{extracted.request-format}}
+
+{{user.request-format}}
+
+<!-- NEEDS INPUT: Describe the request format. Include content-type, headers, body structure, and examples. -->
+
+## Response Format
+
+{{extracted.response-format}}
+
+{{user.response-format}}
+
+<!-- NEEDS INPUT: Describe the response format. Include status codes, body structure, headers, and examples. -->
+
+## Error Handling
+
+{{extracted.error-handling}}
+
+{{user.error-handling}}
+
+<!-- NEEDS INPUT: How do you handle errors? Include error codes, error message format, and common errors. -->
+
+## Authentication
+
+{{extracted.authentication}}
+
+{{user.authentication}}
+
+<!-- NEEDS INPUT: How do clients authenticate? Include auth mechanisms, required headers, and token formats. -->

package/dist/templates/embedded/changelog-contributing.md

@@ -0,0 +1,67 @@
+---
+docType: changelog-contributing
+version: 1.0
+templateVersion: 1
+---
+
+# Changelog and Contributing
+
+## Changelog
+
+All notable changes to this project are documented here. The format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/) and versioning follows [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+### Unreleased
+
+{{user.unreleased}}
+
+<!-- NEEDS INPUT: Changes that have landed on main but haven't shipped in a release yet. Group by Added / Changed / Deprecated / Removed / Fixed / Security. -->
+
+### {{user.latestVersion}} — {{user.latestDate}}
+
+{{extracted.latestRelease}}
+
+{{user.latestRelease}}
+
+<!-- NEEDS INPUT: The most recent shipped version. Same Added/Changed/etc. grouping. -->
+
+### Prior Releases
+
+{{extracted.priorReleases}}
+
+{{user.priorReleases}}
+
+<!-- NEEDS INPUT: Older releases in reverse chronological order. Keep summaries short — point to git tags or GitHub releases for full diffs. -->
+
+---
+
+## Contributing
+
+### How to Contribute
+
+{{user.howToContribute}}
+
+<!-- NEEDS INPUT: The high-level contributor path — fork, branch, change, PR. Link to the code of conduct and any contributor license terms. -->
+
+### Development Setup
+
+{{user.devSetup}}
+
+<!-- NEEDS INPUT: What a contributor needs to build and test locally. Prerequisites, install commands, how to run the test suite. This may overlap with the install guide — that's fine, contributors need it in one place. -->
+
+### Proposing a Change
+
+{{user.proposingChange}}
+
+<!-- NEEDS INPUT: Branching strategy, commit message format, PR template expectations, and any required checks (tests, linters, type checks) that must pass. -->
+
+### Review Process
+
+{{user.reviewProcess}}
+
+<!-- NEEDS INPUT: Who reviews PRs, what the turnaround looks like, and what approval is required before merge. -->
+
+### Code of Conduct
+
+{{user.codeOfConduct}}
+
+<!-- NEEDS INPUT: A link to the code of conduct or a short statement of expected behavior. -->

package/dist/templates/embedded/data-model.md

@@ -0,0 +1,55 @@
+---
+docType: data-model
+version: 1.0
+templateVersion: 1
+---
+
+# Data Model
+
+## Entity Overview
+
+{{extracted.entity-overview}}
+
+{{user.entity-overview}}
+
+<!-- NEEDS INPUT: What are the main entities/tables in your data model? Include brief descriptions of each. -->
+
+## Table Schemas
+
+{{extracted.table-schemas}}
+
+{{user.table-schemas}}
+
+<!-- NEEDS INPUT: Describe the schema for each table. Include column names, types, and descriptions. -->
+
+## Relationships
+
+{{extracted.relationships}}
+
+{{user.relationships}}
+
+<!-- NEEDS INPUT: What are the relationships between tables? Include foreign keys and cardinality. -->
+
+## Constraints
+
+{{extracted.constraints}}
+
+{{user.constraints}}
+
+<!-- NEEDS INPUT: What constraints and validation rules exist? Include unique constraints, check constraints, and business rules. -->
+
+## Indexes
+
+{{extracted.indexes}}
+
+{{user.indexes}}
+
+<!-- NEEDS INPUT: What indexes exist and why? Include primary keys, unique indexes, and performance indexes. -->
+
+## Migration Strategy
+
+{{extracted.migration-strategy}}
+
+{{user.migration-strategy}}
+
+<!-- NEEDS INPUT: How do you handle schema migrations? Include versioning, rollback strategy, and zero-downtime deployment. -->

package/dist/templates/embedded/deployment-procedure.md

@@ -0,0 +1,63 @@
+---
+docType: deployment-procedure
+version: 1.0
+templateVersion: 1
+---
+
+# Deployment Procedure
+
+## Prerequisites
+
+{{extracted.prerequisites}}
+
+{{user.prerequisites}}
+
+<!-- NEEDS INPUT: What prerequisites must be met before deployment? Include access, tools, accounts, and configurations. -->
+
+## Build Process
+
+{{extracted.build-process}}
+
+{{user.build-process}}
+
+<!-- NEEDS INPUT: What are the steps to build the application? Include compilation, dependency installation, and artifact generation. -->
+
+## Environment Setup
+
+{{extracted.environment-setup}}
+
+{{user.environment-setup}}
+
+<!-- NEEDS INPUT: What environment variables, secrets, and configurations are required for each environment? -->
+
+## Testing Before Deploy
+
+{{extracted.testing-before-deploy}}
+
+{{user.testing-before-deploy}}
+
+<!-- NEEDS INPUT: What tests and validations run before deployment? Include smoke tests, integration tests, and health checks. -->
+
+## Deployment Steps
+
+{{extracted.deployment-steps}}
+
+{{user.deployment-steps}}
+
+<!-- NEEDS INPUT: What are the step-by-step deployment instructions? Include database migrations, service restarts, and traffic shifting. -->
+
+## Post-Deployment Checks
+
+{{extracted.post-deployment-checks}}
+
+{{user.post-deployment-checks}}
+
+<!-- NEEDS INPUT: What checks verify the deployment was successful? Include health checks, endpoint tests, and monitoring. -->
+
+## Rollback Procedure
+
+{{extracted.rollback-procedure}}
+
+{{user.rollback-procedure}}
+
+<!-- NEEDS INPUT: How do you rollback to the previous version? Include steps, data rollback, and communication plan. -->

package/dist/templates/embedded/install-guide.md

@@ -0,0 +1,49 @@
+---
+docType: install-guide
+version: 1.0
+templateVersion: 1
+---
+
+# Installation Guide
+
+## Prerequisites
+
+{{extracted.prerequisites}}
+
+{{user.prerequisites}}
+
+<!-- NEEDS INPUT: What does a user need before they start? OS, runtime versions (Node 18+, Python 3.11+, etc.), required CLI tools, accounts, API keys. Be specific about minimum versions. -->
+
+## Install Steps
+
+{{extracted.installSteps}}
+
+{{user.installSteps}}
+
+<!-- NEEDS INPUT: The exact ordered steps. For each step, include the command to run and the expected outcome. If there are multiple install paths (npm vs. git clone vs. marketplace), list them all. -->
+
+## Verification
+
+{{user.verification}}
+
+<!-- NEEDS INPUT: How does a user confirm the install worked? A command they can run (e.g., `vibe-doc --version`), a health-check URL, or a first-use command that should produce expected output. -->
+
+## Configuration
+
+{{user.configuration}}
+
+<!-- NEEDS INPUT: Any required configuration after install — env vars, config files, credentials. If none are required, say so explicitly. -->
+
+## Troubleshooting
+
+{{extracted.troubleshooting}}
+
+{{user.troubleshooting}}
+
+<!-- NEEDS INPUT: The three to five most common installation failures and their fixes. Real users have hit these problems — write the fix, not a generic "contact support." -->
+
+## Uninstalling
+
+{{user.uninstall}}
+
+<!-- NEEDS INPUT: How to cleanly remove the project. Include any config files or data directories that need manual cleanup. -->

package/dist/templates/embedded/readme.md

@@ -0,0 +1,55 @@
+---
+docType: readme
+version: 1.0
+templateVersion: 1
+---
+
+# {{user.projectName}}
+
+{{extracted.tagline}}
+
+{{user.tagline}}
+
+<!-- NEEDS INPUT: One-sentence description of what this project is and who it's for. -->
+
+## Overview
+
+{{extracted.overview}}
+
+{{user.overview}}
+
+<!-- NEEDS INPUT: A short paragraph explaining what the project does, the problem it solves, and the audience. Keep it under 100 words. -->
+
+## Installation
+
+{{extracted.installation}}
+
+{{user.installation}}
+
+<!-- NEEDS INPUT: The shortest path to getting the project installed and working. Include prerequisites and the exact install command. -->
+
+## Usage
+
+{{extracted.usage}}
+
+{{user.usage}}
+
+<!-- NEEDS INPUT: A minimal working example showing the most common use case. Prefer a code block or a short step list over prose. -->
+
+## Examples
+
+{{user.examples}}
+
+<!-- NEEDS INPUT: Two or three additional examples covering the next-most-common use cases. Link to a /docs or /examples folder if one exists. -->
+
+## Documentation
+
+{{user.documentation}}
+
+<!-- NEEDS INPUT: Where does a reader go next? Link to fuller docs, a command reference, a changelog, or a contributing guide. -->
+
+## License
+
+{{user.license}}
+
+<!-- NEEDS INPUT: The project's license (usually one line — e.g. "MIT" — and a link to LICENSE). -->

package/dist/templates/embedded/runbook.md

@@ -0,0 +1,55 @@
+---
+docType: runbook
+version: 1.0
+templateVersion: 1
+---
+
+# Runbook
+
+## Service Overview
+
+{{extracted.service-overview}}
+
+{{user.service-overview}}
+
+<!-- NEEDS INPUT: What does this service do? What is its primary responsibility? -->
+
+## Startup Procedure
+
+{{extracted.startup-procedure}}
+
+{{user.startup-procedure}}
+
+<!-- NEEDS INPUT: What are the steps to start the service? Include environment setup, dependencies, configuration. -->
+
+## Health Checks
+
+{{extracted.health-checks}}
+
+{{user.health-checks}}
+
+<!-- NEEDS INPUT: How do you verify the service is healthy? What are the key metrics or checks? -->
+
+## Common Issues
+
+{{extracted.common-issues}}
+
+{{user.common-issues}}
+
+<!-- NEEDS INPUT: What are the most common problems and their solutions? -->
+
+## Rollback Procedure
+
+{{extracted.rollback-procedure}}
+
+{{user.rollback-procedure}}
+
+<!-- NEEDS INPUT: How do you roll back to a previous version? What steps are required? -->
+
+## Escalation Path
+
+{{extracted.escalation-path}}
+
+{{user.escalation-path}}
+
+<!-- NEEDS INPUT: Who should be contacted for different severity levels? What is the on-call process? -->

package/dist/templates/embedded/skill-command-reference.md

@@ -0,0 +1,77 @@
+---
+docType: skill-command-reference
+version: 1.0
+templateVersion: 1
+---
+
+# Skill and Command Reference
+
+This document lists every skill and command this plugin exposes, what each one does, and how to invoke it.
+
+## Skills
+
+{{extracted.skillList}}
+
+{{user.skillList}}
+
+<!-- NEEDS INPUT: One entry per skill. For each: the skill name, a one-sentence description, when a user should reach for it, and a pointer to the underlying SKILL.md file if applicable. -->
+
+### Skill: {{user.skillName}}
+
+**Purpose:** {{user.skillPurpose}}
+
+**When to use:** {{user.skillWhenToUse}}
+
+**Inputs:** {{user.skillInputs}}
+
+**Example:**
+
+```
+{{user.skillExample}}
+```
+
+<!-- NEEDS INPUT: Repeat this block for each skill the plugin ships. -->
+
+## Commands
+
+{{extracted.commandList}}
+
+{{user.commandList}}
+
+<!-- NEEDS INPUT: One entry per slash command. For each: the command, its purpose, arguments (required and optional), and a minimal example invocation. -->
+
+### Command: `{{user.commandName}}`
+
+**Purpose:** {{user.commandPurpose}}
+
+**Syntax:** `/{{user.commandName}} [arguments]`
+
+**Arguments:**
+
+{{user.commandArguments}}
+
+<!-- NEEDS INPUT: List each argument with name, type, required/optional, and a one-line description. -->
+
+**Example:**
+
+```
+{{user.commandExample}}
+```
+
+**Output:**
+
+{{user.commandOutput}}
+
+<!-- NEEDS INPUT: What the user sees when the command succeeds. A screenshot, an expected text snippet, or a description of the artifact created. -->
+
+## Composition
+
+{{user.composition}}
+
+<!-- NEEDS INPUT: If the plugin's commands chain together (e.g., /scan → /report → /generate), document the typical workflow here. Show the order and what each step hands to the next. -->
+
+## Errors and Edge Cases
+
+{{user.errors}}
+
+<!-- NEEDS INPUT: The most common failure modes (missing prerequisites, invalid inputs, environment issues) and how the user should respond. -->

package/dist/templates/embedded/test-plan.md

@@ -0,0 +1,55 @@
+---
+docType: test-plan
+version: 1.0
+templateVersion: 1
+---
+
+# Test Plan
+
+## Test Strategy
+
+{{extracted.test-strategy}}
+
+{{user.test-strategy}}
+
+<!-- NEEDS INPUT: What is your overall testing strategy? Include testing levels, approach, and priorities. -->
+
+## Unit Tests
+
+{{extracted.unit-tests}}
+
+{{user.unit-tests}}
+
+<!-- NEEDS INPUT: What components and functions are covered by unit tests? Include test coverage goals. -->
+
+## Integration Tests
+
+{{extracted.integration-tests}}
+
+{{user.integration-tests}}
+
+<!-- NEEDS INPUT: What system interactions are tested? Include database, APIs, and third-party services. -->
+
+## E2E Tests
+
+{{extracted.e2e-tests}}
+
+{{user.e2e-tests}}
+
+<!-- NEEDS INPUT: What critical user workflows are tested end-to-end? Include scenarios and acceptance criteria. -->
+
+## Performance Tests
+
+{{extracted.performance-tests}}
+
+{{user.performance-tests}}
+
+<!-- NEEDS INPUT: What performance characteristics are tested? Include load tests, latency targets, and throughput. -->
+
+## Coverage Targets
+
+{{extracted.coverage-targets}}
+
+{{user.coverage-targets}}
+
+<!-- NEEDS INPUT: What are your code coverage targets? Include overall target and critical areas. -->

package/dist/templates/embedded/threat-model.md

@@ -0,0 +1,47 @@
+---
+docType: threat-model
+version: 1.0
+templateVersion: 1
+---
+
+# Threat Model
+
+## Asset Scope
+
+{{extracted.asset-scope}}
+
+{{user.asset-scope}}
+
+<!-- NEEDS INPUT: What are the valuable assets you need to protect? Include data, infrastructure, and systems. -->
+
+## Threat Actors
+
+{{extracted.threat-actors}}
+
+{{user.threat-actors}}
+
+<!-- NEEDS INPUT: Who are the potential threat actors? (e.g., external attackers, malicious insiders, nation-states) -->
+
+## Threat Scenarios
+
+{{extracted.threat-scenarios}}
+
+{{user.threat-scenarios}}
+
+<!-- NEEDS INPUT: What are the specific threat scenarios you are concerned about? How might they compromise your assets? -->
+
+## Mitigations
+
+{{extracted.mitigations}}
+
+{{user.mitigations}}
+
+<!-- NEEDS INPUT: What controls do you have in place to mitigate these threats? Include technical, process, and organizational controls. -->
+
+## Residual Risks
+
+{{extracted.residual-risks}}
+
+{{user.residual-risks}}
+
+<!-- NEEDS INPUT: What risks remain after implementing mitigations? What is your risk tolerance? -->

package/dist/templates/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAuBvE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAWvD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAYxC;AAED,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/templates/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM,CAuBvE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAWvD;AAED;;GAEG;AACH,wBAAgB,aAAa,IAAI,MAAM,EAAE,CAgBxC;AAED,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC"}

package/dist/templates/index.js

@@ -99,6 +99,10 @@ function listTemplates() {
         'deployment-procedure',
         'test-plan',
         'data-model',
+        'readme',
+        'install-guide',
+        'skill-command-reference',
+        'changelog-contributing',
     ];
     return templates;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@esthernandez/vibe-doc",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "AI-powered documentation gap analyzer and generator for modern codebases. Scans your project, classifies your architecture, and generates professional docs from your existing artifacts.",
   "author": "626Labs LLC",
   "license": "MIT",