telos-framework 0.3.2 → 0.4.0

package/.claude/commands/telos/init.md

@@ -9,6 +9,40 @@ architecture for AI-assisted software development. Your role is to analyze this
 codebase, propose a complete hierarchy from ultimate purpose (L9) to code
 structure (L1), and generate all necessary files.
 
+## Step 0: Detect AI Platform & Create Config
+
+**IMPORTANT**: Before proceeding, detect which AI coding assistant is running:
+
+1. **Check environment indicators**:
+   - Claude Code: Check if `.claude/` directory exists or if running from Claude
+     slash command
+   - Opencode: Check if `.opencode/` directory exists or `OPENCODE_SESSION` env
+     var
+   - Other: Neither detected
+
+2. **If running from Claude Code AND no `CLAUDE.md` exists**:
+   - Create `CLAUDE.md` with the Telos reference template (see section 4.3 for
+     template)
+   - Include note: "Auto-generated by Telos initialization"
+
+3. **If `CLAUDE.md` exists but doesn't mention Telos**:
+   - Prepend the Telos reference section (see section 4.3)
+
+4. **Ask user which platform they want to initialize for**:
+
+```
+Which AI coding platform would you like to initialize Telos for?
+
+1. Claude Code (slash commands in `.claude/commands/telos/`)
+2. Opencode (commands in `.opencode/command/telos/`)
+3. Both
+4. Skip command installation (manual setup)
+
+Your choice [1-4]:
+```
+
+Store their response for Step 4.4.
+
 ## Step 1: Analyze Codebase
 
 Read and analyze the following to understand this project:
@@ -148,7 +182,7 @@ Reasoning: [Based on detected linters, formatters, and quality standards]
 ═══════════════════════════════════════════════════════════════════════════
 ```
 
-### Auto-generation Guidelines for L1-L4:
+### Auto-generation Guidelines for L1-L4
 
 **L1 (Syntax-Linter)** - Based on detected tools:
 
@@ -185,6 +219,7 @@ After presenting the table, say:
 **Strategic layers (L9-L5) define your project's purpose and require your input.**
 
 **Technical layers (L1-L4) are auto-generated based on your detected tooling:**
+
 - L1: [List detected linters]
 - L2: [List detected test frameworks]
 - L3: [List detected component frameworks]
@@ -193,6 +228,7 @@ After presenting the table, say:
 **Please review the strategic layers (L9-L5). Would you like to refine any of these?**
 
 Options:
+
 - "Accept all" - Proceed with generation
 - "Refine L9" - Edit ultimate purpose layer
 - "Refine L8" - Edit business value layer
@@ -254,13 +290,13 @@ Tools**: [Build systems]
 ## Initialization Metadata
 
 - **Initialized**: [Current date]
-- **AI Assistant**: Claude via Telos `/telos-init`
+- **AI Assistant**: Claude via Telos `/telos:init`
 - **Project Type**: [Inferred project type]
 ```
 
 ### 4.2 Create Agent Files
 
-For each level (L9 → L1), create `..telos/agents/l[N]-[agent-name].md`:
+For each level (L9 → L1), create `.telos/agents/l[N]-[agent-name].md`:
 
 **Template structure:**
 
@@ -346,15 +382,25 @@ Check for and update existing AI assistant configuration files to reference
 
 **Files to check:**
 
