create-universal-ai-context 2.0.0

package/templates/base/standards/README.md

@@ -0,0 +1,66 @@
+# Standards
+
+Quality standards, guidelines, and compatibility information for Claude Context Engineering.
+
+## Contents
+
+| Document | Description |
+|----------|-------------|
+| [EXTENSION_GUIDELINES.md](./EXTENSION_GUIDELINES.md) | How to create and publish extensions |
+| [QUALITY_CHECKLIST.md](./QUALITY_CHECKLIST.md) | Quality requirements and validation checklist |
+| [COMPATIBILITY.md](./COMPATIBILITY.md) | Version compatibility and migration information |
+
+## Quick Reference
+
+### For Users
+
+Use the [Quality Checklist](./QUALITY_CHECKLIST.md) to ensure your implementation meets standards:
+
+```bash
+# Run full validation
+npx claude-context validate --all
+```
+
+### For Extension Authors
+
+Follow the [Extension Guidelines](./EXTENSION_GUIDELINES.md) to create publishable extensions:
+
+1. Structure your extension correctly
+2. Include required manifest and documentation
+3. Meet quality requirements
+4. Submit for review
+
+### For Contributors
+
+Check [Compatibility](./COMPATIBILITY.md) when making changes:
+
+- Follow semantic versioning
+- Document breaking changes
+- Provide migration paths
+
+## Standards Summary
+
+### Quality Levels
+
+| Level | Requirements |
+|-------|--------------|
+| Minimal | Placeholders replaced, validation passes |
+| Standard | Complete documentation, <40% context budget |
+| Exemplary | >80% accuracy, <30% budget, CI integration |
+
+### Extension Requirements
+
+| Requirement | Status |
+|-------------|--------|
+| manifest.json | Required |
+| README.md | Required |
+| LICENSE | Required |
+| CHANGELOG.md | Recommended |
+| Tests | Recommended |
+
+### Version Compatibility
+
+- Use `^1.0.0` for extension compatibility ranges
+- Major version = breaking changes
+- Minor version = new features
+- Patch version = bug fixes

package/templates/base/sync/anchors.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "../schemas/anchors.schema.json",
+  "version": "1.0.0",
+  "generatedAt": null,
+  "anchors": {}
+}

package/templates/base/sync/hashes.json

@@ -0,0 +1,6 @@
+{
+  "$schema": "../schemas/hashes.schema.json",
+  "version": "1.0.0",
+  "generatedAt": null,
+  "files": {}
+}

package/templates/base/sync/staleness.json

@@ -0,0 +1,10 @@
+{
+  "$schema": "../schemas/staleness.schema.json",
+  "version": "1.0.0",
+  "lastFullCheck": null,
+  "workflows": {},
+  "thresholds": {
+    "warningDays": 30,
+    "staleDays": 90
+  }
+}

package/templates/base/team/README.md

