aiknowsys 0.0.1 → 0.0.2

package/README.md

@@ -72,6 +72,8 @@ aiknowsys init
 | `npx aiknowsys install-agents` | Install Developer + Architect agents |
 | `npx aiknowsys install-skills` | Install universal skills |
 
+**💡 AI-Assisted Completion:** After running any command, you'll receive a ready-to-copy prompt that you can paste to your AI assistant (Claude, GPT-4, etc.) to automatically complete the TODO sections based on your actual codebase. No more manual documentation work!
+
 ### Alternative: Manual Setup
 
 <details>

package/lib/commands/init.js

@@ -4,7 +4,7 @@ import { execSync } from 'child_process';
 import inquirer from 'inquirer';
 import chalk from 'chalk';
 import ora from 'ora';
-import { getPackageDir, copyTemplate, hasExistingProject } from '../utils.js';
+import { getPackageDir, copyTemplate, hasExistingProject, displayAIPrompt } from '../utils.js';
 
 export async function init(options) {
   const targetDir = path.resolve(options.dir);
@@ -165,6 +165,17 @@ export async function init(options) {
     console.log(chalk.white('   2. Customize validation matrix in AGENTS.md'));
     console.log(chalk.white('   3. Start using: @Developer <your request>'));
     
+    displayAIPrompt(chalk, [
+      '"I just initialized aiknowsys in my project. Please help me complete',
+      'the TODO sections in CODEBASE_ESSENTIALS.md and AGENTS.md based on my',
+      'codebase. Read those files, scan my project structure, and fill in:',
+      '1. Technology Snapshot - detect all frameworks/tools',
+      '2. Validation Matrix - add appropriate test/lint/build commands',
+      '3. Core Patterns - identify common patterns in my code',
+      '4. Architecture Decisions - document key choices',
+      'Make the documentation specific to MY project, not generic."'
+    ]);
+    
     // OpenSpec installation
     if (answers.useOpenSpec) {
       console.log('');

package/lib/commands/migrate.js

@@ -6,7 +6,7 @@ import ora from 'ora';
 import { scan } from './scan.js';
 import { installAgents } from './install-agents.js';
 import { installSkills } from './install-skills.js';
-import { getPackageDir, copyTemplate } from '../utils.js';
+import { getPackageDir, copyTemplate, displayAIPrompt } from '../utils.js';
 
 export async function migrate(options) {
   const targetDir = path.resolve(options.dir);
@@ -157,5 +157,17 @@ export async function migrate(options) {
   console.log('');
   console.log(chalk.cyan.bold('🚀 Start using:'));
   console.log(chalk.white('   @Developer <your request>'));
-  console.log('');
+  
+  displayAIPrompt(chalk, [
+    'If there are still TODO sections, copy this prompt:',
+    '',
+    '"I migrated my project to aiknowsys. Please review CODEBASE_ESSENTIALS.md',
+    'and complete any remaining TODO sections by:',
+    '1. Analyzing my actual codebase structure and patterns',
+    '2. Filling in specific validation commands (not generic examples)',
+    '3. Documenting the core patterns I actually use',
+    '4. Recording critical invariants and gotchas',
+    '5. Explaining architecture decisions',
+    'Make it project-specific, not a template!"'
+  ]);
 }

package/lib/commands/scan.js

@@ -2,7 +2,7 @@ import fs from 'fs';
 import path from 'path';
 import chalk from 'chalk';
 import ora from 'ora';
-import { getPackageDir } from '../utils.js';
+import { getPackageDir, displayAIPrompt } from '../utils.js';
 
 export async function scan(options) {
   const targetDir = path.resolve(options.dir);
@@ -202,7 +202,17 @@ export async function scan(options) {
     console.log(chalk.white(`   1. Review and complete TODO sections in ${outputFile}`));
     console.log(chalk.white(`   2. Rename to CODEBASE_ESSENTIALS.md when ready`));
     console.log(chalk.white(`   3. Run: ${chalk.cyan('npx aiknowsys install-agents')}`));
-    console.log('');
+    
+    displayAIPrompt(chalk, [
+      '"I just ran aiknowsys scan on my project. Please help me complete',
+      `${outputFile} by:`,
+      '1. Filling in all TODO sections with accurate project details',
+      '2. Adding missing validation commands (tests, linting, type-checking)',
+      '3. Documenting core patterns you find in my codebase',
+      '4. Identifying architecture decisions and rationale',
+      '5. Once complete, rename it to CODEBASE_ESSENTIALS.md',
+      'Then run: npx aiknowsys install-agents"'
+    ]);
     
     return findings;
     

package/lib/utils.js

@@ -85,6 +85,24 @@ export function copyDirectory(source, dest) {
   }
 }
 
+/**
+ * Display AI assistant completion prompt
+ * @param {Object} chalk - Chalk instance for styling
+ * @param {Array<string>} promptLines - Lines of the prompt message
+ */
+export function displayAIPrompt(chalk, promptLines) {
+  console.log('');
+  console.log(chalk.yellow.bold('🤖 AI Assistant Prompt:'));
+  console.log(chalk.gray('   Copy this prompt to your AI assistant to complete setup:'));
+  console.log('');
+  
+  for (const line of promptLines) {
+    console.log(chalk.cyan(`   ${line}`));
+  }
+  
+  console.log('');
+}
+
 /**
  * Escape special regex characters
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "aiknowsys",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "AI-Powered Development Workflow for Consistent, High-Quality Code",
   "keywords": [
     "ai",