@nolrm/contextkit 0.13.5 → 0.14.0

package/lib/commands/install.js

@@ -1,9 +1,8 @@
 const chalk = require('chalk');
-const ora = require('ora');
 const inquirer = require('inquirer');
 const fs = require('fs-extra');
 const path = require('path');
-const axios = require('axios');
+const childProcess = require('child_process');
 
 const DownloadManager = require('../utils/download');
 const ProjectDetector = require('../utils/project-detector');
@@ -22,7 +21,7 @@ class InstallCommand {
 
   async install(options = {}) {
     // Migrate legacy .vibe-kit/ directory
-    if (await fs.pathExists('.vibe-kit') && !await fs.pathExists('.contextkit')) {
+    if ((await fs.pathExists('.vibe-kit')) && !(await fs.pathExists('.contextkit'))) {
       console.log(chalk.yellow('Found legacy .vibe-kit/ directory'));
       console.log(chalk.yellow('Renaming to .contextkit/...'));
       await fs.move('.vibe-kit', '.contextkit');
@@ -41,8 +40,12 @@ class InstallCommand {
     const hasGit = await this._findFileUpward('.git', 3);
     const hasPkg = await fs.pathExists('package.json');
     if (!hasGit && !hasPkg) {
-      console.log(chalk.yellow('⚠️  No project detected (no .git or package.json found in this directory).'));
-      console.log(chalk.yellow('   Make sure you are inside your project before running `ck install`.'));
+      console.log(
+        chalk.yellow('⚠️  No project detected (no .git or package.json found in this directory).')
+      );
+      console.log(
+        chalk.yellow('   Make sure you are inside your project before running `ck install`.')
+      );
       console.log('');
     }
 
@@ -87,7 +90,9 @@ class InstallCommand {
       const { shouldContinue } = await this.promptReinstall();
       if (!shouldContinue) {
         console.log(chalk.yellow('⏭️  Installation cancelled'));
-        console.log(chalk.dim('💡 To get the latest command and squad files, run: ') + chalk.cyan('ck update'));
+        console.log(
+          chalk.dim('💡 To get the latest command and squad files, run: ') + chalk.cyan('ck update')
+        );
         return;
       }
     }
@@ -114,6 +119,11 @@ class InstallCommand {
       await this.gitHooksManager.installHooks(packageManager, hookChoices);
     }
 
+    // Offer quality tooling scaffold for Node.js projects with pre-push enabled
+    if (hookChoices.prePush && !options.nonInteractive) {
+      await this.promptQualityTooling(packageManager, options);
+    }
+
     // Ask about GitHub Actions CI squad workflow
     let squadCi = false;
     if (!options.nonInteractive) {
@@ -123,6 +133,9 @@ class InstallCommand {
       await this.installGitHubActionsWorkflow();
     }
 
+    // Create quality gates config
+    await this.createQualityGatesConfig();
+
     // Create configuration
     await this.createConfiguration(projectType, hookChoices, squadCi);
 
@@ -151,7 +164,11 @@ class InstallCommand {
 
       if (!integration) {
         console.log(chalk.red(`❌ Unknown platform: ${platform}`));
-        console.log(chalk.yellow('💡 Available: claude, cursor, copilot, codex, opencode, gemini, aider, continue, windsurf'));
+        console.log(
+          chalk.yellow(
+            '💡 Available: claude, cursor, copilot, codex, opencode, gemini, aider, continue, windsurf'
+          )
+        );
         return;
       }
 
@@ -161,7 +178,6 @@ class InstallCommand {
       console.log(chalk.green(`🎉 ${integration.displayName} integration installed!`));
 
       integration.showUsage();
-
     } catch (error) {
       console.log(chalk.red(`❌ Failed to install ${platform} integration`));
       console.log(chalk.yellow(error.message));
@@ -186,30 +202,32 @@ class InstallCommand {
         type: 'confirm',
         name: 'shouldContinue',
         message: 'ContextKit is already installed. Do you want to reinstall?',
-        default: false
-      }
+        default: false,
+      },
     ]);
     return { shouldContinue };
   }
 
   async promptPlatformChoice() {
-    const { platform } = await inquirer.prompt([{
-      type: 'list',
-      name: 'platform',
-      message: 'Which AI tool are you using?',
-      choices: [
-        { name: 'Claude Code', value: 'claude' },
-        { name: 'Cursor', value: 'cursor' },
-        { name: 'Copilot (GitHub)', value: 'copilot' },
-        { name: 'Codex (OpenAI)', value: 'codex' },
-        { name: 'OpenCode', value: 'opencode' },
-        { name: 'Gemini', value: 'gemini' },
-        { name: 'Windsurf', value: 'windsurf' },
-        { name: 'Aider', value: 'aider' },
-        { name: 'Continue', value: 'continue' },
-        { name: 'Skip (base only)', value: null },
-      ]
-    }]);
+    const { platform } = await inquirer.prompt([
+      {
+        type: 'list',
+        name: 'platform',
+        message: 'Which AI tool are you using?',
+        choices: [
+          { name: 'Claude Code', value: 'claude' },
+          { name: 'Cursor', value: 'cursor' },
+          { name: 'Copilot (GitHub)', value: 'copilot' },
+          { name: 'Codex (OpenAI)', value: 'codex' },
+          { name: 'OpenCode', value: 'opencode' },
+          { name: 'Gemini', value: 'gemini' },
+          { name: 'Windsurf', value: 'windsurf' },
+          { name: 'Aider', value: 'aider' },
+          { name: 'Continue', value: 'continue' },
+          { name: 'Skip (base only)', value: null },
+        ],
+      },
+    ]);
     return platform;
   }
 
@@ -257,7 +275,9 @@ class InstallCommand {
         `${this.repoUrl}/templates/github-actions/squad-issue.yml`,
         '.github/workflows/squad-issue.yml'
       );
-      console.log(chalk.green('✅ CI squad workflow installed → .github/workflows/squad-issue.yml'));
+      console.log(
+        chalk.green('✅ CI squad workflow installed → .github/workflows/squad-issue.yml')
+      );
     } catch (error) {
       console.log(chalk.yellow('⚠️  Could not install CI squad workflow:'), error.message);
     }
@@ -270,7 +290,7 @@ class InstallCommand {
       return { prePush: false, commitMsg: false };
     }
 
-    if (!await fs.pathExists('.git')) {
+    if (!(await fs.pathExists('.git'))) {
       console.log(chalk.yellow('⚠️  Skipping Git hooks setup (not a git repository)'));
       return { prePush: false, commitMsg: false };
     }
@@ -291,8 +311,8 @@ class InstallCommand {
         type: 'confirm',
         name: 'prePush',
         message: 'Enable pre-push hook? (runs quality checks before push)',
-        default: false
-      }
+        default: false,
+      },
     ]);
 
     if (prePush) {
@@ -314,8 +334,8 @@ class InstallCommand {
         type: 'confirm',
         name: 'commitMsg',
         message: 'Enable commit-msg hook? (enforces conventional commit format)',
-        default: false
-      }
+        default: false,
+      },
     ]);
 
     if (commitMsg) {
@@ -336,7 +356,7 @@ class InstallCommand {
 
   async createDirectoryStructure() {
     console.log(chalk.blue('📁 Creating structure...'));
-    
+
     const directories = [
       '.contextkit/standards',
       '.contextkit/standards/code-style', // Granular code style files
@@ -350,7 +370,7 @@ class InstallCommand {
       '.contextkit/templates',
       '.contextkit/scripts',
       '.contextkit/integrations',
-      '.contextkit/policies' // Policy enforcement configs
+      '.contextkit/policies', // Policy enforcement configs
     ];
 
     for (const dir of directories) {
@@ -393,7 +413,7 @@ Use conditional loading tags:
 [TypeScript-specific content]
 \`\`\`
 `,
-      
+
       'standards/testing.md': `# Testing Standards
 
 <!-- Content will be generated by running: /analyze -->
@@ -428,7 +448,7 @@ describe("ComponentName", () => {
 - Consistent organization across all test files
 - Quick debugging and maintenance
 `,
-      
+
       'standards/architecture.md': `# Architecture
 
 ## Documentation Levels
@@ -476,22 +496,54 @@ Documentation for a single component or a small, cohesive set of components.
 Your architecture patterns will be documented based on your project structure and organization.
 
 Run \`/analyze\` to generate this content.`,
-      
+
       'standards/ai-guidelines.md': `# AI Guidelines
 
-<!-- Content will be generated by running: /analyze -->
+> Run \`/analyze\` to add project-specific rules to this file.
 
-Guidelines for AI assistance will be defined based on your project's needs and patterns.
+## Agentic Workflow
+
+When working as an agent in this project:
+
+- **Read standards first** — load \`code-style.md\` and \`testing.md\` before writing code
+- **Before pushing** — run through \`.contextkit/commands/agents/agent-push-checklist.md\`
+- **Commit format** — all commits must follow Conventional Commits: \`type(scope): description\`
+  - Valid types: \`feat\`, \`fix\`, \`improve\`, \`docs\`, \`chore\`, \`refactor\`, \`test\`
+- **When to proceed** — proceed if the task is clear and standards cover it
+- **When to ask** — ask if the task is ambiguous, contradicts existing standards, or requires an architecture decision
+- **No debug statements** — do not leave \`console.log\`, \`print\`, or equivalent debug output in production code
+
+## Context Budget
+
+Load standards files in this priority order to use your context window efficiently:
+
+1. **Always load:** \`code-style.md\`, \`testing.md\` — highest signal, always relevant
+2. **Load at session start:** \`ai-guidelines.md\` (this file) — behaviour rules
+3. **Load on demand:** \`architecture.md\` — only when making structural decisions
+4. **Load on demand:** \`workflows.md\` — only for process questions
+5. **Load selectively:** \`code-style/typescript-style.md\`, \`code-style/css-style.md\` — only for the file type you are editing
+6. **Skip unless needed:** \`glossary.md\` — only when the task involves domain-specific terms
+
+If a standards file is longer than 200 lines, read the sections relevant to your task — not the whole file.
+
+## Standards Loop
+
+This project follows a continuous standards loop:
+
+1. Standards files define what correct looks like
+2. Quality gates enforce it at every push (human or agent)
+3. Agents read standards before writing code and write to standards when new patterns emerge
+
+When you discover a pattern worth standardising, use \`/standards-aware\` to decide whether and how to add it.
+Without the standards, agents guess. Without the gates, the guesses reach the repo unchecked.`,
 
-Run \`/analyze\` to generate this content.`,
-      
       'standards/workflows.md': `# Workflows
 
 <!-- Content will be generated by running: /analyze -->
 
 Development workflows and processes will be documented based on your project's practices.
 
-Run \`/analyze\` to generate this content.`
+Run \`/analyze\` to generate this content.`,
     };
 
     // Create granular code-style skeleton files
@@ -562,7 +614,7 @@ This file is loaded when HTML-related tasks are detected:
 <!-- when:html -->
 [HTML-specific content]
 \`\`\`
-`
+`,
     };
 
     for (const [relativePath, content] of Object.entries(skeletonFiles)) {
@@ -688,7 +740,7 @@ Main paths through this feature:
 ## Notes
 
 Any design decisions, trade-offs, or open questions to resolve before coding.
-`
+`,
     };
 
     for (const [relativePath, content] of Object.entries(skeletonFiles)) {
@@ -696,22 +748,22 @@ Any design decisions, trade-offs, or open questions to resolve before coding.
     }
   }
 
-  async downloadFiles(projectType, options = {}) {
+  async downloadFiles(projectType, _options = {}) {
     try {
       // Create skeleton standards files (will be customized by analyze)
       console.log(chalk.blue('📝 Creating skeleton standards files...'));
       await this.createSkeletonStandards();
-      
+
       console.log(chalk.green('✅ Skeleton files created'));
       console.log(chalk.yellow('💡 Run: /analyze to generate content based on your codebase'));
       console.log('');
-      
+
       // Download base files
       await this.downloadManager.downloadFile(
         `${this.repoUrl}/standards/README.md`,
         '.contextkit/standards/README.md'
       );
-      
+
       // Download the actual glossary (keep it as-is, universal across all projects)
       await this.downloadManager.downloadFile(
         `${this.repoUrl}/standards/glossary.md`,
@@ -720,104 +772,118 @@ Any design decisions, trade-offs, or open questions to resolve before coding.
 
       // Download commands
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/analyze.md`,
-        '.contextkit/commands/analyze.md'
+        `${this.repoUrl}/commands/dev/analyze.md`,
+        '.contextkit/commands/dev/analyze.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/review.md`,
-        '.contextkit/commands/review.md'
+        `${this.repoUrl}/commands/dev/review.md`,
+        '.contextkit/commands/dev/review.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/fix.md`,
-        '.contextkit/commands/fix.md'
+        `${this.repoUrl}/commands/dev/fix.md`,
+        '.contextkit/commands/dev/fix.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/refactor.md`,
-        '.contextkit/commands/refactor.md'
+        `${this.repoUrl}/commands/dev/refactor.md`,
+        '.contextkit/commands/dev/refactor.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/run-tests.md`,
-        '.contextkit/commands/run-tests.md'
+        `${this.repoUrl}/commands/dev/run-tests.md`,
+        '.contextkit/commands/dev/run-tests.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/add-documentation.md`,
-        '.contextkit/commands/add-documentation.md'
+        `${this.repoUrl}/commands/docs/add-documentation.md`,
+        '.contextkit/commands/docs/add-documentation.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/quality-check.md`,
-        '.contextkit/commands/quality-check.md'
+        `${this.repoUrl}/commands/dev/quality-check.md`,
+        '.contextkit/commands/dev/quality-check.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/create-feature.md`,
-        '.contextkit/commands/create-feature.md'
+        `${this.repoUrl}/commands/dev/create-feature.md`,
+        '.contextkit/commands/dev/create-feature.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/create-component.md`,
-        '.contextkit/commands/create-component.md'
+        `${this.repoUrl}/commands/dev/create-component.md`,
+        '.contextkit/commands/dev/create-component.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/spec.md`,
-        '.contextkit/commands/spec.md'
+        `${this.repoUrl}/commands/dev/spec.md`,
+        '.contextkit/commands/dev/spec.md'
       );
 
       // Download squad commands
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad.md`,
-        '.contextkit/commands/squad.md'
+        `${this.repoUrl}/commands/squad/squad.md`,
+        '.contextkit/commands/squad/squad.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-architect.md`,
-        '.contextkit/commands/squad-architect.md'
+        `${this.repoUrl}/commands/squad/squad-architect.md`,
+        '.contextkit/commands/squad/squad-architect.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-dev.md`,
-        '.contextkit/commands/squad-dev.md'
+        `${this.repoUrl}/commands/squad/squad-dev.md`,
+        '.contextkit/commands/squad/squad-dev.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-test.md`,
-        '.contextkit/commands/squad-test.md'
+        `${this.repoUrl}/commands/squad/squad-test.md`,
+        '.contextkit/commands/squad/squad-test.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-review.md`,
-        '.contextkit/commands/squad-review.md'
+        `${this.repoUrl}/commands/squad/squad-review.md`,
+        '.contextkit/commands/squad/squad-review.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-auto.md`,
-        '.contextkit/commands/squad-auto.md'
+        `${this.repoUrl}/commands/squad/squad-auto.md`,
+        '.contextkit/commands/squad/squad-auto.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-auto-parallel.md`,
-        '.contextkit/commands/squad-auto-parallel.md'
+        `${this.repoUrl}/commands/squad/squad-auto-parallel.md`,
+        '.contextkit/commands/squad/squad-auto-parallel.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-reset.md`,
-        '.contextkit/commands/squad-reset.md'
+        `${this.repoUrl}/commands/squad/squad-reset.md`,
+        '.contextkit/commands/squad/squad-reset.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-doc.md`,
-        '.contextkit/commands/squad-doc.md'
+        `${this.repoUrl}/commands/squad/squad-doc.md`,
+        '.contextkit/commands/squad/squad-doc.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/squad-ci.md`,
-        '.contextkit/commands/squad-ci.md'
+        `${this.repoUrl}/commands/squad/squad-ci.md`,
+        '.contextkit/commands/squad/squad-ci.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/health-check.md`,
-        '.contextkit/commands/health-check.md'
+        `${this.repoUrl}/commands/dev/health-check.md`,
+        '.contextkit/commands/dev/health-check.md'
       );
 
       // Download doc family commands
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/doc-arch.md`,
-        '.contextkit/commands/doc-arch.md'
+        `${this.repoUrl}/commands/docs/doc-arch.md`,
+        '.contextkit/commands/docs/doc-arch.md'
+      );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/docs/doc-feature.md`,
+        '.contextkit/commands/docs/doc-feature.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/doc-feature.md`,
-        '.contextkit/commands/doc-feature.md'
+        `${this.repoUrl}/commands/docs/doc-component.md`,
+        '.contextkit/commands/docs/doc-component.md'
+      );
+
+      // Download agentic workflow commands
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/agents/context-budget.md`,
+        '.contextkit/commands/agents/context-budget.md'
+      );
+      await this.downloadManager.downloadFile(
+        `${this.repoUrl}/commands/agents/agent-push-checklist.md`,
+        '.contextkit/commands/agents/agent-push-checklist.md'
       );
       await this.downloadManager.downloadFile(
-        `${this.repoUrl}/commands/doc-component.md`,
-        '.contextkit/commands/doc-component.md'
+        `${this.repoUrl}/commands/agents/standards-aware.md`,
+        '.contextkit/commands/agents/standards-aware.md'
       );
 
       // Download hooks (pre-push and commit-msg only, no pre-commit)
@@ -920,15 +986,15 @@ claude "read .contextkit/context.md to see available standards, then create a bu
 - \`.contextkit/product/context.md\` - Domain-specific context
 
 ### Commands
-- \`.contextkit/commands/analyze.md\` - Analyze & customize standards
-- \`.contextkit/commands/review.md\` - Code review
-- \`.contextkit/commands/fix.md\` - Diagnose and fix bugs
-- \`.contextkit/commands/refactor.md\` - Refactor code structure
-- \`.contextkit/commands/run-tests.md\` - Generate or run tests
-- \`.contextkit/commands/add-documentation.md\` - Add documentation
-- \`.contextkit/commands/quality-check.md\` - Quality checks
-- \`.contextkit/commands/create-component.md\` - Create component
-- \`.contextkit/commands/create-feature.md\` - Create feature
+- \`.contextkit/commands/dev/analyze.md\` - Analyze & customize standards
+- \`.contextkit/commands/dev/review.md\` - Code review
+- \`.contextkit/commands/dev/fix.md\` - Diagnose and fix bugs
+- \`.contextkit/commands/dev/refactor.md\` - Refactor code structure
+- \`.contextkit/commands/dev/run-tests.md\` - Generate or run tests
+- \`.contextkit/commands/docs/add-documentation.md\` - Add documentation
+- \`.contextkit/commands/dev/quality-check.md\` - Quality checks
+- \`.contextkit/commands/dev/create-component.md\` - Create component
+- \`.contextkit/commands/dev/create-feature.md\` - Create feature
 
 ### Instructions
 - \`.contextkit/instructions/meta/pre-flight.md\` - Pre-flight checks
@@ -982,7 +1048,7 @@ claude "read .contextkit/standards/README.md .contextkit/standards/glossary.md a
 claude "read .contextkit/product/mission-lite.md .contextkit/standards/code-style.md and create a feature"
 \`\`\`
 `;
-    
+
     await fs.writeFile('.contextkit/context.md', context);
     await fs.writeFile('.contextkit/CONTEXT.md', context); // Keep uppercase for backward compatibility
 
@@ -993,14 +1059,14 @@ claude "read .contextkit/product/mission-lite.md .contextkit/standards/code-styl
 
 CONTEXT_FILE=".contextkit/context.md"
 AI_TOOL="\${AI_TOOL:-aider}"
-PROMPT="\$@"
+PROMPT="$@"
 
 if [ ! -f "$CONTEXT_FILE" ]; then
   echo "❌ ContextKit not initialized. Run: contextkit install"
   exit 1
 fi
 
-CONTEXT=\$(cat "$CONTEXT_FILE")
+CONTEXT=$(cat "$CONTEXT_FILE")
 
 case "$AI_TOOL" in
   "aider")