@@ -0,0 +1,168 @@
+# Team Collaboration
+
+Configuration and setup for team-based Claude Code collaboration.
+
+## Overview
+
+This directory contains team configuration that enables:
+- Multi-user collaboration on Claude Code sessions
+- Role-based access control
+- Session handoffs between team members
+- Shared knowledge synchronization
+- Team notifications and integrations
+
+## Quick Setup
+
+### 1. Configure Team
+
+Edit `config.json` and replace placeholders:
+
+```json
+{
+  "team": {
+    "name": "Your Team Name",
+    "organization": "Your Organization"
+  }
+}
+```
+
+### 2. Add Team Members
+
+Add members to the `members` array in `config.json`:
+
+```json
+{
+  "members": [
+    {
+      "id": "unique-id",
+      "name": "Developer Name",
+      "role": "developer",
+      "email": "dev@example.com",
+      "permissions": ["read", "write", "execute"],
+      "active": true
+    }
+  ]
+}
+```
+
+### 3. Assign Roles
+
+Available roles (defined in `roles.json`):
+
+| Role | Description | Key Permissions |
+|------|-------------|-----------------|
+| `team-lead` | Full access, manages team | All permissions |
+| `senior-developer` | Development + approvals | read, write, execute, approve |
+| `developer` | Standard development | read, write, execute |
+| `reviewer` | Code review focus | read, approve |
+| `observer` | Read-only access | read |
+
+### 4. Configure Integrations (Optional)
+
+#### Slack Notifications
+
+```json
+{
+  "notifications": {
+    "enabled": true,
+    "channels": {
+      "slack": {
+        "webhook_url": "https://hooks.slack.com/...",
+        "channel": "#claude-notifications"
+      }
+    }
+  }
+}
+```
+
+#### Jira Integration
+
+```json
+{
+  "integrations": {
+    "jira": {
+      "enabled": true,
+      "project_key": "PROJ",
+      "api_url": "https://your-domain.atlassian.net"
+    }
+  }
+}
+```
+
+## Files
+
+| File | Purpose |
+|------|---------|
+| `config.json` | Team settings, members, integrations |
+| `roles.json` | Role definitions and permissions |
+
+## Usage
+
+### Session Handoffs
+
+When ending a session, create a handoff document:
+
+```
+/collab handoff
+```
+
+This generates a session summary in `.ai-context/knowledge/sessions/` for the next team member.
+
+### Sync Shared Knowledge
+
+Synchronize team knowledge base:
+
+```
+/collab sync
+```
+
+### Check Team Status
+
+View team configuration and active sessions:
+
+```
+/collab status
+```
+
+## Policies
+
+Configure team policies in `config.json`:
+
+```json
+{
+  "policies": {
+    "code_review_required": true,
+    "documentation_update_required": true,
+    "test_coverage_minimum": 80,
+    "max_file_changes_per_session": 50
+  }
+}
+```
+
+## Security Notes
+
+- `config.json` may contain sensitive webhooks - consider gitignoring
+- Use environment variables for API tokens
+- Review member permissions regularly
+- Session handoffs may contain context - handle appropriately
+
+## Troubleshooting
+
+### Member not recognized
+
+Ensure the member entry in `config.json` has:
+- Unique `id`
+- Valid `role` matching `roles.json`
+- `active: true`
+
+### Notifications not sending
+
+1. Verify webhook URL is correct
+2. Check `notifications.enabled` is `true`
+3. Ensure event type is enabled in `notifications.events`
+
+### Permission denied
+
+1. Check member's role in `config.json`
+2. Verify role has required permission in `roles.json`
+3. Ensure member is `active: true`

package/templates/base/team/config.json

@@ -0,0 +1,79 @@
+{
+  "$schema": "../schemas/team-config.schema.json",
+  "$comment": "Team configuration for collaborative Claude Code sessions",
+
+  "team": {
+    "name": "{{TEAM_NAME}}",
+    "organization": "{{ORGANIZATION_NAME}}",
+    "created": "{{DATE}}",
+    "version": "1.0.0"
+  },
+
+  "members": [
+    {
+      "id": "lead-1",
+      "name": "{{TEAM_LEAD_NAME}}",
+      "role": "team-lead",
+      "email": "{{TEAM_LEAD_EMAIL}}",
+      "permissions": ["all"],
+      "active": true
+    },
+    {
+      "id": "dev-1",
+      "name": "{{DEVELOPER_1_NAME}}",
+      "role": "developer",
+      "email": "{{DEVELOPER_1_EMAIL}}",
+      "permissions": ["read", "write", "execute"],
+      "active": true
+    }
+  ],
+
+  "settings": {
+    "require_handoff_on_session_end": true,
+    "auto_sync_knowledge": true,
+    "shared_context_enabled": true,
+    "session_timeout_minutes": 480,
+    "max_concurrent_sessions": 5
+  },
+
+  "notifications": {
+    "enabled": false,
+    "channels": {
+      "slack": {
+        "webhook_url": "{{SLACK_WEBHOOK_URL}}",
+        "channel": "#claude-notifications"
+      },
+      "email": {
+        "smtp_configured": false
+      }
+    },
+    "events": {
+      "session_handoff": true,
+      "knowledge_update": true,
+      "error_critical": true
+    }
+  },
+
+  "integrations": {
+    "git": {
+      "auto_attribute_commits": true,
+      "co_author_format": "Co-Authored-By: {{MEMBER_NAME}} <{{MEMBER_EMAIL}}>"
+    },
+    "jira": {
+      "enabled": false,
+      "project_key": "{{JIRA_PROJECT_KEY}}",
+      "api_url": "{{JIRA_API_URL}}"
+    },
+    "confluence": {
+      "enabled": false,
+      "space_key": "{{CONFLUENCE_SPACE_KEY}}"
+    }
+  },
+
+  "policies": {
+    "code_review_required": true,
+    "documentation_update_required": true,
+    "test_coverage_minimum": 80,
+    "max_file_changes_per_session": 50
+  }
+}

