cc-agentic-framework 1.14.1

package/framework/modules/core/templates/context/process-expert.template.md

@@ -0,0 +1,213 @@
+# Process Context - Expert Level
+
+<!-- CONTEXT-LEVEL: expert -->
+<!-- CATEGORY: process -->
+<!-- TOKEN-TARGET: ~1500 -->
+
+> **Purpose:** Strategic processes including planning cycles, architecture reviews, and long-term evolution
+>
+> **When loaded:** Loaded with expert context level only
+
+---
+
+## Planning Cycles
+
+<!-- TEMPLATE: Describe strategic planning cycles and processes -->
+
+### Annual Planning
+
+<!-- TEMPLATE: Describe annual planning process -->
+
+**Timeline:** <!-- TEMPLATE: When annual planning happens -->
+
+**Participants:** <!-- TEMPLATE: Who is involved -->
+
+**Process:**
+<!-- TEMPLATE: Describe the annual planning process -->
+
+1.
+2.
+3.
+
+### Quarterly Planning
+
+<!-- TEMPLATE: Describe quarterly planning process -->
+
+**Timeline:** <!-- TEMPLATE: When quarterly planning happens -->
+
+**Process:**
+<!-- TEMPLATE: Describe the quarterly planning process -->
+
+### Sprint/Iteration Planning
+
+<!-- TEMPLATE: Describe sprint or iteration planning process -->
+
+## Architecture Review Process
+
+<!-- TEMPLATE: Describe the architecture review process -->
+
+### Architecture Review Board
+
+<!-- TEMPLATE: Describe ARB composition and authority -->
+
+**Members:** <!-- TEMPLATE: List ARB members or roles -->
+
+**Authority:** <!-- TEMPLATE: Define ARB authority and decision-making power -->
+
+### Review Triggers
+
+<!-- TEMPLATE: Define when architecture review is required -->
+
+### Review Process
+
+<!-- TEMPLATE: Describe step-by-step architecture review process -->
+
+1. **Proposal Submission:** <!-- TEMPLATE: How proposals are submitted -->
+2. **Initial Review:** <!-- TEMPLATE: Initial review process -->
+3. **Discussion:** <!-- TEMPLATE: Discussion and feedback process -->
+4. **Decision:** <!-- TEMPLATE: How decisions are made -->
+5. **Documentation:** <!-- TEMPLATE: How decisions are documented -->
+
+### Architecture Standards
+
+<!-- TEMPLATE: Document architectural standards and principles -->
+
+## Strategic Decision-Making
+
+<!-- TEMPLATE: Describe strategic decision-making processes -->
+
+### Decision Types
+
+<!-- TEMPLATE: Categorize different types of strategic decisions -->
+
+| Decision Type | Authority | Process |
+|---------------|-----------|---------|
+| <!-- TEMPLATE: Add decision types --> | | |
+
+### Decision Framework
+
+<!-- TEMPLATE: Describe the framework used for strategic decisions -->
+
+### Stakeholder Involvement
+
+<!-- TEMPLATE: Describe how stakeholders are involved in strategic decisions -->
+
+## Long-term Process Evolution
+
+<!-- TEMPLATE: Describe how processes evolve over time -->
+
+### Process Improvement Framework
+
+<!-- TEMPLATE: Describe framework for continuous process improvement -->
+
+### Retrospective Cadence
+
+<!-- TEMPLATE: Describe retrospective schedule and process -->
+
+### Process Metrics
+
+<!-- TEMPLATE: Define metrics used to measure process effectiveness -->
+
+| Metric | Target | Purpose |
+|--------|--------|---------|
+| <!-- TEMPLATE: Add process metrics --> | | |
+
+## Resource Allocation
+
+<!-- TEMPLATE: Describe how resources are allocated strategically -->
+
+### Budget Planning
+
+<!-- TEMPLATE: Describe budget planning process -->
+
+### Team Capacity Planning
+
+<!-- TEMPLATE: Describe capacity planning process -->
+
+### Priority Framework
+
+<!-- TEMPLATE: Describe how priorities are determined and balanced -->
+
+## Risk Management
+
+<!-- TEMPLATE: Describe strategic risk management process -->
+
+### Risk Identification
+
+<!-- TEMPLATE: Describe how risks are identified -->
+
+### Risk Assessment
+
+<!-- TEMPLATE: Describe risk assessment framework -->
+
+| Risk Level | Criteria | Response |
+|------------|----------|----------|
+| <!-- TEMPLATE: Add risk levels --> | | |
+
+### Risk Mitigation
+
+<!-- TEMPLATE: Describe risk mitigation strategies -->
+
+## Governance
+
+<!-- TEMPLATE: Describe governance structure and processes -->
+
+### Governance Structure
+
+<!-- TEMPLATE: Describe governance bodies and their roles -->
+
+### Policy Framework
+
+<!-- TEMPLATE: Describe key policies and how they're maintained -->
+
+### Compliance Requirements
+
+<!-- TEMPLATE: Document compliance requirements and processes -->
+
+## Strategic Communication
+
+<!-- TEMPLATE: Describe strategic communication processes -->
+
+### Stakeholder Communication
+
+<!-- TEMPLATE: Describe how strategic updates are communicated to stakeholders -->
+
+### Executive Reporting
+
+<!-- TEMPLATE: Describe executive reporting cadence and format -->
+
+### Transparency Principles
+
+<!-- TEMPLATE: Define principles for transparency and information sharing -->
+
+## Innovation Process
+
+<!-- TEMPLATE: Describe process for fostering and managing innovation -->
+
+### Innovation Time
+
+<!-- TEMPLATE: Describe how innovation time is allocated -->
+
+### Experimentation Framework
+
+<!-- TEMPLATE: Describe framework for experiments and POCs -->
+
+### Innovation Review
+
+<!-- TEMPLATE: Describe how innovations are reviewed and potentially adopted -->
+
+## Knowledge Management
+
+<!-- TEMPLATE: Describe strategic knowledge management -->
+
+### Knowledge Capture
+
+<!-- TEMPLATE: Describe how organizational knowledge is captured -->
+
+### Knowledge Sharing
+
+<!-- TEMPLATE: Describe knowledge sharing practices -->
+
+### Onboarding Process
+
+<!-- TEMPLATE: Describe strategic onboarding process for new team members -->