@@ -1021,7 +1087,7 @@ esac
 
     await fs.writeFile('.contextkit/scripts/ai-cli.sh', cliScript);
     await fs.chmod('.contextkit/scripts/ai-cli.sh', '755');
-    
+
     console.log(chalk.green('✅ CLI helpers installed'));
   }
 
@@ -1046,27 +1112,30 @@ esac
         components: 'src/components',
         tests: 'src/__tests__',
         stories: 'src/stories',
-        docs: 'docs'
+        docs: 'docs',
       },
       commands: {
-        analyze: '@.contextkit/commands/analyze.md',
-        review: '@.contextkit/commands/review.md',
-        fix: '@.contextkit/commands/fix.md',
-        refactor: '@.contextkit/commands/refactor.md',
-        run_tests: '@.contextkit/commands/run-tests.md',
-        add_docs: '@.contextkit/commands/add-documentation.md',
-        quality_check: '@.contextkit/commands/quality-check.md',
-        create_component: '@.contextkit/commands/create-component.md',
-        create_feature: '@.contextkit/commands/create-feature.md'
-      }
+        analyze: '@.contextkit/commands/dev/analyze.md',
+        review: '@.contextkit/commands/dev/review.md',
+        fix: '@.contextkit/commands/dev/fix.md',
+        refactor: '@.contextkit/commands/dev/refactor.md',
+        run_tests: '@.contextkit/commands/dev/run-tests.md',
+        add_docs: '@.contextkit/commands/docs/add-documentation.md',
+        quality_check: '@.contextkit/commands/dev/quality-check.md',
+        create_component: '@.contextkit/commands/dev/create-component.md',
+        create_feature: '@.contextkit/commands/dev/create-feature.md',
+      },
     };
 
     const now = new Date().toISOString();
