@zweer/dev 1.2.0 → 1.3.0

package/README.md

@@ -19,6 +19,7 @@ Central repository of reusable configurations and specialized AI agents for soft
 - [Benefits of This Approach](#benefits-of-this-approach)
 - [Contributing](#contributing)
 - [Roadmap](#roadmap)
+- [CI/CD](#cicd)
 - [License](#license)
 
 ## Project Purpose
@@ -278,29 +279,9 @@ Adds configurations to existing project:
 
 All CAO-related commands are under the `cao` subcommand:
 
-##### `dev cao init [name]`
-
-Create an orchestrator in your current project.
-
-```bash
-# Interactive mode
-dev cao init
-
-# With custom name
-dev cao init my_orchestrator
-
-# Skip prompts (use defaults)
-dev cao init --yes
-```
-
-Creates `.cao/agents/<name>.md` with a template orchestrator configured for your project.
-
-**Options:**
-- `-y, --yes` - Skip prompts and use defaults
-
 ##### `dev cao install`
 
-Install CAO (CLI Agent Orchestrator) and all common agents.
+Install CAO (CLI Agent Orchestrator) and all global agents.
 
 ```bash
 # Install everything
@@ -317,12 +298,88 @@ This command:
 1. Installs tmux configuration
 2. Installs `uv` package manager
 3. Installs CAO via `uv tool install`
-4. Installs all 30+ common agents from this repository
+4. Installs all 30+ global agents (zweer_*) from this repository
 
 **Options:**
 - `--cao-only` - Install only CAO prerequisites
 - `--agents-only` - Install only agents (skip CAO)
 
+##### `dev cao agent create [name]`
+
+Create a new local agent in your project.
+
+```bash
+# Interactive mode
+dev cao agent create
+
+# With custom name
+dev cao agent create my_orchestrator
+
+# Web app orchestrator (default)
+dev cao agent create --template orchestrator_webapp
+
+# Mobile app orchestrator
+dev cao agent create --template orchestrator_mobile
+
+# Serverless Lambda orchestrator
+dev cao agent create --template orchestrator_lambda
+
+# Microservices orchestrator
+dev cao agent create --template orchestrator_microservices
+
+# Writing project orchestrator
+dev cao agent create --template orchestrator_writing
+
+# Skip prompts (use defaults)
+dev cao agent create my_agent --yes
+```
+
+Creates `.cao/agents/<name>.md` with a template agent configured for your project.
+
+**Available Templates:**
+- `orchestrator_webapp` - Web application (Next.js, React, etc.) - **default**
+- `orchestrator_mobile` - Mobile app (React Native, Flutter, iOS, Android)
+- `orchestrator_lambda` - Serverless with AWS Lambda
+- `orchestrator_microservices` - Microservices architecture
+- `orchestrator_writing` - Content creation and writing projects
+
+**Options:**
+- `-t, --template <template>` - Template to use
+- `-y, --yes` - Skip prompts and use defaults
+
+##### `dev cao agent list`
+
+List all local agents in `.cao/agents/`.
+
+```bash
+dev cao agent list
+```
+
+##### `dev cao agent remove <name>`
+
+Remove a local agent.
+
+```bash
+# With confirmation prompt
+dev cao agent remove my_agent
+
+# Skip confirmation
+dev cao agent remove my_agent --yes
+```
+
+**Options:**
+- `-y, --yes` - Skip confirmation
+
+##### `dev cao sync`
+
+Sync (install/update) all local agents from `.cao/agents/`.
+
+```bash
+dev cao sync
+```
+
+Run this after creating or modifying local agents to install/update them in CAO.
+
 ##### `dev cao server`
 
 Launch the CAO server.
@@ -350,10 +407,42 @@ dev cao launch zweer_web_frontend
 List all available agents with descriptions.
 
 ```bash
+# List all agents with installation status
 dev cao list
+
+# List only installed agents
+dev cao list --installed
 ```
 
-Shows all 30+ agents organized by category.
+Shows all 30+ agents organized by category with installation status indicators:
+- ✓ = Installed
+- ○ = Not installed
+
+**Options:**
+- `--installed` - Show only installed agents
+
+##### `dev cao status`
+
+Show installation status summary.
+
+```bash
+dev cao status
+```
+
+Displays:
+- Number of installed agents
+- Number of not installed agents
+- List of agents that are not installed
+
+##### `dev cao uninstall <agent>`
+
+Uninstall a specific agent.
+
+```bash
+dev cao uninstall zweer_web_frontend
+```
+
+Removes the agent from CAO's agent directory (`~/.aws/cli-agent-orchestrator/agent-context/`).
 
 ## How to Use Agents
 
@@ -363,20 +452,39 @@ Shows all 30+ agents organized by category.
 # In your project directory
 cd my-project
 
-# Create orchestrator
-dev cao init
-
-# Install CAO and agents
+# Install CAO and global agents (zweer_*)
 dev cao install
+
+# Create orchestrator based on your project type
+
+# For web app (default)
+dev cao agent create
+
+# For mobile app
+dev cao agent create --template orchestrator_mobile
+
+# For serverless Lambda
+dev cao agent create --template orchestrator_lambda
+
+# For microservices
+dev cao agent create --template orchestrator_microservices
+
+# For writing project
+dev cao agent create --template orchestrator_writing
+
+# Sync all local agents
+dev cao sync
 ```
 
-### Customize Orchestrator
+### Customize Agents
 
-Edit `.cao/agents/my-project_orchestrator.md` to add:
+Edit agents in `.cao/agents/` to add:
 - Project-specific context
 - Tech stack details
 - Architecture notes
-- Custom agent selection logic
+- Custom logic and tools
+
+After editing, run `dev cao sync` to update them in CAO.
 
 ### Launch and Work
 
@@ -385,7 +493,23 @@ Edit `.cao/agents/my-project_orchestrator.md` to add:
 dev cao server
 
 # Launch your orchestrator (in another terminal)
-dev cao launch my-project_orchestrator
+dev cao launch my_orchestrator
+
+# Or launch a specialized agent
+dev cao launch db_specialist
+```
+
+### Managing Local Agents
+
+```bash
+# List all local agents
+dev cao agent list
+
+# Remove an agent
+dev cao agent remove old_agent
+
+# Sync after modifications
+dev cao sync
 ```
 
 ### Use Agent Handoff
@@ -499,9 +623,213 @@ To add new agents:
   - [x] Android native
 - [x] Data engineering agents (`agents/data/`)
 - [x] Writing agents (`agents/writing/`)
-- [ ] Common configurations (`configs/`)
-- [ ] Project templates (`templates/`)
-- [ ] Orchestrator examples
+- [x] Common configurations
+  - [x] TypeScript, Biome, Vitest configs
+  - [x] `dev bootstrap` command
+  - [x] `dev setup` command
+- [x] Project templates (`templates/`)
+  - [x] Web app orchestrator
+  - [x] Mobile app orchestrator
+  - [x] Serverless Lambda orchestrator
+  - [x] Microservices orchestrator
+  - [x] Writing project orchestrator
+- [x] CLI tool for agent management
+  - [x] Install/uninstall agents
+  - [x] List agents with status
+  - [x] Create orchestrators from templates
+  - [x] Sync local agents
+
+## CI/CD
+
+This project uses GitHub Actions for continuous integration and deployment. All workflows are **reusable** and can be used in other projects.
+
+### Available Workflows
+
+- `ci.yml` - Test, build, and lint (reusable base workflow)
+- `pr.yml` - Pull request checks (includes CI + validation)
+- `npm.yml` - Release and publish to npm
+- `security.yml` - Security audit
+- `dependabot-auto-merge.yml` - Auto-merge Dependabot PRs
+
+### How to Use in Other Projects
+
+#### Option 1: Call Workflows from This Repository
+
+Create workflows in your project that call these reusable workflows:
+
+**`.github/workflows/pr.yml`** in your project:
+```yaml
+name: PR
+
+on:
+  pull_request:
+
+permissions:
+  contents: read
+  pull-requests: write
+
+jobs:
+  pr:
+    uses: zweer/dev/.github/workflows/pr.yml@main
+```
+
+**`.github/workflows/release.yml`** in your project:
+```yaml
+name: Release
+
+on:
+  push:
+    branches:
+      - main
+
+permissions:
+  contents: write
+  issues: write
+  pull-requests: write
+  id-token: write
+
+jobs:
+  release:
+    uses: zweer/dev/.github/workflows/npm.yml@main
+    secrets:
+      NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+```
+
+**`.github/workflows/security.yml`** in your project:
+```yaml
+name: Security
+
+on:
+  schedule:
+    - cron: '0 9 * * 1'
+  workflow_dispatch:
+
+permissions:
+  contents: read
+
+jobs:
+  audit:
+    uses: zweer/dev/.github/workflows/security.yml@main
+```
+
+#### Option 2: Copy Workflows to Your Project
+
+If you prefer to have full control, copy the workflow files to your project's `.github/workflows/` directory.
+
+**Note**: If you copy `pr.yml` or `npm.yml`, you'll also need to copy `ci.yml` since they depend on it.
+
+### Workflow Dependencies
+
+```
+pr.yml
+  └── ci.yml (required)
+
+npm.yml
+  └── ci.yml (required)
+
+security.yml (standalone)
+
+dependabot-auto-merge.yml (standalone)
+```
+
+### Customization
+
+**Using a Specific Version**
+
+Instead of `@main`, you can pin to a specific version:
+
+```yaml
+uses: zweer/dev/.github/workflows/pr.yml@v1.2.0
+```
+
+**Overriding CI Workflow**
+
+If you need custom CI steps:
+
+1. Copy `ci.yml` to your project
+2. Modify it as needed
+3. Update `pr.yml` and `npm.yml` to use your local `ci.yml`:
+
+```yaml
+jobs:
+  ci:
+    uses: ./.github/workflows/ci.yml  # Use local version
+```
+
+### Complete Setup Example
+
+For a typical npm package, create these files in your project:
+
+**`.github/workflows/pr.yml`**:
+```yaml
+name: PR
+on:
+  pull_request:
+permissions:
+  contents: read
+  pull-requests: write
+jobs:
+  pr:
+    uses: zweer/dev/.github/workflows/pr.yml@main
+```
+
+**`.github/workflows/release.yml`**:
+```yaml
+name: Release
+on:
+  push:
+    branches: [main]
+permissions:
+  contents: write
+  issues: write
+  pull-requests: write
+  id-token: write
+jobs:
+  release:
+    uses: zweer/dev/.github/workflows/npm.yml@main
+    secrets:
+      NPM_TOKEN: ${{ secrets.NPM_TOKEN }}
+```
+
+**`.github/dependabot.yml`**:
+```yaml
+version: 2
+updates:
+  - package-ecosystem: npm
+    directory: /
+    schedule:
+      interval: weekly
+```
+
+That's it! Your project now has:
+- ✅ Automated testing on PRs
+- ✅ Automated releases with semantic-release
+- ✅ Automated dependency updates
+- ✅ PR title validation
+
+### Dependabot
+
+Automated dependency updates configured in `.github/dependabot.yml`:
+- **npm dependencies**: Weekly updates on Mondays
+- **GitHub Actions**: Weekly updates on Mondays
+- Groups patch/minor updates together
+- Separate groups for dev and production dependencies
+
+### Required Secrets
+
+For the workflows to function properly, configure these secrets in your GitHub repository:
+
+- `NPM_TOKEN` - npm authentication token for publishing packages
+
+### Branch Protection
+
+Recommended branch protection rules for `main`:
+
+- Require pull request reviews before merging
+- Require status checks to pass (Test & Lint from CI workflow)
+- Require branches to be up to date before merging
+- Require conversation resolution before merging
+- Do not allow bypassing the above settings
 
 ## License
 

package/cli/commands/cao/agent/create.d.ts

@@ -3,8 +3,16 @@ export interface AgentConfig {
     name: string;
     projectName: string;
     projectPath: string;
-    techStack: string;
-    projectStructure: string;
+    techStack?: string;
+    projectStructure?: string;
+    platform?: string;
+    targetPlatforms?: string;
+    iacTool?: string;
+    runtime?: string;
+    serviceMesh?: string;
+    contentType?: string;
+    audience?: string;
+    tone?: string;
     template: string;
 }
 export declare function createAgent(config: AgentConfig): Promise<{

package/cli/commands/cao/agent/create.js

@@ -8,12 +8,33 @@ export async function createAgent(config) {
     // Read template
     const templatePath = join(paths.templates, `${config.template}.md`);
     let template = await readFile(templatePath, 'utf-8');
-    // Replace placeholders
+    // Replace common placeholders
     template = template
         .replace(/\{\{PROJECT_NAME\}\}/g, config.projectName)
-        .replace(/\{\{PROJECT_PATH\}\}/g, config.projectPath)
-        .replace(/\{\{TECH_STACK\}\}/g, config.techStack)
-        .replace(/\{\{PROJECT_STRUCTURE\}\}/g, config.projectStructure);
+        .replace(/\{\{PROJECT_PATH\}\}/g, config.projectPath);
+    // Replace template-specific placeholders
+    if (config.techStack)
+        template = template.replace(/\{\{TECH_STACK\}\}/g, config.techStack);
+    if (config.projectStructure)
+        template = template.replace(/\{\{PROJECT_STRUCTURE\}\}/g, config.projectStructure);
+    if (config.platform)
+        template = template.replace(/\{\{PLATFORM\}\}/g, config.platform);
+    if (config.targetPlatforms)
+        template = template.replace(/\{\{TARGET_PLATFORMS\}\}/g, config.targetPlatforms);
+    if (config.iacTool)
+        template = template.replace(/\{\{IAC_TOOL\}\}/g, config.iacTool);
+    if (config.runtime)
+        template = template.replace(/\{\{RUNTIME\}\}/g, config.runtime);
+    if (config.serviceMesh)
+        template = template.replace(/\{\{SERVICE_MESH\}\}/g, config.serviceMesh);
+    if (config.contentType)
+        template = template.replace(/\{\{CONTENT_TYPE\}\}/g, config.contentType);
+    if (config.audience)
+        template = template.replace(/\{\{AUDIENCE\}\}/g, config.audience);
+    if (config.tone)
+        template = template.replace(/\{\{TONE\}\}/g, config.tone);
+    // Replace any remaining placeholders with empty string
+    template = template.replace(/\{\{[A-Z_]+\}\}/g, '');
     // Create .cao/agents directory
     const caoDir = join(config.projectPath, '.cao', 'agents');
     await mkdir(caoDir, { recursive: true });
@@ -24,26 +45,59 @@ export async function createAgent(config) {
 }
 export function getDefaultConfig(cwd, name, template) {
     const projectName = basename(cwd);
-    return {
+    const baseConfig = {
         name: name || `${projectName}_orchestrator`,
         projectName,
         projectPath: cwd,
-        techStack: 'Next.js, TypeScript, PostgreSQL',
-        projectStructure: 'app/, components/, lib/',
-        template: template || 'orchestrator',
+        template: template || 'orchestrator_webapp',
     };
+    // Template-specific defaults
+    switch (template) {
+        case 'orchestrator_mobile':
+            return {
+                ...baseConfig,
+                platform: 'React Native',
+                targetPlatforms: 'iOS, Android',
+            };
+        case 'orchestrator_lambda':
+            return {
+                ...baseConfig,
+                iacTool: 'AWS CDK',
+                runtime: 'Node.js 20',
+            };
+        case 'orchestrator_microservices':
+            return {
+                ...baseConfig,
+                platform: 'EKS',
+                serviceMesh: 'None',
+            };
+        case 'orchestrator_writing':
+            return {
+                ...baseConfig,
+                contentType: 'Blog',
+                audience: 'Developers',
+                tone: 'Professional',
+            };
+        default:
+            return {
+                ...baseConfig,
+                techStack: 'Next.js, TypeScript, PostgreSQL',
+                projectStructure: 'app/, components/, lib/',
+            };
+    }
 }
 export const createCommand = new Command()
     .name('create')
     .description('Create a new agent in current project')
     .argument('[name]', 'Agent name')
-    .option('-t, --template <template>', 'Template to use (orchestrator, specialist)', 'orchestrator')
+    .option('-t, --template <template>', 'Template to use (orchestrator_webapp, orchestrator_mobile, orchestrator_lambda, orchestrator_microservices, orchestrator_writing)', 'orchestrator_webapp')
     .option('-y, --yes', 'Skip prompts and use defaults')
     .action(async (name, options) => {
     const cwd = process.cwd();
     let config = getDefaultConfig(cwd, name, options.template);
     if (!options.yes) {
-        const answers = await inquirer.prompt([
+        // Common prompts
+        const commonAnswers = await inquirer.prompt([
             {
                 type: 'input',
                 name: 'name',
@@ -56,20 +110,98 @@ export const createCommand = new Command()
                 message: 'Project name:',
                 default: config.projectName,
             },
-            {
-                type: 'input',
-                name: 'techStack',
-                message: 'Tech stack:',
-                default: config.techStack,
-            },
-            {
-                type: 'input',
-                name: 'projectStructure',
-                message: 'Main folders:',
-                default: config.projectStructure,
-            },
         ]);
-        config = { ...config, ...answers };
+        config = { ...config, ...commonAnswers };
+        // Template-specific prompts
+        let specificAnswers = {};
+        switch (options.template) {
+            case 'orchestrator_mobile':
+                specificAnswers = await inquirer.prompt([
+                    {
+                        type: 'input',
+                        name: 'platform',
+                        message: 'Mobile platform:',
+                        default: config.platform,
+                    },
+                    {
+                        type: 'input',
+                        name: 'targetPlatforms',
+                        message: 'Target platforms:',
+                        default: config.targetPlatforms,
+                    },
+                ]);
+                break;
+            case 'orchestrator_lambda':
+                specificAnswers = await inquirer.prompt([
+                    {
+                        type: 'input',
+                        name: 'iacTool',
+                        message: 'IaC tool:',
+                        default: config.iacTool,
+                    },
+                    {
+                        type: 'input',
+                        name: 'runtime',
+                        message: 'Lambda runtime:',
+                        default: config.runtime,
+                    },
+                ]);
+                break;
+            case 'orchestrator_microservices':
+                specificAnswers = await inquirer.prompt([
+                    {
+                        type: 'input',
+                        name: 'platform',
+                        message: 'Container platform:',
+                        default: config.platform,
+                    },
+                    {
+                        type: 'input',
+                        name: 'serviceMesh',
+                        message: 'Service mesh:',
+                        default: config.serviceMesh,
+                    },
+                ]);
+                break;
+            case 'orchestrator_writing':
+                specificAnswers = await inquirer.prompt([
+                    {
+                        type: 'input',
+                        name: 'contentType',
+                        message: 'Content type:',
+                        default: config.contentType,
+                    },
+                    {
+                        type: 'input',
+                        name: 'audience',
+                        message: 'Target audience:',
+                        default: config.audience,
+                    },
+                    {
+                        type: 'input',
+                        name: 'tone',
+                        message: 'Tone:',
+                        default: config.tone,
+                    },
+                ]);
+                break;
+            default:
+                specificAnswers = await inquirer.prompt([
+                    {
+                        type: 'input',
+                        name: 'techStack',
+                        message: 'Tech stack:',
+                        default: config.techStack,
+                    },
+                    {
+                        type: 'input',
+                        name: 'projectStructure',
+                        message: 'Main folders:',
+                        default: config.projectStructure,
+                    },
+                ]);
+        }
+        config = { ...config, ...specificAnswers };
     }
     console.log(chalk.cyan(`\n🎯 Creating agent: ${config.name}\n`));
     try {