@deimoscloud/coreai 0.1.18 → 0.1.20

package/README.md

@@ -4,8 +4,8 @@ A configurable, team-ready AI agent orchestration platform for Claude Code.
 
 ## Features
 
-- **YAML-based agent definitions** - Define agents in structured YAML, compile to Claude-compatible markdown
-- **Variable resolution** - Use `${config.*}`, `${agent.*}`, and `${remote.*}` variables in definitions
+- **Markdown-based agent definitions** - Define agents in rich Markdown templates with YAML frontmatter
+- **Variable resolution** - Use `${config.*}`, `${agent.*}`, and `${remote.*}` variables in templates
 - **Core + custom agents** - Built-in agent library with support for project-specific customizations
 - **Team filtering** - Configure which agents are available per project
 - **Override system** - Customize core agents without modifying the source
@@ -197,32 +197,38 @@ Create a `coreai.config.yaml` in your project root:
 ```yaml
 project:
   name: "My Project"
-  description: "Project description"
+  description: "Brief description of your project"
 
+# Default: [engineering-manager]
+# Add agents with: coreai agents add <name>
 team:
   agents:
+    - engineering-manager
     - backend-engineer
     - frontend-engineer
-    - devops-engineer
 
 integrations:
-  github:
-    repo: "owner/repo"
-  jira:
-    project: "PROJ"
+  git:
+    provider: github
+    config:
+      owner: "your-org"
+      repo: "your-repo"
+      default_branch: main
+  issue_tracker:
+    provider: jira
+    config:
+      project_key: "PROJ"
+      base_url: "https://your-org.atlassian.net"
 
 quality_gates:
-  lint: "npm run lint"
-  test: "npm test"
-  build: "npm run build"
-
-tech_stack:
-  languages:
-    - TypeScript
-    - Node.js
-  frameworks:
-    - Express
-    - React
+  lint:
+    command: npm run lint
+    required: true
+  test:
+    command: npm test
+    required: true
+  build:
+    command: npm run build
 ```
 
 ## Built-in Agents
@@ -249,71 +255,70 @@ CoreAI includes these core agents:
 
 ## Custom Agents
 
-Create custom agents in `coreai/agents/` directory:
+Create custom agents as Markdown files in `coreai/agents/` directory:
 
-```yaml
-# coreai/agents/mobile-engineer.yaml
-role: mobile-engineer
-type: ic-engineer
-display_name: "Mobile Engineer"
-description: "React Native mobile development specialist"
-
-responsibilities:
-  - Implement mobile features
-  - Ensure cross-platform compatibility
-  - Optimize mobile performance
-
-expertise:
-  primary:
-    - React Native
-    - iOS development
-    - Android development
-
-behaviors:
-  workflow: implementation
-  quality_gates:
-    - lint
-    - test
-    - build
+```markdown
+---
+name: mobile-engineer
+description: React Native mobile development specialist
+tools: Read, Write, Edit, Bash, Glob, Grep
+---
+
+# Mobile Engineer
+
+## Role
+
+React Native mobile development specialist focused on cross-platform mobile apps.
+
+---
+
+## Your Responsibilities
+
+- Implement mobile features using React Native
+- Ensure cross-platform compatibility (iOS and Android)
+- Optimize mobile performance and user experience
 ```
 
 ### Overriding Core Agents
 
 To customize a core agent, create a file with the same name in `coreai/agents/`:
 
-```yaml
-# coreai/agents/backend-engineer.yaml
-# This overrides the core backend-engineer agent
+```markdown
+---
+name: backend-engineer
+description: Custom backend engineer for our Python stack
+tools: Read, Write, Edit, Bash, Glob, Grep
+---
 
-role: backend-engineer
-type: ic-engineer
-display_name: "Backend Engineer"
-description: "Custom backend engineer for our Python stack"
+# Backend Engineer
 
-# ... rest of definition
+## Role
+
+Custom backend engineer specializing in our Python/FastAPI stack.
+
+<!-- Your custom agent content here -->
 ```
 
 ## Variable Resolution
 
-Agent definitions support three variable namespaces:
+Agent templates support three variable namespaces:
 
 ### `${config.*}` - Project Configuration
 
-```yaml
-description: "Backend engineer for ${config.project.name}"
+```markdown
+Working on project: ${config.project.name}
 ```
 
 ### `${agent.*}` - Agent Self-Reference
 
-```yaml
-description: "I am ${agent.display_name}, responsible for ${agent.role}"
+```markdown
+You are the ${agent.name}, responsible for ${agent.role}
 ```
 
 ### `${remote.*}` - Remote Content
 