package/framework/modules/core/templates/context/technical-advanced.template.md

@@ -0,0 +1,111 @@
+# Technical Context - Advanced Level
+
+<!-- CONTEXT-LEVEL: advanced -->
+<!-- CATEGORY: technical -->
+<!-- TOKEN-TARGET: ~1000 -->
+
+> **Purpose:** Detailed technical patterns, API conventions, and system integration
+>
+> **When loaded:** Loaded with advanced+ context levels
+
+---
+
+## API Patterns and Conventions
+
+<!-- TEMPLATE: Describe your API design patterns and conventions -->
+
+### RESTful API Conventions
+
+<!-- TEMPLATE: Document REST API patterns, naming conventions, response formats -->
+
+### GraphQL Patterns
+
+<!-- TEMPLATE: If applicable, document GraphQL schema patterns and conventions -->
+
+### Authentication & Authorization
+
+<!-- TEMPLATE: Describe authentication and authorization patterns -->
+
+## Integration Patterns
+
+<!-- TEMPLATE: Describe how different parts of the system integrate -->
+
+### External Integrations
+
+<!-- TEMPLATE: Document third-party service integrations -->
+
+| Service | Purpose | Integration Pattern |
+|---------|---------|---------------------|
+| <!-- TEMPLATE: Add integrations --> | | |
+
+### Internal Service Communication
+
+<!-- TEMPLATE: Describe how internal services communicate (REST, events, messaging, etc.) -->
+
+## Data Models
+
+<!-- TEMPLATE: Document key data models and their relationships -->
+
+### Core Entities
+
+<!-- TEMPLATE: Describe primary domain entities -->
+
+#### Entity 1: [Entity Name]
+
+<!-- TEMPLATE: Describe the entity, its fields, and relationships -->
+
+#### Entity 2: [Entity Name]
+
+<!-- TEMPLATE: Describe the entity, its fields, and relationships -->
+
+### Data Flow
+
+<!-- TEMPLATE: Describe how data flows through the system -->
+
+## Service Boundaries
+
+<!-- TEMPLATE: Document how the system is divided into services or modules -->
+
+### Service 1: [Service Name]
+
+<!-- TEMPLATE: Describe the service's responsibilities and boundaries -->
+
+### Service 2: [Service Name]
+
+<!-- TEMPLATE: Describe the service's responsibilities and boundaries -->
+
+## Error Handling
+
+<!-- TEMPLATE: Describe error handling patterns and conventions -->
+
+### Error Types
+
+<!-- TEMPLATE: Document error classification and handling strategies -->
+
+### Logging Patterns
+
+<!-- TEMPLATE: Describe logging conventions and patterns -->
+
+## Testing Patterns
+
+<!-- TEMPLATE: Describe testing strategies and conventions -->
+
+### Unit Testing
+
+<!-- TEMPLATE: Document unit testing patterns and conventions -->
+
+### Integration Testing
+
+<!-- TEMPLATE: Document integration testing patterns -->
+
+## Performance Patterns
+
+<!-- TEMPLATE: Describe performance optimization patterns used -->
+
+### Caching Strategy
+
+<!-- TEMPLATE: Document caching patterns and policies -->
+
+### Database Optimization
+
+<!-- TEMPLATE: Describe database optimization patterns -->