-- `AGENTS.md` - Unified standard (if exists, prepend Telos reference)
-- `CLAUDE.md` - Claude Code (if exists, prepend Telos reference)
+- `AGENTS.md` - Unified standard (always create/update if doesn't exist)
+- `CLAUDE.md` - Claude Code (always create if running from Claude and doesn't
+  exist)
 - `.cursorrules` - Cursor IDE (if exists, prepend Telos reference)
 - `.clinerules` - Cline/VS Code (if exists, prepend Telos reference)
 - `.windsurfrules` - Windsurf IDE (if exists, prepend Telos reference)
 - `.roo/config` or `.roocode` - Roo Code (if exists, prepend Telos reference)
 - `GEMINI.md` - Google Gemini (if exists, prepend Telos reference)
 
-**For each existing file, prepend this instruction:**
+**CLAUDE.md Creation Rule**:
+
+- If running from Claude Code (detected via `.claude/` directory or slash
+  command context)
+- AND `CLAUDE.md` does not exist
+- Create `CLAUDE.md` with Telos reference template below
+- Add comment: `<!-- Auto-generated by Telos initialization -->`
+
+**For each existing file (or newly created CLAUDE.md), prepend this
+instruction:**
 
 ```markdown
 ## Telos Purpose Hierarchy
@@ -383,7 +429,7 @@ all development decisions.
 - L2 (Function-Author): Functions - is this testable and maintainable?
 - L1 (Syntax-Linter): Code quality - does this pass linting/formatting?
 
-See `.telos/TELOS.md` for complete hierarchy and `..telos/agents/` for detailed
+See `.telos/TELOS.md` for complete hierarchy and `.telos/agents/` for detailed
 agent definitions.
 
 ---
@@ -392,7 +438,104 @@ agent definitions.
 **If no AI assistant config files exist**, create `AGENTS.md` with Telos
 content.
 
-### 4.4 Create Orchestrator (Optional)
+### 4.4 Install Platform-Specific Commands
+
+Based on user's choice from Step 0:
+
+#### Option 1: Claude Code Commands
+
+Create slash commands in `.claude/commands/telos/`:
+
+**Files to create:**
+
+- `init.md` - This initialization command
+- `quick.md` - Quick initialization with auto-accept
+- `validate.md` - Validate code against Telos hierarchy
+- `status.md` - Show current Telos configuration
+- `reset.md` - Clear and reinitialize
+
+All use standard markdown format (already created by `telos init` CLI).
+
+#### Option 2: Opencode Commands
+
+Create commands in `.opencode/command/telos/` using frontmatter format:
+
+**Template structure for Opencode:**
+
+```markdown
+---
+description: [Command description]
+---
+
+[Command template/prompt here]
+```
+
+**Files to create:**
+
+1. `.opencode/command/telos/init.md`:
+
+```markdown
+---
+description: Initialize Telos multi-agent system for this project
+---
+
+[Copy full content from .claude/commands/telos/init.md]
+```
+
+2. `.opencode/command/telos/quick.md`:
+
+```markdown
+---
+description: Quick Telos initialization with auto-accepted AI proposals
+---
+
+[Copy full content from .claude/commands/telos/quick.md]
+```
+
+3. `.opencode/command/telos/validate.md`:
+
+```markdown
+---
+description: Validate current code against Telos purpose hierarchy
+---
+
+[Copy full content from .claude/commands/telos/validate.md]
+```
+
+4. `.opencode/command/telos/status.md`:
+
+```markdown
+---
+description: Show current Telos configuration and hierarchy
+---
+
+[Copy full content from .claude/commands/telos/status.md]
+```
+
+5. `.opencode/command/telos/reset.md`:
+
+```markdown
+---
+description: Clear existing Telos installation and reinitialize
+---
+
+[Copy full content from .claude/commands/telos/reset.md]
+```
+
+**Note**: Opencode commands use the same prompt content as Claude Code commands,
+just with added YAML frontmatter for the `description` field.
+
+#### Option 3: Both Platforms
+
+Create command files in both `.claude/commands/telos/` AND
+`.opencode/command/telos/`.
+
+#### Option 4: Skip Command Installation
+
+Only create `.telos/` directory structure and config file integrations. User
+will manually install commands later via `telos init` CLI.
+
+### 4.5 Create Orchestrator (Optional)
 
 If JavaScript/Node.js project, create `logos/orchestrator.js`:
 
@@ -417,25 +560,66 @@ Once all files are generated, display:
 ✅ **Telos initialization complete!**
 
 **Generated files:**
+
 - `.telos/TELOS.md` - Ultimate purpose and hierarchy
-- `..telos/agents/l9-telos-guardian.md` through `l1-syntax-linter.md`
+- `.telos/agents/l9-telos-guardian.md` through `l1-syntax-linter.md`
 - Updated AI assistant config files (AGENTS.md, CLAUDE.md, .cursorrules, etc.)
+- Platform commands: [List based on Step 0 choice]
+  - Claude Code: `.claude/commands/telos/*.md` (5 commands)
+  - Opencode: `.opencode/command/telos/*.md` (5 commands)
 - `logos/orchestrator.js` - Request router (if applicable)
 
 **Next steps:**
-1. Review the generated agent definitions in `..telos/agents/`
-2. Run `/telos-validate` to check alignment with current codebase
-3. Run `/telos-status` to see current configuration
+
+1. Review the generated agent definitions in `.telos/agents/`
+2. Run validation command to check alignment with current codebase
+3. Run status command to see current configuration
 4. Start developing with purpose-driven AI assistance!
 
 **Your AI assistant now knows about Telos!** All existing config files (AGENTS.md,
 CLAUDE.md, .cursorrules, etc.) have been updated to reference `.telos/TELOS.md`
 before making changes.
 
+**Commands available:**
+
+**Claude Code:**
+- `/telos:validate` - Check if current code aligns with Telos
+- `/telos:status` - Show current Telos configuration
+- `/telos:reset` - Clear and reinitialize
+
+**Opencode:**
+- `/telos/init` - Initialize Telos (this command)
+- `/telos/validate` - Check if current code aligns with Telos
+- `/telos/status` - Show current Telos configuration
+- `/telos/reset` - Clear and reinitialize
+---
+
+✅ **Telos initialization complete!**
+
+**Generated files:**
+
+- `.telos/TELOS.md` - Ultimate purpose and hierarchy
+- `.telos/agents/l9-telos-guardian.md` through `l1-syntax-linter.md`
+- Updated AI assistant config files (AGENTS.md, CLAUDE.md, .cursorrules, etc.)
+- `logos/orchestrator.js` - Request router (if applicable)
+
+**Next steps:**
+
+1. Review the generated agent definitions in `.telos/agents/`
+2. Run `/telos:validate` to check alignment with current codebase
+3. Run `/telos:status` to see current configuration
+4. Start developing with purpose-driven AI assistance!
+
+**Your AI assistant now knows about Telos!** All existing config files
+(AGENTS.md, CLAUDE.md, .cursorrules, etc.) have been updated to reference
+`.telos/TELOS.md` before making changes.
+
 **Slash commands available:**
-- `/telos-validate` - Check if current code aligns with Telos
-- `/telos-status` - Show current Telos configuration
-- `/telos-reset` - Clear and reinitialize
+
+- `/telos:validate` - Check if current code aligns with Telos
+- `/telos:status` - Show current Telos configuration
+- `/telos:reset` - Clear and reinitialize
+
 ---
 
 ## Tips

package/lib/commands/init.js

@@ -1,5 +1,6 @@
 const chalk = require('chalk');
 const path = require('path');
+const { default: inquirer } = require('inquirer');
 const { installSlashCommands } = require('../installers/slash-commands');
 const { setupMemoryFiles } = require('../installers/memory-files');
 
@@ -11,16 +12,48 @@ async function initCommand(options) {
   try {
     const projectRoot = process.cwd();
 
-    console.log(chalk.cyan('Installing Telos slash commands...\n'));
+    const answers = await inquirer.prompt([
+      {
+        type: 'checkbox',
+        name: 'platforms',
+        message: 'Which AI coding platforms do you want to initialize Telos for?',
+        choices: [
+          { name: 'Claude Code', value: 'claude', checked: true },
+          { name: 'Opencode', value: 'opencode' },
+          { name: 'Cursor', value: 'cursor' },
+          { name: 'Cline', value: 'cline' },
+          { name: 'Windsurf', value: 'windsurf' },
+          { name: 'Roo', value: 'roo' },
+          { name: 'Gemini', value: 'gemini' },
+          { name: 'Other (AGENTS.md only)', value: 'other' }
+        ],
+        validate: (answer) => {
+          if (answer.length === 0) {
+            return 'You must choose at least one platform or press Ctrl+C to cancel.';
+          }
+          return true;
+        }
+      }
+    ]);
+
+    const platforms = answers.platforms;
 
-    const commandResults = await installSlashCommands(projectRoot);
+    console.log(chalk.cyan('\nInstalling Telos commands...\n'));
+
+    const commandResults = await installSlashCommands(projectRoot, platforms);
     
-    for (const { platform, results } of commandResults) {
+    for (const { platform: platformName, results } of commandResults) {
       const successful = results.filter(r => r.success);
       if (successful.length > 0) {
-        console.log(chalk.green(`✓ Installed ${successful.length} command(s) for ${platform}:`));
+        console.log(chalk.green(`✓ Installed ${successful.length} command(s) for ${platformName}:`));
         successful.forEach(r => {
-          console.log(chalk.dim(`  - /telos-${r.file.replace('.md', '')}`));
+          const cmdPrefix = platformName === 'claude' ? '/telos:' : 
+                           platformName === 'opencode' ? '/telos/' : '';
+          if (cmdPrefix) {
+            console.log(chalk.dim(`  - ${cmdPrefix}${r.file.replace('.md', '')}`));
+          } else {
+            console.log(chalk.dim(`  - ${r.file}`));
+          }
         });
       }
       
@@ -33,24 +66,26 @@ async function initCommand(options) {
       }
     }
 
-    console.log(chalk.cyan('\nSetting up memory files...\n'));
+    console.log(chalk.cyan('\nSetting up configuration files...\n'));
 
-    const memoryResults = await setupMemoryFiles(projectRoot);
+    const memoryResults = await setupMemoryFiles(projectRoot, platforms);
     
-    if (memoryResults.agents.created) {
-      console.log(chalk.green('✓ Created AGENTS.md'));
-    } else if (memoryResults.agents.updated) {
-      console.log(chalk.green('✓ Updated AGENTS.md with Telos content'));
-    } else {
-      console.log(chalk.dim('✓ AGENTS.md already contains Telos content'));
-    }
-    
-    if (memoryResults.claude.created) {
-      console.log(chalk.green('✓ Created CLAUDE.md'));
-    } else if (memoryResults.claude.updated) {
-      console.log(chalk.green('✓ Updated CLAUDE.md with Telos instructions'));
-    } else {
-      console.log(chalk.dim('✓ CLAUDE.md already contains Telos content'));
+    for (const [fileType, result] of Object.entries(memoryResults)) {
+      const fileName = fileType === 'agents' ? 'AGENTS.md' :
+                      fileType === 'claude' ? 'CLAUDE.md' :
+                      fileType === 'cursor' ? '.cursorrules' :
+                      fileType === 'cline' ? '.clinerules' :
+                      fileType === 'windsurf' ? '.windsurfrules' :
+                      fileType === 'roo' ? '.roocode' :
+                      fileType === 'gemini' ? 'GEMINI.md' : fileType;
+      
+      if (result.created) {
+        console.log(chalk.green(`✓ Created ${fileName}`));
+      } else if (result.updated) {
+        console.log(chalk.green(`✓ Updated ${fileName} with Telos content`));
+      } else if (result.reason === 'already-exists') {
+        console.log(chalk.dim(`✓ ${fileName} already contains Telos content`));
+      }
     }
 
     console.log(chalk.bold.cyan('\n╔══════════════════════════════════════════╗'));
@@ -58,18 +93,31 @@ async function initCommand(options) {
     console.log(chalk.bold.cyan('╚══════════════════════════════════════════╝\n'));
 
     console.log(chalk.bold.white('Next steps:\n'));
-    console.log(chalk.white('1. Open this project in Claude Code (or your AI coding assistant)'));
-    console.log(chalk.white('2. Run the slash command: ') + chalk.bold.green('/telos-init'));
-    console.log(chalk.white('3. AI will analyze your codebase and propose a 9-level purpose hierarchy'));
-    console.log(chalk.white('4. Review strategic layers (L9-L5) and provide refinements'));
-    console.log(chalk.white('5. AI generates .telos/TELOS.md and updates your config files\n'));
+    
+    const hasClaudeOrOpencode = platforms.includes('claude') || platforms.includes('opencode');
+    
+    if (hasClaudeOrOpencode) {
+      const primaryPlatform = platforms.includes('claude') ? 'claude' : 'opencode';
+      const cmdPrefix = primaryPlatform === 'claude' ? '/telos:' : '/telos/';
+      const platformName = primaryPlatform === 'claude' ? 'Claude Code' : 'Opencode';
+      
+      console.log(chalk.white(`1. Open this project in ${platformName} (or your chosen AI assistant)`));
+      console.log(chalk.white('2. Run the command: ') + chalk.bold.green(`${cmdPrefix}init`));
+      console.log(chalk.white('3. AI will analyze your codebase and propose a 9-level purpose hierarchy'));
+      console.log(chalk.white('4. Review strategic layers (L9-L5) and provide refinements'));
+      console.log(chalk.white('5. AI generates .telos/TELOS.md and integrates with your config files\n'));
 
-    console.log(chalk.dim('Available commands after initialization:'));
-    console.log(chalk.dim('  /telos-init     - Initialize Telos with interactive review'));
-    console.log(chalk.dim('  /telos-quick    - Quick initialization (auto-accept AI proposals)'));
-    console.log(chalk.dim('  /telos-validate - Check code alignment with purpose'));
-    console.log(chalk.dim('  /telos-status   - Show current Telos configuration'));
-    console.log(chalk.dim('  /telos-reset    - Clear and reinitialize\n'));
+      console.log(chalk.dim('Available commands:'));
+      console.log(chalk.dim(`  ${cmdPrefix}init     - Initialize Telos with interactive review`));
+      console.log(chalk.dim(`  ${cmdPrefix}quick    - Quick initialization (auto-accept AI proposals)`));
+      console.log(chalk.dim(`  ${cmdPrefix}validate - Check code alignment with purpose`));
+      console.log(chalk.dim(`  ${cmdPrefix}status   - Show current Telos configuration`));
+      console.log(chalk.dim(`  ${cmdPrefix}reset    - Clear and reinitialize\n`));
+    } else {
+      console.log(chalk.white('1. Open this project in your AI coding assistant'));
+      console.log(chalk.white('2. Your AI assistant will reference the updated config files'));
+      console.log(chalk.white('3. Ask your AI to run Telos initialization\n'));
+    }
 
   } catch (error) {
     console.error(chalk.red('\n✗ Installation failed:'), error.message);

package/lib/installers/memory-files.js

@@ -61,17 +61,65 @@ async function createClaudeMd(projectRoot) {
   return { created: true, updated: false, path: claudeMdPath };
 }
 
-async function setupMemoryFiles(projectRoot) {
-  const results = {
-    agents: await createAgentsMd(projectRoot),
-    claude: await createClaudeMd(projectRoot)
+async function createConfigFile(projectRoot, platform) {
+  const configFiles = {
+    'cursor': '.cursorrules',
+    'cline': '.clinerules',
+    'windsurf': '.windsurfrules',
+    'roo': '.roocode',
+    'gemini': 'GEMINI.md'
   };
   
+  const fileName = configFiles[platform];
+  if (!fileName) return null;
+  
+  const filePath = path.join(projectRoot, fileName);
+  const template = await readTemplate('CLAUDE.md');
+  
+  if (await fileExists(filePath)) {
+    const existingContent = await fs.readFile(filePath, 'utf-8');
+    
+    if (existingContent.includes('Telos Framework')) {
+      return { created: false, updated: false, path: filePath, reason: 'already-exists' };
+    }
+    
+    const updatedContent = template + '\n\n' + existingContent;
+    await fs.writeFile(filePath, updatedContent);
+    
+    return { created: false, updated: true, path: filePath };
+  }
+  
+  await fs.writeFile(filePath, template);
+  return { created: true, updated: false, path: filePath };
+}
+
+async function setupMemoryFiles(projectRoot, platforms = []) {
+  const results = {};
+  
+  const platformsArray = Array.isArray(platforms) ? platforms : [platforms];
+  
+  if (platformsArray.includes('other') || platformsArray.length === 0 || !platformsArray.some(p => ['claude', 'opencode', 'cursor', 'cline', 'windsurf', 'roo', 'gemini'].includes(p))) {
+    results.agents = await createAgentsMd(projectRoot);
+  }
+  
+  for (const platform of platformsArray) {
+    if (platform === 'claude') {
+      results.claude = await createClaudeMd(projectRoot);
+    } else if (platform === 'cursor' || platform === 'cline' || platform === 'windsurf' || platform === 'roo' || platform === 'gemini') {
+      results[platform] = await createConfigFile(projectRoot, platform);
+    } else if (platform === 'other') {
+      if (!results.agents) {
+        results.agents = await createAgentsMd(projectRoot);
+      }
+    }
+  }
+  
   return results;
 }
 
 module.exports = {
   createAgentsMd,
   createClaudeMd,
+  createConfigFile,
   setupMemoryFiles
 };

package/lib/installers/slash-commands.js

@@ -1,24 +1,5 @@
 const fs = require('fs').promises;
 const path = require('path');
-const chalk = require('chalk');
-
-async function detectPlatform(projectRoot) {
-  const claudeDir = path.join(projectRoot, '.claude');
-  const opencodeDir = path.join(projectRoot, '.opencode');
-  
-  const hasClaudeDir = await fs.access(claudeDir).then(() => true).catch(() => false);
-  const hasOpencodeDir = await fs.access(opencodeDir).then(() => true).catch(() => false);
-  
-  const platforms = [];
-  if (hasClaudeDir) platforms.push('claude');
-  if (hasOpencodeDir) platforms.push('opencode');
-  
-  if (platforms.length === 0) {
-    platforms.push('claude');
-  }
-  
-  return platforms;
-}
 
 async function ensureDirectories(projectRoot, platform) {
   const commandsDir = platform === 'claude' 
@@ -29,6 +10,24 @@ async function ensureDirectories(projectRoot, platform) {
   return commandsDir;
 }
 
+async function addFrontmatterToContent(content, filename) {
+  const descriptions = {
+    'init.md': 'Initialize Telos multi-agent system for this project',
+    'quick.md': 'Quick Telos initialization with auto-accepted AI proposals',
+    'validate.md': 'Validate current code against Telos purpose hierarchy',
+    'status.md': 'Show current Telos configuration and hierarchy',
+    'reset.md': 'Clear existing Telos installation and reinitialize'
+  };
+  
+  const description = descriptions[filename] || 'Telos command';
+  
+  if (content.startsWith('---')) {
+    return content;
+  }
+  
+  return `---\ndescription: ${description}\n---\n\n${content}`;
+}
+
 async function copyCommandFiles(projectRoot, platform) {
   const sourceDir = path.join(__dirname, '../../.claude/commands/telos');
   const targetDir = await ensureDirectories(projectRoot, platform);
@@ -47,7 +46,13 @@ async function copyCommandFiles(projectRoot, platform) {
     const targetPath = path.join(targetDir, file);
     
     try {
-      await fs.copyFile(sourcePath, targetPath);
+      let content = await fs.readFile(sourcePath, 'utf-8');
+      
+      if (platform === 'opencode') {
+        content = await addFrontmatterToContent(content, file);
+      }
+      
+      await fs.writeFile(targetPath, content);
       results.push({ file, success: true, path: targetPath });
     } catch (error) {
       results.push({ file, success: false, error: error.message });
@@ -57,11 +62,13 @@ async function copyCommandFiles(projectRoot, platform) {
   return results;
 }
 
-async function installSlashCommands(projectRoot) {
-  const platforms = await detectPlatform(projectRoot);
+async function installSlashCommands(projectRoot, selectedPlatforms = ['claude']) {
+  const platforms = Array.isArray(selectedPlatforms) ? selectedPlatforms : [selectedPlatforms];
+  
+  const commandPlatforms = platforms.filter(p => p === 'claude' || p === 'opencode');
   
   const allResults = [];
-  for (const platform of platforms) {
+  for (const platform of commandPlatforms) {
     const results = await copyCommandFiles(projectRoot, platform);
     allResults.push({ platform, results });
   }
@@ -70,7 +77,6 @@ async function installSlashCommands(projectRoot) {
 }
 
 module.exports = {
-  detectPlatform,
   ensureDirectories,
   copyCommandFiles,
   installSlashCommands

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "telos-framework",
-  "version": "0.3.2",
+  "version": "0.4.0",
   "description": "Telos-driven Multi-Agent Development Framework - A philosophically-grounded AI collective for purpose-aligned software development",
   "main": "index.js",
   "bin": {