-```yaml
-context:
-  - "${remote.confluence.architecture-docs}"
+```markdown
+Reference the architecture documentation: ${remote.documentation}
 ```
 
 ## Skills (Claude Slash Commands)
@@ -468,7 +473,7 @@ your-project/
 ├── coreai.config.yaml          # Project configuration
 ├── coreai/
 │   ├── agents/                 # Custom agent definitions
-│   │   └── my-agent.yaml
+│   │   └── my-agent.md
 │   └── skills/                 # Custom skill templates
 │       └── my-skill.md
 ├── .claude/
@@ -537,9 +542,9 @@ See [IMPLEMENTATION_PLAN.md](IMPLEMENTATION_PLAN.md) for detailed implementation
 ### Phase 1 (Complete)
 
 - Project foundation (TypeScript, CLI, configuration)
-- Agent YAML schema and validation
+- Agent schema and validation
 - Variable resolution system
-- Agent compiler (YAML to Markdown)
+- Agent compiler (Markdown templates to Claude-compatible output)
 - Agent CLI commands (build, list, show)
 - Integration adapter framework
 - MCP integration layer with server discovery

package/agents/_templates/ic-engineer.md

@@ -12,14 +12,6 @@ tools: Read, Write, Edit, Bash, Glob, Grep, mcp__github, mcp__atlassian
 
 ---
 
-## Technical Stack
-
-- [Technology 1]
-- [Technology 2]
-- [Technology 3]
-
----
-
 ## Knowledge Library Structure
 
 You have access to shared and personal knowledge files:

package/agents/android-engineer.md

@@ -10,9 +10,6 @@ tech_artifacts: "[API specs, Gradle configs, architecture diagrams]"
 ## Role
 Design and build native Android applications using Kotlin, Jetpack Compose, and modern architecture patterns. Focus on performant, user-friendly mobile experiences with robust testing and security.
 
-## Technical Stack
-${config.tech_stack}
-
 ## Responsibilities
 - Design and implement native Android applications
 - Build responsive UIs using Jetpack Compose and XML layouts

package/agents/backend-engineer.md

@@ -10,9 +10,6 @@ tech_artifacts: "[API specs, schemas, migration scripts]"
 ## Role
 Build and maintain APIs, database schemas, and server-side infrastructure. Focus on robust, scalable, and maintainable backend systems.
 
-## Technical Stack
-${config.tech_stack}
-
 ## Responsibilities
 - Design and implement RESTful APIs and GraphQL endpoints
 - Architect database schemas and optimize queries

package/agents/database-administrator.md

@@ -10,9 +10,6 @@ tech_artifacts: "[schemas, migration scripts, query plans, ERDs]"
 ## Role
 Design, optimize, and operate database systems. Focus on ensuring data integrity, performance, availability, and security across relational and NoSQL database platforms.
 
-## Technical Stack
-${config.tech_stack}
-
 ## Responsibilities
 - Design and implement database schemas and data models
 - Optimize query performance and indexing strategies

package/agents/devops-engineer.md

@@ -10,9 +10,6 @@ tech_artifacts: "[Infrastructure configs, runbooks, deployment docs]"
 ## Role
 Design, build, and maintain CI/CD pipelines, infrastructure as code, and cloud resources. Ensure reliable deployments, system observability, and operational excellence across all environments.
 
-## Technical Stack
-${config.tech_stack}
-
 ## Responsibilities
 - Design and maintain CI/CD pipelines
 - Implement infrastructure as code (Terraform, Pulumi, CloudFormation, etc.)

package/agents/engineering-manager.md

@@ -9,9 +9,6 @@ tools: Read, Write, Edit, Bash, Glob, Grep
 ## Role
 Coordinate the engineering team, breaking down requirements into tasks, delegating to specialists, and ensuring alignment between product and engineering. You do NOT write code. You plan, delegate, track, and unblock.
 
-## Technical Stack
-${config.tech_stack}
-
 ---
 
 ## CRITICAL: FORBIDDEN ACTIONS

package/agents/frontend-engineer.md

@@ -10,9 +10,6 @@ tech_artifacts: "[Component specs, style guides, design tokens]"
 ## Role
 Build and maintain responsive, accessible web interfaces with modern JavaScript frameworks. Focus on performant, user-friendly experiences and robust component architectures.
 
-## Technical Stack
-${config.tech_stack}
-
 ## Responsibilities
 - Build responsive and accessible user interfaces
 - Implement component libraries and design systems

package/agents/product-manager.md

@@ -9,9 +9,6 @@ tools: Read, Write, Edit, Bash, Glob, Grep
 ## Role
 Define product vision, strategy, and requirements. Bridge business objectives with technical execution by prioritizing features, writing specifications, and ensuring product-market fit. You do NOT write code. You define what to build, why, and in what order.
 
-## Technical Stack
-${config.tech_stack}
-
 ## Responsibilities
 - Define product vision, strategy, and roadmap
 - Write detailed product requirements and user stories

package/agents/react-engineer.md

@@ -10,9 +10,6 @@ tech_artifacts: "[Component specs, API integration docs, design system tokens]"
 ## Role
 Design and build modern web applications using React, TypeScript, and the React ecosystem. Focus on performant, accessible, and maintainable user interfaces with robust component architectures and state management.
 
-## Technical Stack
-${config.tech_stack}
-
 ## Responsibilities
 - Design and implement React components and applications
 - Build reusable component libraries and design systems

package/agents/react-native-engineer.md

@@ -10,9 +10,6 @@ tech_artifacts: "[Native module docs, platform configs, release notes]"
 ## Role
 Design and build cross-platform mobile applications using React Native and TypeScript. Focus on performant iOS and Android experiences with a shared codebase, native module integration, and platform-specific adaptations where needed.
 
-## Technical Stack
-${config.tech_stack}
-
 ## Responsibilities
 - Design and implement cross-platform mobile applications
 - Build reusable components with platform-specific adaptations

package/agents/software-security-engineer.md

@@ -10,9 +10,6 @@ tech_artifacts: "[Threat models, security assessments, vulnerability reports, po
 ## Role
 Conduct secure code reviews, perform security assessments, and ensure software is built with security as a core principle. Review PRs for security vulnerabilities, authentication/authorization correctness, and compliance with security standards.
 
-## Technical Stack
-${config.tech_stack}
-
 ## Responsibilities
 - Conduct secure code reviews and threat modeling
 - Perform security assessments and penetration testing

package/agents/software-solutions-architect.md

@@ -9,9 +9,6 @@ tools: Read, Write, Edit, Bash, Glob, Grep
 ## Role
 Design high-level system architecture, make technology decisions, and ensure technical solutions align with business goals. Review PRs for architectural compliance and create Architecture Decision Records (ADRs). You operate across both implementation (ticket-based) and review workflows.
 
-## Technical Stack
-${config.tech_stack}
-
 ## Responsibilities
 - Design high-level system architecture and technical solutions
 - Evaluate and recommend technology stacks and frameworks

package/agents/sre-huawei-cloud-architect.md

@@ -10,9 +10,6 @@ tech_artifacts: "[architecture diagrams, runbooks, IaC configs]"
 ## Role
 Design and operate resilient, scalable infrastructure on Huawei Cloud. Focus on high availability, operational excellence, and cost-effective cloud architecture using Huawei Cloud services.
 
-## Technical Stack
-${config.tech_stack}
-
 ## Responsibilities
 - Design and implement Huawei Cloud infrastructure architecture
 - Configure and manage ECS, CCE, OBS, RDS, and other Huawei services

package/agents/sre-iac-specialist.md

@@ -10,9 +10,6 @@ tech_artifacts: "[Terraform modules, IaC templates, policy files]"
 ## Role
 Automate infrastructure provisioning and maintain reproducible environments. Focus on Infrastructure as Code solutions, GitOps workflows, and reusable infrastructure patterns across cloud platforms.
 
-## Technical Stack
-${config.tech_stack}
-
 ## Responsibilities
 - Design and implement infrastructure as code solutions
 - Develop and maintain Terraform modules and configurations

package/agents/sre-kubernetes-specialist.md

@@ -10,9 +10,6 @@ tech_artifacts: "[Helm charts, manifests, cluster configs, runbooks]"
 ## Role
 Design, deploy, and operate production-grade Kubernetes clusters. Focus on container orchestration, GitOps workflows, service mesh, and ensuring scalability, security, and operational excellence.
 
-## Technical Stack
-${config.tech_stack}
-
 ## Responsibilities
 - Design and manage Kubernetes cluster architecture
 - Deploy and configure workloads, services, and ingress

package/agents/sre-network-specialist.md

@@ -10,9 +10,6 @@ tech_artifacts: "[network diagrams, CIDR plans, firewall rules, runbooks]"
 ## Role
 Design and operate secure, high-performance network infrastructure. Focus on network architecture, connectivity, DNS, load balancing, VPN, firewall management, and reliable communication across distributed systems.
 
-## Technical Stack
-${config.tech_stack}
-
 ## Responsibilities
 - Design and implement cloud network architectures
 - Configure VPCs, subnets, and network segmentation

package/agents/wearos-engineer.md

@@ -10,9 +10,6 @@ tech_artifacts: "[Sensor specs, watch face configs, tile layouts]"
 ## Role
 Design and build Wear OS smartwatch applications with optimized, battery-efficient experiences. Focus on glanceable interfaces, sensor integration, and seamless phone-watch communication.
 
-## Technical Stack
-${config.tech_stack}
-
 ## Responsibilities
 - Design and implement Wear OS applications
 - Build watch faces and complications

package/dist/cli/index.js

@@ -30,9 +30,6 @@ var ConfigError = class extends Error {
   }
 };
 var DEFAULT_AGENTS = [
-  "backend-engineer",
-  "frontend-engineer",
-  "devops-engineer",
   "engineering-manager"
 ];
 function findConfigFile(startDir = process.cwd()) {
@@ -92,13 +89,16 @@ function validateConfig(config) {
   return config;
 }
 function applyDefaults(config) {
+  const project = {
+    name: config.project?.name ?? "unnamed",
+    root: config.project?.root ?? process.cwd()
+  };
+  if (config.project?.description) {
+    project.description = config.project.description;
+  }
   return {
     ...config,
-    project: {
-      name: config.project?.name ?? "unnamed",
-      type: config.project?.type ?? "software",
-      root: config.project?.root ?? process.cwd()
-    },
+    project,
     team: {
       agents: config.team?.agents ?? DEFAULT_AGENTS
     }
@@ -2028,9 +2028,6 @@ function extractVariables2(config) {
   }
   vars.PROJECT_NAME = config.project.name;
   vars.PROJECT_ROOT = config.project.root;
-  if (config.project.type) {
-    vars.PROJECT_TYPE = config.project.type;
-  }
   if (config.integrations?.issue_tracker) {
     const tracker = config.integrations.issue_tracker;
     if (tracker.config?.project_key) {
@@ -2080,9 +2077,6 @@ function extractVariables2(config) {
       }
     }
   }
-  if (config.tech_stack?.primary_language) {
-    vars.PRIMARY_LANGUAGE = config.tech_stack.primary_language;
-  }
   return vars;
 }
 function substituteVariables(content, variables) {
@@ -3001,52 +2995,107 @@ function detectProjectName(projectRoot) {
   }
   return basename3(projectRoot);
 }
+function detectQualityGates(projectRoot) {
+  const gates = {};
+  const packageJsonPath = join11(projectRoot, "package.json");
+  if (existsSync7(packageJsonPath)) {
+    try {
+      const pkg = JSON.parse(readFileSync8(packageJsonPath, "utf-8"));
+      if (pkg.scripts?.lint) {
+        gates.lint = "npm run lint";
+      }
+      if (pkg.scripts?.test) {
+        gates.test = "npm test";
+      }
+    } catch {
+    }
+  }
+  return gates;
+}
 function generateConfigYaml(options) {
-  let yaml = `# CoreAI Configuration
-# See https://coreai.dev/docs/config for full schema
-
-version: "1.0"
-
-project:
-  name: "${options.name}"
-  type: ${options.type}
-
-team:
-  agents:
-    - backend-engineer
-    - frontend-engineer
-    - devops-engineer
-    - engineering-manager
-`;
+  const lines = [
+    "# CoreAI Configuration",
+    "# See https://coreai.dev/docs/config for full schema",
+    "",
+    'version: "1.0"',
+    "",
+    "project:",
+    `  name: "${options.name}"`,
+    '  # description: "Brief description of your project"',
+    "",
+    "# Agents to compile. Add more with: coreai agents add <name>",
+    "# See available agents with: coreai agents list",
+    "team:",
+    "  agents:",
+    "    - engineering-manager",
+    ""
+  ];
+  const gates = options.qualityGates;
+  if (gates?.lint || gates?.test) {
+    lines.push("# Commands agents must run before finishing work.");
+    lines.push("quality_gates:");
+    if (gates.lint) {
+      lines.push("  lint:");
+      lines.push(`    command: ${gates.lint}`);
+      lines.push("    required: true");
+    }
+    if (gates.test) {
+      lines.push("  test:");
+      lines.push(`    command: ${gates.test}`);
+      lines.push("    required: true");
+    }
+    lines.push("  # typecheck:");
+    lines.push("  #   command: npx tsc --noEmit");
+    lines.push("  #   required: true");
+  } else {
+    lines.push("# Commands agents must run before finishing work.");
+    lines.push("# quality_gates:");
+    lines.push("#   lint:");
+    lines.push("#     command: npm run lint");
+    lines.push("#     required: true");
+    lines.push("#   test:");
+    lines.push("#     command: npm test");
+    lines.push("#     required: true");
+  }
+  lines.push("");
   if (options.gitInfo?.provider) {
-    yaml += `
-integrations:
-  git:
-    provider: ${options.gitInfo.provider}
-    config:
-      owner: "${options.gitInfo.owner}"
-      repo: "${options.gitInfo.repo}"
-`;
-  }
-  yaml += `
-# quality_gates:
-#   lint:
-#     command: npm run lint
-#     required: true
-#   test:
-#     command: npm test
-#     required: true
-#   build:
-#     command: npm run build
-#     required: true
-
-# tech_stack:
-#   primary_language: typescript
-#   frameworks:
-#     - node.js
-#     - express
-`;
-  return yaml;
+    lines.push("integrations:");
+    lines.push("  git:");
+    lines.push(`    provider: ${options.gitInfo.provider}`);
+    lines.push("    config:");
+    lines.push(`      owner: "${options.gitInfo.owner}"`);
+    lines.push(`      repo: "${options.gitInfo.repo}"`);
+    lines.push("  # issue_tracker:");
+    lines.push("#     provider: jira            # jira | linear | github-issues | azure-devops");
+    lines.push("#     config:");
+    lines.push('#       project_key: "PROJ"');
+    lines.push('#       base_url: "https://your-instance.atlassian.net"');
+    lines.push("  # documentation:");
+    lines.push("#     provider: confluence      # confluence | notion | github-wiki | local");
+    lines.push("#     config:");
+    lines.push('#       base_url: "https://your-instance.atlassian.net/wiki"');
+    lines.push('#       space_key: "TEAM"');
+  } else {
+    lines.push("# External tool integrations");
+    lines.push("# integrations:");
+    lines.push("#   git:");
+    lines.push("#     provider: github          # github | gitlab | bitbucket | azure-devops");
+    lines.push("#     config:");
+    lines.push('#       owner: "your-org"');
+    lines.push('#       repo: "your-repo"');
+    lines.push("#   issue_tracker:");
+    lines.push("#     provider: jira            # jira | linear | github-issues | azure-devops");
+    lines.push("#     config:");
+    lines.push('#       project_key: "PROJ"');
+    lines.push('#       base_url: "https://your-instance.atlassian.net"');
+    lines.push("#   documentation:");
+    lines.push("#     provider: confluence      # confluence | notion | github-wiki | local");
+    lines.push("#     config:");
+    lines.push('#       base_url: "https://your-instance.atlassian.net/wiki"');
+    lines.push('#       space_key: "TEAM"');
+  }
+  lines.push("");
+  return lines.join("\n");
 }
 function createDirectories(projectRoot) {
   const dirs = [
@@ -3073,8 +3122,8 @@ function init(options = {}) {
   }
   const gitInfo = detectGitInfo();
   const name = options.name ?? detectProjectName(projectRoot);
-  const type = options.type ?? "software";
-  const configContent = generateConfigYaml({ name, type, gitInfo });
+  const qualityGates = detectQualityGates(projectRoot);
+  const configContent = generateConfigYaml({ name, gitInfo, qualityGates });
   const configPath = join11(projectRoot, "coreai.config.yaml");
   try {
     writeFileSync4(configPath, configContent, "utf-8");
@@ -3126,8 +3175,8 @@ Detected ${result.gitInfo.provider} repository: ${result.gitInfo.owner}/${result
   }
   lines.push("\nNext steps:");
   lines.push("  1. Edit coreai.config.yaml to configure your project");
-  lines.push("  2. Run `coreai build` to compile agents");
-  lines.push("  3. Run `coreai validate` to check your setup");
+  lines.push("  2. Add agents with `coreai agents add <name>`");
+  lines.push("  3. Run `coreai build` to compile agents");
   return lines.join("\n");
 }