package/framework/modules/core/templates/context/technical-basic.template.md

@@ -0,0 +1,66 @@
+# Technical Context - Basic Level
+
+<!-- CONTEXT-LEVEL: basic -->
+<!-- CATEGORY: technical -->
+<!-- TOKEN-TARGET: ~500 -->
+
+> **Purpose:** Tech stack overview, architecture basics, and key patterns
+>
+> **When loaded:** Always loaded for all agents
+
+---
+
+## Technology Stack
+
+<!-- TEMPLATE: List the core technologies used in your project -->
+
+### Frontend
+
+<!-- TEMPLATE: List frontend technologies (frameworks, libraries, etc.) -->
+
+### Backend
+
+<!-- TEMPLATE: List backend technologies (languages, frameworks, databases, etc.) -->
+
+### Infrastructure
+
+<!-- TEMPLATE: List infrastructure technologies (cloud provider, CI/CD, monitoring, etc.) -->
+
+## Architecture Overview
+
+<!-- TEMPLATE: Provide a high-level description of your system architecture -->
+
+## Key Patterns Used
+
+<!-- TEMPLATE: Describe the main architectural or design patterns you use -->
+
+### Pattern 1: [Pattern Name]
+
+<!-- TEMPLATE: Briefly describe how this pattern is used -->
+
+### Pattern 2: [Pattern Name]
+
+<!-- TEMPLATE: Briefly describe how this pattern is used -->
+
+## Directory Structure
+
+<!-- TEMPLATE: Describe your project's directory structure and organization -->
+
+```
+project-root/
+├── <!-- TEMPLATE: Add your directory structure -->
+├──
+└──
+```
+
+## Development Environment
+
+<!-- TEMPLATE: Describe requirements and setup for the development environment -->
+
+### Prerequisites
+
+<!-- TEMPLATE: List required tools, versions, etc. -->
+
+### Getting Started
+
+<!-- TEMPLATE: Basic steps to get the project running locally -->

package/framework/modules/core/templates/context/technical-expert.template.md

