@nolrm/contextkit 0.13.3 → 0.13.4

package/README.md

@@ -142,6 +142,9 @@ ContextKit installs reusable slash commands for supported platforms:
 | `/refactor` | Refactor code with safety checks |
 | `/test` | Generate comprehensive tests |
 | `/doc` | Add documentation |
+| `/doc-arch` | Generate architecture docs (`docs/architecture.md`) — stack-aware (Level 1) |
+| `/doc-feature` | Generate feature-level docs (`docs/features/<name>.md`) — stack-aware (Level 2) |
+| `/doc-component` | Generate component-level docs colocated with the target file — stack-aware (Level 3) |
 | `/spec` | Write a component spec (MD-first) before any code is created |
 | `/squad` | Kick off a squad task — one task or many (auto-detects batch mode). Pushes back with clarifying questions if the task is vague. |
 | `/squad-architect` | Design the technical plan from the PO spec |

package/lib/commands/install.js

@@ -806,6 +806,20 @@ Any design decisions, trade-offs, or open questions to resolve before coding.
         '.contextkit/commands/health-check.md'
       );
 
+      // Download doc family commands
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/doc-arch.md`,
+        '.contextkit/commands/doc-arch.md'
+      );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/doc-feature.md`,
+        '.contextkit/commands/doc-feature.md'
+      );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/doc-component.md`,
+        '.contextkit/commands/doc-component.md'
+      );
+
       // Download hooks (pre-push and commit-msg only, no pre-commit)
       await this.downloadManager.downloadFile(
         `${this.repoUrl}/hooks/pre-push`,

package/lib/commands/update.js

@@ -318,6 +318,20 @@ class UpdateCommand {
         '.contextkit/commands/health-check.md'
       );
 
+      // Download doc family commands
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/doc-arch.md`,
+        '.contextkit/commands/doc-arch.md'
+      );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/doc-feature.md`,
+        '.contextkit/commands/doc-feature.md'
+      );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/doc-component.md`,
+        '.contextkit/commands/doc-component.md'
+      );
+
       // Update CI squad workflow if the user opted in
       if (config.features?.squad_ci_workflow) {
         await fs.ensureDir('.github/workflows');

package/lib/integrations/claude-integration.js

@@ -28,6 +28,9 @@ class ClaudeIntegration extends BaseIntegration {
       '.claude/commands/squad-doc.md',
       '.claude/commands/spec.md',
       '.claude/commands/ck.md',
+      '.claude/commands/doc-arch.md',
+      '.claude/commands/doc-feature.md',
+      '.claude/commands/doc-component.md',
     ];
     this.platformDir = '.claude/rules';
   }
@@ -281,6 +284,34 @@ After review passes, create or update companion .md files for every new/modified
 Read \`.contextkit/commands/health-check.md\` and execute the health check workflow.
 
 Check project setup, standards status, and integrations. Report what needs attention.
+`);
+
+    // Doc family slash commands
+    await this.writeGeneratedFile('.claude/commands/doc-arch.md', `# Doc — Architecture (Level 1)
+
+Read \`.contextkit/commands/doc-arch.md\` and execute the architecture documentation workflow.
+
+Detect the project stack, then generate or update \`docs/architecture.md\` with system boundaries, key flows, and stack-appropriate artifacts (Mermaid diagrams, component trees, service maps).
+
+Pass an optional PR number to scope to that PR's changes.
+`);
+
+    await this.writeGeneratedFile('.claude/commands/doc-feature.md', `# Doc — Feature (Level 2)
+
+Read \`.contextkit/commands/doc-feature.md\` and execute the feature documentation workflow.
+
+Detect the project stack, identify the target feature from the argument or current branch, then generate or update \`docs/features/<name>.md\` with purpose, components/modules, data flow, and user flows.
+
+Pass a feature name, directory path, or PR number to scope the documentation.
+`);
+
+    await this.writeGeneratedFile('.claude/commands/doc-component.md', `# Doc — Component (Level 3)
+
+Read \`.contextkit/commands/doc-component.md\` and execute the component documentation workflow.
+
+Detect the project stack, read the target file or directory, then create or update a colocated \`<name>.md\` with API/props, usage examples, behavior, and edge cases.
+
+Pass a file path or directory to target. Omit to infer from current context.
 `);
   }
 
@@ -296,7 +327,10 @@ Check project setup, standards status, and integrations. Report what needs atten
     console.log(chalk.dim('    /fix      — Diagnose and fix a bug'));
     console.log(chalk.dim('    /refactor — Refactor code structure'));
     console.log(chalk.dim('    /test     — Generate or run tests'));
-    console.log(chalk.dim('    /doc      — Add documentation'));
+    console.log(chalk.dim('    /doc           — Add documentation'));
+    console.log(chalk.dim('    /doc-arch      — Architecture docs (Level 1)'));
+    console.log(chalk.dim('    /doc-feature   — Feature docs (Level 2)'));
+    console.log(chalk.dim('    /doc-component — Component docs (Level 3)'));
     console.log(chalk.dim(''));
     console.log(chalk.dim('  Squad (multi-agent workflow):'));
     console.log(chalk.dim('    /squad "task"      — Kickoff: create handoff + PO spec'));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nolrm/contextkit",
-  "version": "0.13.3",
+  "version": "0.13.4",
   "description": "ContextKit - Context Engineering for AI Development. Provide rich context to AI through structured MD files with standards, code guides, and documentation. Works with Cursor, Claude, Aider, VS Code Copilot, and more.",
   "main": "lib/index.js",
   "bin": {