compound-engineering

Files (1)

• SKILL.md

SKILL.md (first lines)

# Compound Engineering: Workflow Orchestration

## Overview

Compound Engineering orchestrates the Essential 2026 Plugin Suite (Debt-Sentinel, Red Team Tribunal, Spec-Lock) into unified, multi-stage workflows. It provides comprehensive quality gates and metrics tracking.

## Workflows

### 1. Safe Edit Workflow ⭐ Most Popular
**Three-stage quality gate for individual file edits**

```
Stage 1: Pre-Edit Validation (Debt-Sentinel)
  └─ BLOCKS critical anti-patterns
  └─ Scores technical debt

Stage 2: Post-Edit Sync (Spec-Lock)
  └─ Detects documentation drift
  └─ Auto-resolves if possible

Stage 3: Adversarial Review (Red Team Tribunal)
  └─ Multi-agent consensus required
  └─ REJECTS if concerns not addressed
```

**Usage:**
```bash
python3 /a0/usr/plugins/compound-engineering/compound-engineering.py \
  --workflow safe-edit --file src/auth/login.ts
```

**Outcomes:**
- **APPROVED**: All stages passed → Ready to merge
- **BLOCKED**: Critical debt detected → Must fix
- **CONDITIONAL**: Minor concerns → Address then merge
- **REJECTED**: Tribunal rejected → Significant rework needed

### 2. CI Pipeline Workflow
**Pre-deployment validation for entire codebase**

```
Stage 1: Technical Debt Analysis
  └─ Scan all files for accumulated debt
  └─ Calculate aggregate scores

Stage 2: Critical Path Review
  └─ Tribunal reviews security files
  └─ Auth, payment, API validation

Stage 3: Documentation Health
  └─ Verify all specs synchronized
  └─ Check for drift across codebase

Result: DEPLOY_READY or BLOCKED
```

**Usage:**
```bash
python3 /a0/usr/plugins/compound-engineering/compound-engineering.py \
  --workflow ci-pipeline --branch main
```

### 3. Enhancement Pipeline 🚀 Progressive Quality
**Four-level enhancement for new features**

```
Level 1: Basic Implementation
  └─ Anti-pattern checks (Debt-Sentinel)
  └─ Clean architecture validation

Level 2: Performance Optimization
  └─ Algorithm review
  └─ Resource usage analysis
  └─ Caching opportunities

Level 3: Security Hardening
  └─ Vulnerability scan
  └─ Input validation
  └─ Rate limiting

Level 4: Documentation Sync
  └─ Update all affected specs
  └─ Generate migration guides
  └─ Verify sync status
```

**Usage:**
```bash
python3 /a0/usr/plugins/compound-engineering/compound-engineering.py \
  --workflow enhancement --feature "OAuth Integration"
```

## Dashboard & Metrics

### Real-Time Dashboard
```bash
python3 /a0/usr/plugins/compound-engineering/compound-engineering.py --dashboard
```

**Shows:**
- Recent workflow runs
- 7-day statistics
- Plugin health status
- Overall quality score

### Quality Score
```
Quality Score = (1 - Block Rate) × 100

90-100%: 🌟 EXCELLENT
75-89%:  ✅ GOOD
50-74%:  ⚠️ NEEDS ATTENTION
0-49%:   🔴 CRITICAL
```

### Tracked Metrics
- **Total Workflow Runs**: Quality gates executed
- **Block/Rejection Rate**: % stopped by issues
- **Average Debt Score**: Mean technical debt

From aegntic/cldcde, MIT.

More from aegntic/cldcde