package/templates/base/team/roles.json

@@ -0,0 +1,145 @@
+{
+  "$schema": "../schemas/roles.schema.json",
+  "$comment": "Role definitions for team collaboration",
+
+  "roles": {
+    "team-lead": {
+      "displayName": "Team Lead",
+      "description": "Full access to all features, manages team settings and approvals",
+      "permissions": [
+        "read",
+        "write",
+        "execute",
+        "approve",
+        "configure",
+        "manage-members",
+        "manage-knowledge",
+        "manage-sessions"
+      ],
+      "capabilities": {
+        "can_approve_plans": true,
+        "can_modify_team_config": true,
+        "can_add_members": true,
+        "can_remove_members": true,
+        "can_access_all_sessions": true,
+        "can_override_policies": true
+      },
+      "context_access": {
+        "shared_knowledge": "full",
+        "session_history": "all",
+        "sensitive_configs": true
+      }
+    },
+
+    "senior-developer": {
+      "displayName": "Senior Developer",
+      "description": "Full development access with plan approval capabilities",
+      "permissions": [
+        "read",
+        "write",
+        "execute",
+        "approve"
+      ],
+      "capabilities": {
+        "can_approve_plans": true,
+        "can_modify_team_config": false,
+        "can_add_members": false,
+        "can_remove_members": false,
+        "can_access_all_sessions": true,
+        "can_override_policies": false
+      },
+      "context_access": {
+        "shared_knowledge": "full",
+        "session_history": "team",
+        "sensitive_configs": false
+      }
+    },
+
+    "developer": {
+      "displayName": "Developer",
+      "description": "Standard development access for implementing features and fixes",
+      "permissions": [
+        "read",
+        "write",
+        "execute"
+      ],
+      "capabilities": {
+        "can_approve_plans": false,
+        "can_modify_team_config": false,
+        "can_add_members": false,
+        "can_remove_members": false,
+        "can_access_all_sessions": false,
+        "can_override_policies": false
+      },
+      "context_access": {
+        "shared_knowledge": "full",
+        "session_history": "own",
+        "sensitive_configs": false
+      }
+    },
+
+    "reviewer": {
+      "displayName": "Code Reviewer",
+      "description": "Read access with approval capabilities for code review",
+      "permissions": [
+        "read",
+        "approve"
+      ],
+      "capabilities": {
+        "can_approve_plans": true,
+        "can_modify_team_config": false,
+        "can_add_members": false,
+        "can_remove_members": false,
+        "can_access_all_sessions": true,
+        "can_override_policies": false
+      },
+      "context_access": {
+        "shared_knowledge": "read-only",
+        "session_history": "team",
+        "sensitive_configs": false
+      }
+    },
+
+    "observer": {
+      "displayName": "Observer",
+      "description": "Read-only access for monitoring and learning",
+      "permissions": [
+        "read"
+      ],
+      "capabilities": {
+        "can_approve_plans": false,
+        "can_modify_team_config": false,
+        "can_add_members": false,
+        "can_remove_members": false,
+        "can_access_all_sessions": false,
+        "can_override_policies": false
+      },
+      "context_access": {
+        "shared_knowledge": "read-only",
+        "session_history": "none",
+        "sensitive_configs": false
+      }
+    }
+  },
+
+  "permission_definitions": {
+    "read": "View files, documentation, and session history",
+    "write": "Create and modify files, documentation",
+    "execute": "Run commands, scripts, and Claude Code operations",
+    "approve": "Approve plans, pull requests, and changes",
+    "configure": "Modify project and team configuration",
+    "manage-members": "Add, remove, and modify team members",
+    "manage-knowledge": "Create, edit, and delete shared knowledge",
+    "manage-sessions": "Access and manage all team sessions"
+  },
+
+  "default_role": "developer",
+
+  "role_hierarchy": [
+    "team-lead",
+    "senior-developer",
+    "developer",
+    "reviewer",
+    "observer"
+  ]
+}

package/templates/base/tools/bin/claude-context.js