@@ -0,0 +1,157 @@
+# Technical Context - Expert Level
+
+<!-- CONTEXT-LEVEL: expert -->
+<!-- CATEGORY: technical -->
+<!-- TOKEN-TARGET: ~1500 -->
+
+> **Purpose:** Deep technical context including architecture decisions, performance, and technical strategy
+>
+> **When loaded:** Loaded with expert context level only
+
+---
+
+## Architecture Decisions and Rationale
+
+<!-- TEMPLATE: Document major architectural decisions and why they were made -->
+
+### ADR 1: [Decision Title]
+
+<!-- TEMPLATE: Document the decision, context, options considered, and rationale -->
+
+**Status:** <!-- TEMPLATE: Accepted/Deprecated/Superseded -->
+
+**Context:**
+<!-- TEMPLATE: Describe the context that led to this decision -->
+
+**Decision:**
+<!-- TEMPLATE: Describe what was decided -->
+
+**Consequences:**
+<!-- TEMPLATE: Describe the consequences of this decision -->
+
+### ADR 2: [Decision Title]
+
+<!-- TEMPLATE: Document the decision, context, options considered, and rationale -->
+
+**Status:** <!-- TEMPLATE: Accepted/Deprecated/Superseded -->
+
+**Context:**
+<!-- TEMPLATE: Describe the context that led to this decision -->
+
+**Decision:**
+<!-- TEMPLATE: Describe what was decided -->
+
+**Consequences:**
+<!-- TEMPLATE: Describe the consequences of this decision -->
+
+## Performance Considerations
+
+<!-- TEMPLATE: Document critical performance requirements and strategies -->
+
+### Performance Requirements
+
+<!-- TEMPLATE: Define key performance targets -->
+
+| Metric | Target | Current |
+|--------|--------|---------|
+| <!-- TEMPLATE: Add performance metrics --> | | |
+
+### Performance Bottlenecks
+
+<!-- TEMPLATE: Document known performance bottlenecks and mitigation strategies -->
+
+### Scalability Strategy
+
+<!-- TEMPLATE: Describe how the system scales and future scalability plans -->
+
+## Security Architecture
+
+<!-- TEMPLATE: Document security architecture and practices -->
+
+### Security Model
+
+<!-- TEMPLATE: Describe the security model and threat model -->
+
+### Security Controls
+
+<!-- TEMPLATE: List key security controls and their implementation -->
+
+## Data Architecture
+
+<!-- TEMPLATE: Document data architecture strategy -->
+
+### Data Storage Strategy
+
+<!-- TEMPLATE: Describe storage patterns, partitioning, retention policies -->
+
+### Data Migration Strategy
+
+<!-- TEMPLATE: Describe approach to schema migrations and data migrations -->
+
+## Future Architecture Plans
+
+<!-- TEMPLATE: Document planned architectural changes and evolution -->
+
+### Planned Migrations
+
+<!-- TEMPLATE: Describe planned technical migrations -->
+
+### Architecture Evolution
+
+<!-- TEMPLATE: Describe how the architecture is expected to evolve -->
+
+## Technical Debt
+
+<!-- TEMPLATE: Document significant technical debt and repayment plans -->
+
+### High Priority Technical Debt
+
+<!-- TEMPLATE: List and describe critical technical debt items -->
+
+| Item | Impact | Priority | Plan |
+|------|--------|----------|------|
+| <!-- TEMPLATE: Add technical debt items --> | | | |
+
+### Technical Debt Strategy
+
+<!-- TEMPLATE: Describe overall approach to managing technical debt -->
+
+## System Constraints
+
+<!-- TEMPLATE: Document system-level constraints and limitations -->
+
+### Performance Constraints
+
+<!-- TEMPLATE: Describe performance-related constraints -->
+
+### Operational Constraints
+
+<!-- TEMPLATE: Describe operational constraints (deployment windows, maintenance, etc.) -->
+
+### Technology Constraints
+
+<!-- TEMPLATE: Describe technology constraints (legacy systems, vendor lock-in, etc.) -->
+
+## Disaster Recovery and Resilience
+
+<!-- TEMPLATE: Document disaster recovery and resilience strategies -->
+
+### Backup Strategy
+
+<!-- TEMPLATE: Describe backup and recovery procedures -->
+
+### Failover Strategy
+
+<!-- TEMPLATE: Describe failover and high availability approach -->
+
+## Monitoring and Observability
+
+<!-- TEMPLATE: Document monitoring and observability strategy -->
+
+### Key Metrics
+
+<!-- TEMPLATE: List critical system metrics monitored -->
+
+### Alerting Strategy
+
+<!-- TEMPLATE: Describe alerting philosophy and critical alerts -->