-    const isMonorepo = await fs.pathExists('packages') || await fs.pathExists('apps') || 
-                       (await fs.pathExists('package.json') && 
-                        (await fs.readJson('package.json').catch(() => ({}))).workspaces);
-    
-    await fs.writeFile('.contextkit/config.yml',
+    const isMonorepo =
+      (await fs.pathExists('packages')) ||
+      (await fs.pathExists('apps')) ||
+      ((await fs.pathExists('package.json')) &&
+        (await fs.readJson('package.json').catch(() => ({}))).workspaces);
+
+    await fs.writeFile(
+      '.contextkit/config.yml',
       `# ContextKit Configuration
 _source:
   tool: "@nolrm/contextkit"
@@ -1165,7 +1234,7 @@ https://www.npmjs.com/package/@nolrm/contextkit
       status.features.pre_push_hook = hookChoices.prePush;
       status.features.commit_msg_hook = hookChoices.commitMsg;
       status.features.squad_ci_workflow = squadCi;
-      
+
       await this.statusManager.saveStatus(status);
       console.log(chalk.green('✅ Status tracking initialized'));
     } catch (error) {
@@ -1175,7 +1244,7 @@ https://www.npmjs.com/package/@nolrm/contextkit
 
   async createProductContext() {
     console.log(chalk.blue('📦 Creating product context files...'));
-    
+
     const missionContent = `# Product Mission
 
 <!-- Content will be generated by running: ck analyze or manually fill this in -->
@@ -1373,13 +1442,13 @@ Unlike [COMPETITOR_OR_ALTERNATIVE], we provide [SPECIFIC_ADVANTAGE]. This result
     await fs.writeFile('.contextkit/product/roadmap.md', roadmapContent);
     await fs.writeFile('.contextkit/product/decisions.md', decisionsContent);
     await fs.writeFile('.contextkit/product/context.md', contextContent);
-    
+
     console.log(chalk.green('✅ Product context files created'));
   }
 
   async createCorrectionsLog() {
     console.log(chalk.blue('📝 Creating corrections log system...'));
-    
+
     const correctionsContent = `# ContextKit Corrections Log
 
 ## Description
@@ -1565,14 +1634,17 @@ Automatically track and log ContextKit performance issues during development ses
 `;
 
     await fs.writeFile('.contextkit/corrections.md', correctionsContent);
-    await fs.writeFile('.contextkit/instructions/core/auto-corrections-log.md', autoCorrectionsContent);
-    
+    await fs.writeFile(
+      '.contextkit/instructions/core/auto-corrections-log.md',
+      autoCorrectionsContent
+    );
+
     console.log(chalk.green('✅ Corrections log system created'));
   }
 
   async createMetaInstructions() {
     console.log(chalk.blue('📋 Creating meta instructions...'));
-    
+
     const preFlightContent = `---
 description: Common Pre-Flight Steps for ContextKit Instructions
 globs:
@@ -1646,13 +1718,13 @@ After completing any development session, automatically update the corrections l
 
     await fs.writeFile('.contextkit/instructions/meta/pre-flight.md', preFlightContent);
     await fs.writeFile('.contextkit/instructions/meta/post-flight.md', postFlightContent);
-    
+
     console.log(chalk.green('✅ Meta instructions created'));
   }
 
   async createPolicyFile() {
     console.log(chalk.blue('⚖️  Creating policy file...'));
-    
+
     const policyContent = `# ContextKit Policy Configuration
 
 ## Enforcement Levels
@@ -1676,11 +1748,11 @@ enforcement:
 `;
 
     await fs.writeFile('.contextkit/policies/policy.yml', policyContent);
-    
+
     console.log(chalk.green('✅ Policy file created'));
   }
 
-  showSuccessMessage(hookChoices, platform = null, projectType = '', packageManager = '') {
+  showSuccessMessage(hookChoices, platform = null, _projectType = '', _packageManager = '') {
     console.log('');
     console.log(chalk.green('🎉 ContextKit v1.0.0 successfully installed!'));
     console.log('');
@@ -1702,7 +1774,9 @@ enforcement:
     console.log(chalk.bold('📖 Quick Reference'));
     console.log(''.padEnd(48, '─'));
     console.log(`ck status    → Check installation & integrations`);
-    console.log(`ck <platform> → Add platform (claude, cursor, copilot, codex, opencode, gemini, aider, continue, windsurf)`);
+    console.log(
+      `ck <platform> → Add platform (claude, cursor, copilot, codex, opencode, gemini, aider, continue, windsurf)`
+    );
     console.log('');
     console.log(`Docs → ${chalk.blue('https://contextkit-docs.vercel.app')}`);
     console.log(`Issues → ${chalk.blue('https://github.com/nolrm/contextkit/issues')}`);
@@ -1715,7 +1789,7 @@ enforcement:
 
     if (platform === 'cursor') {
       console.log(chalk.bold('In Cursor Chat:'));
-      console.log(`   @.contextkit/commands/analyze.md`);
+      console.log(`   @.contextkit/commands/dev/analyze.md`);
       console.log('');
       console.log('Or via CLI:');
       console.log(chalk.yellow('👉'), `/analyze`);
@@ -1741,19 +1815,23 @@ enforcement:
 
     if (platform === 'cursor') {
       console.log(chalk.bold('In Cursor Chat'));
-      console.log(`@.contextkit/commands/create-component.md`);
+      console.log(`@.contextkit/commands/dev/create-component.md`);
       console.log(chalk.dim('"Create a Button component for customer checkout"'));
       console.log('');
     }
 
     console.log(chalk.bold('In CLI'));
-    console.log(chalk.dim('Use your AI tool\'s slash command, e.g. /analyze or @.contextkit/commands/create-component.md'));
+    console.log(
+      chalk.dim(
+        "Use your AI tool's slash command, e.g. /analyze or @.contextkit/commands/dev/create-component.md"
+      )
+    );
     console.log('');
 
     if (platform === 'claude' || platform === 'gemini') {
       const toolName = platform === 'claude' ? 'Claude' : 'Gemini';
       console.log(chalk.bold(`In ${toolName} CLI`));
-      console.log(`read .contextkit/commands/analyze.md and execute`);
+      console.log(`read .contextkit/commands/dev/analyze.md and execute`);
       console.log('');
     }
 
@@ -1761,6 +1839,179 @@ enforcement:
     console.log('');
   }
 
+  async promptQualityTooling(packageManager, _options = {}) {
+    // Only relevant for Node.js projects
+    if (!(await fs.pathExists('package.json'))) return;
+
+    // Skip in CI / non-interactive mode
+    if (process.env.CI === 'true' || process.env.NON_INTERACTIVE === 'true') return;
+
+    const pkg = await fs.readJson('package.json').catch(() => null);
+    if (!pkg) return;
+
+    const hasFormat = !!(pkg.scripts && pkg.scripts.format);
+    const hasLint = !!(pkg.scripts && pkg.scripts.lint);
+
+    // Both already present — nothing to do
+    if (hasFormat && hasLint) return;
+
+    console.log('');
+    console.log('──────────────────────────────────────────────');
+    console.log(chalk.blue('🛠️  Format + Lint Quality Gates'));
+    console.log('──────────────────────────────────────────────');
+    console.log(chalk.dim('The pre-push hook runs format and lint scripts automatically'));
+    console.log(chalk.dim('when present. Your project has none — add a minimal setup now?'));
+    console.log('');
+
+    const { scaffold } = await inquirer.prompt([
+      {
+        type: 'confirm',
+        name: 'scaffold',
+        message: 'Add prettier + eslint setup? (adds scripts + config files)',
+        default: false,
+      },
+    ]);
+
+    if (scaffold) {
+      await this.scaffoldQualityTooling(pkg, packageManager);
+    } else {
+      console.log(chalk.dim('💡 Add format/lint scripts later to activate these quality gates'));
+    }
+    console.log('');
+  }
+
+  async scaffoldQualityTooling(pkg, packageManager) {
+    const pmInstallFlags = {
+      npm: 'install --save-dev',
+      yarn: 'add --dev',
+      pnpm: 'add -D',
+      bun: 'add -d',
+    };
+    const installFlag = pmInstallFlags[packageManager] || 'install --save-dev';
+    const pm = packageManager === 'none' ? 'npm' : packageManager;
+
+    try {
+      const created = [];
+
+      // 1. Add missing scripts to package.json
+      if (!pkg.scripts) pkg.scripts = {};
+      if (!pkg.scripts.format) {
+        pkg.scripts.format = 'prettier --write .';
+        created.push('format script');
+      }
+      if (!pkg.scripts.lint) {
+        pkg.scripts.lint = 'eslint .';
+        created.push('lint script');
+      }
+      await fs.writeFile('package.json', JSON.stringify(pkg, null, 2) + '\n');
+
+      // 2. Create .prettierrc if no existing config
+      if (!(await this._hasExistingPrettierConfig(pkg))) {
+        await fs.writeFile(
+          '.prettierrc',
+          JSON.stringify(
+            { singleQuote: true, semi: true, tabWidth: 2, printWidth: 100, trailingComma: 'es5' },
+            null,
+            2
+          ) + '\n'
+        );
+        created.push('.prettierrc');
+      }
+
+      // 3. Create .prettierignore if absent
+      if (!(await fs.pathExists('.prettierignore'))) {
+        await fs.writeFile('.prettierignore', 'node_modules/\ncoverage/\ndist/\nbuild/\n');
+        created.push('.prettierignore');
+      }
+
+      // 4. Create eslint.config.js if no existing config
+      if (!(await this._hasExistingEslintConfig(pkg))) {
+        await fs.writeFile(
+          'eslint.config.js',
+          `const js = require('@eslint/js');
+const globals = require('globals');
+
+module.exports = [
+  js.configs.recommended,
+  {
+    languageOptions: {
+      ecmaVersion: 2022,
+      globals: {
+        ...globals.node,
+      },
+    },
+    rules: {
+      'no-unused-vars': ['warn', { argsIgnorePattern: '^_', varsIgnorePattern: '^_' }],
+    },
+  },
+  {
+    files: ['**/__tests__/**/*.js', '**/*.test.js'],
+    languageOptions: {
+      globals: {
+        ...globals.jest,
+      },
+    },
+  },
+];\n`
+        );
+        created.push('eslint.config.js');
+      }
+
+      // 5. Install devDependencies
+      console.log(chalk.blue(`\n📦 Installing prettier + eslint...`));
+      childProcess.execSync(`${pm} ${installFlag} prettier eslint @eslint/js globals`, {
+        stdio: 'inherit',
+      });
+
+      console.log('');
+      console.log(chalk.green('✅ Quality tooling ready:'));
+      created.forEach((item) => console.log(chalk.dim(`   • ${item}`)));
+      console.log(chalk.dim('   Run npm run format to apply formatting to existing files'));
+    } catch (error) {
+      console.log(chalk.yellow('⚠️  Could not complete quality tooling setup:'), error.message);
+      console.log(chalk.dim('   You can set this up manually later'));
+    }
+  }
+
+  async _hasExistingPrettierConfig(pkg) {
+    if (pkg.prettier) return true;
+    const configs = [
+      '.prettierrc',
+      '.prettierrc.json',
+      '.prettierrc.js',
+      '.prettierrc.mjs',
+      '.prettierrc.cjs',
+      '.prettierrc.yaml',
+      '.prettierrc.yml',
+      '.prettierrc.toml',
+      'prettier.config.js',
+      'prettier.config.mjs',
+      'prettier.config.cjs',
+    ];
+    for (const f of configs) {
+      if (await fs.pathExists(f)) return true;
+    }
+    return false;
+  }
+
+  async _hasExistingEslintConfig(pkg) {
+    if (pkg.eslintConfig) return true;
+    const configs = [
+      'eslint.config.js',
+      'eslint.config.mjs',
+      'eslint.config.cjs',
+      '.eslintrc',
+      '.eslintrc.js',
+      '.eslintrc.json',
+      '.eslintrc.yml',
+      '.eslintrc.yaml',
+    ];
+    for (const f of configs) {
+      if (await fs.pathExists(f)) return true;
+    }
+    return false;
+  }
+
   async _findFileUpward(name, maxLevels) {
     let dir = process.cwd();
     for (let i = 0; i <= maxLevels; i++) {
@@ -1771,6 +2022,59 @@ enforcement:
     }
     return false;
   }
+
+  async createQualityGatesConfig() {
+    const configPath = '.contextkit/quality-gates.yml';
+    if (await fs.pathExists(configPath)) return;
+    const content = `# Quality Gates Configuration
+# Disable specific gates by uncommenting keys below.
+# All gates are enabled by default.
+# Reference: https://contextkit-docs.vercel.app/docs/quality-gates
+
+disabled:
+  # Node.js gates
+  # - typescript      # skip TypeScript type checking
+  # - eslint          # skip ESLint (direct, not via script)
+  # - prettier        # skip Prettier (direct, not via script)
+  # - format          # skip npm run format
+  # - lint            # skip npm run lint
+  # - build           # skip npm run build
+  # - test            # skip npm test
+  # - e2e             # skip npm run e2e
+  # Python gates
+  # - ruff-lint       # skip ruff/flake8 lint
+  # - typecheck       # skip mypy
+  # - ruff-format     # skip ruff/black format check
+  # - pytest          # skip pytest
+  # Rust gates
+  # - cargo-check     # skip cargo check
+  # - clippy          # skip cargo clippy
+  # - cargo-test      # skip cargo test
+  # Go gates
+  # - go-vet          # skip go vet
+  # - golangci-lint   # skip golangci-lint
+  # - go-test         # skip go test
+  # PHP gates
+  # - phpstan         # skip PHPStan
+  # - phpunit         # skip PHPUnit
+  # Ruby gates
+  # - rubocop         # skip RuboCop
+  # - rspec           # skip RSpec / rake test
+  # Java / Kotlin gates
+  # - maven-verify    # skip mvn verify
+  # - gradle-check    # skip gradle check
+  # - ktlint          # skip ktlint
+  # - kotlin-test     # skip gradle test
+  # Swift gates
+  # - swiftlint       # skip SwiftLint
+  # - swift-test      # skip swift test
+  # .NET gates
+  # - dotnet-build    # skip dotnet build
+  # - dotnet-test     # skip dotnet test
+`;
+    await fs.writeFile(configPath, content);
+    console.log(chalk.green('✅ Created .contextkit/quality-gates.yml'));
+  }
 }
 
 async function install(options) {
@@ -1779,3 +2083,4 @@ async function install(options) {
 }
 
 module.exports = install;
+module.exports.InstallCommand = InstallCommand;