@@ -0,0 +1,151 @@
+#!/usr/bin/env node
+
+/**
+ * Claude Context Engineering CLI
+ *
+ * Main entry point for the claude-context command line tool.
+ * Provides commands for initialization, validation, and management
+ * of the Claude context engineering system.
+ */
+
+const { program } = require('commander');
+const chalk = require('chalk');
+const path = require('path');
+const fs = require('fs');
+
+// Import command handlers
+const { init } = require('../lib/init');
+const { validate } = require('../lib/validate');
+const { diagnose } = require('../lib/diagnose');
+const { configLoader } = require('../lib/config-loader');
+
+// Package info
+const pkg = require('../package.json');
+
+// ASCII banner
+const banner = `
+${chalk.cyan('╔═══════════════════════════════════════════════════════════╗')}
+${chalk.cyan('║')}  ${chalk.bold.white('Claude Context Engineering')}                              ${chalk.cyan('║')}
+${chalk.cyan('║')}  ${chalk.gray('Optimize AI-assisted development with pre-computed')}        ${chalk.cyan('║')}
+${chalk.cyan('║')}  ${chalk.gray('system knowledge and structured documentation.')}             ${chalk.cyan('║')}
+${chalk.cyan('╚═══════════════════════════════════════════════════════════╝')}
+`;
+
+program
+  .name('claude-context')
+  .description('CLI tools for Claude Context Engineering')
+  .version(pkg.version)
+  .hook('preAction', () => {
+    // Show banner on all commands
+    if (process.argv.includes('--no-banner')) return;
+    console.log(banner);
+  });
+
+// Init command
+program
+  .command('init')
+  .description('Initialize context engineering for a repository')
+  .option('-c, --config <path>', 'Path to configuration file')
+  .option('-i, --interactive', 'Run in interactive mode', true)
+  .option('--no-interactive', 'Run in non-interactive mode')
+  .option('--resume', 'Resume interrupted initialization')
+  .option('--validate-only', 'Only validate existing initialization')
+  .option('--tech-stack <stack>', 'Specify tech stack (e.g., "python-fastapi")')
+  .option('--project-name <name>', 'Specify project name')
+  .action(async (options) => {
+    try {
+      await init(options);
+    } catch (error) {
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Validate command
+program
+  .command('validate')
+  .description('Validate the context engineering setup')
+  .option('-a, --all', 'Run all validations', false)
+  .option('--links', 'Validate markdown links')
+  .option('--lines', 'Check line number accuracy')
+  .option('--placeholders', 'Check for remaining placeholders')
+  .option('--schema', 'Validate JSON files against schemas')
+  .option('--structure', 'Validate directory structure')
+  .option('-t, --threshold <percent>', 'Minimum accuracy threshold', '60')
+  .option('-o, --output <format>', 'Output format: console, json, markdown', 'console')
+  .option('-f, --file <path>', 'Validate specific file')
+  .action(async (options) => {
+    try {
+      // If no specific option, run all
+      if (!options.links && !options.lines && !options.placeholders &&
+          !options.schema && !options.structure && !options.file) {
+        options.all = true;
+      }
+      await validate(options);
+    } catch (error) {
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Diagnose command
+program
+  .command('diagnose')
+  .description('Diagnose issues with the context engineering setup')
+  .option('--fix', 'Attempt to fix detected issues')
+  .option('-v, --verbose', 'Show detailed diagnostics')
+  .action(async (options) => {
+    try {
+      await diagnose(options);
+    } catch (error) {
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Config command
+program
+  .command('config')
+  .description('Manage configuration')
+  .argument('[action]', 'Action: get, set, list, path')
+  .argument('[key]', 'Configuration key')
+  .argument('[value]', 'Configuration value (for set)')
+  .option('-e, --env <environment>', 'Environment (development, staging, production)')
+  .action(async (action, key, value, options) => {
+    try {
+      const config = await configLoader.load({ env: options.env });
+
+      switch (action) {
+        case 'get':
+          if (!key) {
+            console.log(JSON.stringify(config, null, 2));
+          } else {
+            const val = key.split('.').reduce((o, k) => o?.[k], config);
+            console.log(val !== undefined ? JSON.stringify(val, null, 2) : 'Key not found');
+          }
+          break;
+        case 'list':
+          console.log(JSON.stringify(config, null, 2));
+          break;
+        case 'path':
+          console.log(configLoader.getConfigPath());
+          break;
+        case 'set':
+          console.log(chalk.yellow('Config set not yet implemented. Edit files directly.'));
+          break;
+        default:
+          console.log(JSON.stringify(config, null, 2));
+      }
+    } catch (error) {
+      console.error(chalk.red('Error:'), error.message);
+      process.exit(1);
+    }
+  });
+
+// Parse and execute
+program.parse();
+
+// Show help if no command
+if (!process.argv.slice(2).length) {
+  program.outputHelp();
+}