package/framework/modules/core/templates/module/module.json.template

@@ -0,0 +1,20 @@
+{
+  "$schema": "../core/registries/schemas/module.schema.json",
+  "id": "{{id}}",
+  "version": "{{version}}",
+  "name": "{{name}}",
+  "description": "{{description}}",
+  "provides": {
+    "agents": [],
+    "skills": [],
+    "capabilities": [],
+    "cli-commands": []
+  },
+  "requires": {
+    "core": ">=1.0.0"
+  },
+  "metadata": {
+    "category": "{{category}}",
+    "author": "{{author}}"
+  }
+}

package/framework/modules/core/templates/module/template.config.json

@@ -0,0 +1,41 @@
+{
+  "$schema": "../../registries/schemas/template.schema.json",
+  "version": "1.0",
+  "templates": {
+    "module.json": {
+      "output": "module.json",
+      "description": "Create a new module.json manifest file",
+      "variables": {
+        "required": ["id", "name", "description"],
+        "optional": ["version", "category", "author"],
+        "computed": []
+      },
+      "defaults": {
+        "version": "1.0.0",
+        "category": "workflow",
+        "author": "Agentic Framework"
+      },
+      "validation": {
+        "id": {
+          "pattern": "^[a-z][a-z0-9-]*$",
+          "minLength": 2,
+          "maxLength": 30
+        },
+        "name": {
+          "minLength": 3,
+          "maxLength": 50
+        },
+        "description": {
+          "minLength": 10,
+          "maxLength": 200
+        },
+        "version": {
+          "pattern": "^\\d+\\.\\d+\\.\\d+$"
+        },
+        "category": {
+          "enum": ["core", "integration", "workflow", "development", "documentation", "reporting"]
+        }
+      }
+    }
+  }
+}

package/framework/modules/core/templates/skill/SKILL.md.template

@@ -0,0 +1,96 @@
+---
+id: {{id}}
+name: {{name}}
+description: {{description}}
+scope: {{scope}}
+applicable-projects: {{applicableProjects}}
+module: {{module}}
+capabilities-provided:
+  - {{capability}}
+---
+
+# {{title}}
+
+## When to Use This Skill
+
+Use this skill when you need to:
+- <!-- TODO: Add first use case -->
+- <!-- TODO: Add second use case -->
+- <!-- TODO: Add third use case -->
+
+This skill is applicable to: **{{applicableProjects}}** projects.
+
+**Example invocation:** "Use {{id}} to help me <!-- TODO: describe a typical task -->"
+
+---
+
+## Quick Reference
+
+<!-- TODO: Add quick reference section with common patterns or commands -->
+
+### Common Operations
+
+```
+<!-- TODO: Add code examples -->
+```
+
+---
+
+## Workflow
+
+### Step 1: Preparation
+
+<!-- TODO: Describe preparation steps -->
+
+### Step 2: Execution
+
+<!-- TODO: Describe execution steps -->
+
+### Step 3: Validation
+
+<!-- TODO: Describe validation steps -->
+
+---
+
+## Best Practices
+
+1. **<!-- TODO: Best practice 1 -->**
+   - Details...
+
+2. **<!-- TODO: Best practice 2 -->**
+   - Details...
+
+3. **<!-- TODO: Best practice 3 -->**
+   - Details...
+
+---
+
+## Common Patterns
+
+### Pattern 1: <!-- TODO: Pattern name -->
+
+```
+<!-- TODO: Add pattern example -->
+```
+
+**When to use:** <!-- TODO: Describe when to use this pattern -->
+
+---
+
+## Troubleshooting
+
+### Problem: <!-- TODO: Common problem -->
+
+**Solution:** <!-- TODO: Solution description -->
+
+---
+
+## Related Skills
+
+- <!-- TODO: List related skills if any -->
+
+---
+
+**Created:** {{date}}
+**Scope:** {{scope}}
+**Module:** {{module}}