npm - aigroup-workflow - Versions diffs - 2.1.2 → 2.2.0 - Mend

aigroup-workflow 2.1.2 → 2.2.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (913) hide show

package/skills/debugging-wizard/references/systematic-debugging.md DELETED Viewed

@@ -1,367 +0,0 @@
-# Systematic Debugging
----
-## Core Principle
-> **NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST.**
-Jumping to fixes without understanding causes creates more bugs. Systematic debugging prevents the "fix one thing, break two more" cycle.
----
-## The Four Mandatory Phases
-```
-┌─────────────────────────────────────────────────────────────┐
-│                    SYSTEMATIC DEBUGGING                      │
-├─────────────────────────────────────────────────────────────┤
-│  Phase 1: ROOT CAUSE INVESTIGATION                          │
-│  ├── Read error messages thoroughly                         │
-│  ├── Reproduce reliably with documented steps               │
-│  ├── Examine recent changes                                 │
-│  └── Trace data flow backward                               │
-├─────────────────────────────────────────────────────────────┤
-│  Phase 2: PATTERN ANALYSIS                                   │
-│  ├── Find similar working implementations                   │
-│  ├── Study reference implementations completely             │
-│  └── Document all differences                               │
-├─────────────────────────────────────────────────────────────┤
-│  Phase 3: HYPOTHESIS TESTING                                 │
-│  ├── Form specific, written hypothesis                      │
-│  ├── Test with minimal, isolated changes                    │
-│  └── One variable at a time                                 │
-├─────────────────────────────────────────────────────────────┤
-│  Phase 4: IMPLEMENTATION                                     │
-│  ├── Create failing test case                               │
-│  ├── Implement single fix addressing root cause             │
-│  └── Verify no new breakage                                 │
-└─────────────────────────────────────────────────────────────┘
-```
----
-## Phase 1: Root Cause Investigation
-**Objective:** Understand exactly what is failing and why before attempting any fix.
-### Step 1.1: Read Error Messages Thoroughly
-```bash
-# Don't just read the first line
-TypeError: Cannot read property 'map' of undefined
-    at UserList.render (UserList.tsx:24)
-    at renderWithHooks (react-dom.js:14985)
-    at mountIndeterminateComponent (react-dom.js:17811)
-```
-**Key questions:**
-- What exact operation failed?
-- Where in the code (file, line)?
-- What was the call stack?
-- Are there multiple errors or just one?
-### Step 1.2: Reproduce Reliably
-```markdown
-## Reproduction Steps
-1. Navigate to /users
-2. Click "Load More" button
-3. Wait for loading spinner
-4. **ERROR: "Cannot read property 'map' of undefined"**
-## Environment
-- Browser: Chrome 120
-- User: Admin role
-- Data state: 50+ users in database
-```
-**Requirement:** Document exact steps that reproduce the bug 100% of the time.
-### Step 1.3: Examine Recent Changes
-```bash
-# What changed recently?
-git log --oneline -10
-# What specifically changed in the failing file?
-git log -p UserList.tsx
-# When did this start failing?
-git bisect start
-git bisect bad HEAD
-git bisect good v1.2.0
-```
-### Step 1.4: Trace Data Flow Backward
-```typescript
-// Error happens here:
-users.map(u => u.name)  // users is undefined
-// Trace backward:
-// Where does 'users' come from?
-const users = props.users;
-// Where do props come from?
-<UserList users={data.users} />
-// Where does data come from?
-const { data } = useQuery(GET_USERS);
-// ROOT CAUSE: Query returns { users: null } when loading
-```
-### Step 1.5: Add Diagnostic Instrumentation
-```typescript
-// Add temporary logging at boundaries
-console.log('[UserList] props:', JSON.stringify(props));
-console.log('[UserList] users type:', typeof props.users);
-console.log('[UserList] users value:', props.users);
-// Check at data source
-console.log('[API] Response:', response);
-console.log('[API] Response.data:', response.data);
-```
----
-## Phase 2: Pattern Analysis
-**Objective:** Find working examples to understand what correct behavior looks like.
-### Step 2.1: Locate Similar Working Implementations
-```bash
-# Find similar components that work correctly
-grep -r "useQuery" src/components/ --include="*.tsx"
-# Find how other lists handle loading states
-grep -r "loading" src/components/*List* --include="*.tsx"
-```
-### Step 2.2: Study Reference Implementations Completely
-```typescript
-// WORKING: ProductList.tsx
-function ProductList({ products, loading }) {
-  if (loading) return <Spinner />;
-  if (!products) return null;  // ← Handles undefined case
-  return products.map(p => <ProductItem key={p.id} {...p} />);
-}
-// BROKEN: UserList.tsx
-function UserList({ users, loading }) {
-  if (loading) return <Spinner />;
-  // Missing: !users check
-  return users.map(u => <UserItem key={u.id} {...u} />);  // 💥 Crashes
-}
-```
-### Step 2.3: Document All Differences
-| Aspect | Working (ProductList) | Broken (UserList) |
-|--------|----------------------|-------------------|
-| Null check | `if (!products)` | Missing |
-| Default value | `products ?? []` | None |
-| Loading handled | Before render | Before render |
-| Error handled | Returns ErrorState | Missing |
----
-## Phase 3: Hypothesis Testing
-**Objective:** Verify your understanding with controlled experiments.
-### Step 3.1: Form Specific, Written Hypothesis
-```markdown
-## Hypothesis #1
-**Statement:** The crash occurs because `users` is undefined when the
-query is complete but returns no data.
-**Prediction:** Adding a null check before `.map()` will prevent the crash.
-**Test:** Add `if (!users) return null;` before the map call.
-```
-### Step 3.2: Test with Minimal Changes
-```typescript
-// Change ONLY one thing
-function UserList({ users, loading }) {
-  if (loading) return <Spinner />;
-  if (!users) return null;  // ← Single change
-  return users.map(u => <UserItem key={u.id} {...u} />);
-}
-```
-### Step 3.3: One Variable at a Time
-```markdown
-## Test Results
-| Hypothesis | Change | Result | Conclusion |
-|------------|--------|--------|------------|
-| #1: Null check | Add `if (!users)` | ✓ Pass | Confirmed |
-Do NOT test multiple hypotheses simultaneously.
-```
----
-## Phase 4: Implementation
-**Objective:** Fix the bug permanently with proper safeguards.
-### Step 4.1: Create Failing Test Case First
-```typescript
-describe('UserList', () => {
-  it('should handle undefined users gracefully', () => {
-    // This test should FAIL before the fix
-    const { container } = render(<UserList users={undefined} loading={false} />);
-    expect(container).not.toThrow();
-    expect(screen.queryByRole('list')).not.toBeInTheDocument();
-  });
-});
-```
-### Step 4.2: Implement Single Fix
-```typescript
-function UserList({ users, loading }: UserListProps) {
-  if (loading) return <Spinner />;
-  if (!users || users.length === 0) {
-    return <EmptyState message="No users found" />;
-  }
-  return (
-    <ul role="list">
-      {users.map(u => <UserItem key={u.id} {...u} />)}
-    </ul>
-  );
-}
-```
-### Step 4.3: Verify No New Breakage
-```bash
-# Run full test suite
-npm test
-# Run specific component tests
-npm test UserList
-# Run integration tests
-npm run test:integration
-# Verify in browser
-# 1. Normal case: 50 users
-# 2. Empty case: 0 users
-# 3. Loading case: spinner shows
-# 4. Error case: error message shows
-```
----
-## The Three-Fix Threshold
-> **After 3 failed fix attempts → STOP.**
-Three failures in different locations signals architectural problems, not isolated bugs.
-### What Three Failures Means
-```
-Fix Attempt 1: Added null check → New error in child component
-Fix Attempt 2: Fixed child component → New error in parent
-Fix Attempt 3: Fixed parent → Original error returns
-                              ↓
-                    STOP. QUESTION ARCHITECTURE.
-```
-### At the Threshold, Do This
-1. **Stop fixing symptoms**
-2. **Document the pattern** of failures
-3. **Identify architectural assumptions** being violated
-4. **Propose structural change** rather than patch
-5. **Discuss with team** before proceeding
----
-## Red Flags Requiring Process Reset
-When you notice these, stop and restart from Phase 1:
-| Red Flag | Why It's Wrong |
-|----------|----------------|
-| Proposing solutions before tracing data flow | Guessing, not debugging |
-| Making multiple simultaneous changes | Can't identify which change worked |
-| Skipping test creation | Bug will recur |
-| "Let's try this and see if it works" | Shotgun debugging |
-| Fixing without understanding the cause | Band-aid, not cure |
----
-## Decision Flowchart
-```
-                    ┌──────────────────┐
-                    │   Bug Reported   │
-                    └────────┬─────────┘
-                             │
-              ┌──────────────▼──────────────┐
-              │   Can you reproduce it?      │
-              └──────────────┬──────────────┘
-                    No       │       Yes
-            ┌────────────────┴────────────────┐
-            ▼                                  ▼
-    ┌───────────────┐               ┌─────────────────┐
-    │ Get more info │               │ Trace data flow │
-    └───────────────┘               └────────┬────────┘
-                                             │
-                              ┌──────────────▼──────────────┐
-                              │ Do you understand the cause? │
-                              └──────────────┬──────────────┘
-                                    No       │       Yes
-                    ┌────────────────────────┴─────────┐
-                    ▼                                   ▼
-            ┌───────────────┐               ┌─────────────────┐
-            │ Study working │               │ Write hypothesis│
-            │   examples    │               └────────┬────────┘
-            └───────────────┘                        │
-                                             ┌───────▼───────┐
-                                             │  Write test   │
-                                             └───────┬───────┘
-                                                     │
-                                             ┌───────▼───────┐
-                                             │  Implement    │
-                                             └───────┬───────┘
-                                                     │
-                                  ┌──────────────────▼──────────────────┐
-                                  │          Does test pass?            │
-                                  └──────────────────┬──────────────────┘
-                                            No       │       Yes
-                            ┌────────────────────────┴──────────┐
-                            ▼                                    ▼
-                    ┌───────────────┐                  ┌─────────────────┐
-                    │ Attempt < 3?  │                  │      Done       │
-                    └───────┬───────┘                  └─────────────────┘
-                    No      │      Yes
-            ┌───────────────┴─────────────────┐
-            ▼                                  ▼
-    ┌───────────────────┐          ┌─────────────────────┐
-    │ Question          │          │ Return to Phase 1   │
-    │ architecture      │          └─────────────────────┘
-    └───────────────────┘
-```
----
-*Content adapted from [obra/superpowers](https://github.com/obra/superpowers) by Jesse Vincent (@obra), MIT License.*

package/skills/devops-engineer/SKILL.md DELETED Viewed

@@ -1,144 +0,0 @@
----
-name: devops-engineer
-description: Creates Dockerfiles, configures CI/CD pipelines, writes Kubernetes manifests, and generates Terraform/Pulumi infrastructure templates. Handles deployment automation, GitOps configuration, incident response runbooks, and internal developer platform tooling. Use when setting up CI/CD pipelines, containerizing applications, managing infrastructure as code, deploying to Kubernetes clusters, configuring cloud platforms, automating releases, or responding to production incidents. Invoke for pipelines, Docker, Kubernetes, GitOps, Terraform, GitHub Actions, on-call, or platform engineering.
-license: MIT
-metadata:
-  author: https://github.com/Jeffallan
-  version: "1.1.1"
-  domain: devops
-  triggers: DevOps, CI/CD, deployment, Docker, Kubernetes, Terraform, GitHub Actions, infrastructure, platform engineering, incident response, on-call, self-service
-  role: engineer
-  scope: implementation
-  output-format: code
-  related-skills: terraform-engineer, kubernetes-specialist, sre-engineer, monitoring-expert, security-reviewer
----
-# DevOps Engineer
-Senior DevOps engineer specializing in CI/CD pipelines, infrastructure as code, and deployment automation.
-## Role Definition
-You are a senior DevOps engineer with 10+ years of experience. You operate with three perspectives:
-- **Build Hat**: Automating build, test, and packaging
-- **Deploy Hat**: Orchestrating deployments across environments
-- **Ops Hat**: Ensuring reliability, monitoring, and incident response
-## When to Use This Skill
-- Setting up CI/CD pipelines (GitHub Actions, GitLab CI, Jenkins)
-- Containerizing applications (Docker, Docker Compose)
-- Kubernetes deployments and configurations
-- Infrastructure as code (Terraform, Pulumi)
-- Cloud platform configuration (AWS, GCP, Azure)
-- Deployment strategies (blue-green, canary, rolling)
-- Building internal developer platforms and self-service tools
-- Incident response, on-call, and production troubleshooting
-- Release automation and artifact management
-## Core Workflow
-1. **Assess** - Understand application, environments, requirements
-2. **Design** - Pipeline structure, deployment strategy
-3. **Implement** - IaC, Dockerfiles, CI/CD configs
-4. **Validate** - Run `terraform plan`, lint configs, execute unit/integration tests; confirm no destructive changes before proceeding
-5. **Deploy** - Roll out with verification; run smoke tests post-deployment
-6. **Monitor** - Set up observability, alerts; confirm rollback procedure is ready before going live
-## Reference Guide
-Load detailed guidance based on context:
-| Topic | Reference | Load When |
-|-------|-----------|-----------|
-| GitHub Actions | `references/github-actions.md` | Setting up CI/CD pipelines, GitHub workflows |
-| Docker | `references/docker-patterns.md` | Containerizing applications, writing Dockerfiles |
-| Kubernetes | `references/kubernetes.md` | K8s deployments, services, ingress, pods |
-| Terraform | `references/terraform-iac.md` | Infrastructure as code, AWS/GCP provisioning |
-| Deployment | `references/deployment-strategies.md` | Blue-green, canary, rolling updates, rollback |
-| Platform | `references/platform-engineering.md` | Self-service infra, developer portals, golden paths, Backstage |
-| Release | `references/release-automation.md` | Artifact management, feature flags, multi-platform CI/CD |
-| Incidents | `references/incident-response.md` | Production outages, on-call, MTTR, postmortems, runbooks |
-## Constraints
-### MUST DO
-- Use infrastructure as code (never manual changes)
-- Implement health checks and readiness probes
-- Store secrets in secret managers (not env files)
-- Enable container scanning in CI/CD
-- Document rollback procedures
-- Use GitOps for Kubernetes (ArgoCD, Flux)
-### MUST NOT DO
-- Deploy to production without explicit approval
-- Store secrets in code or CI/CD variables
-- Skip staging environment testing
-- Ignore resource limits in containers
-- Use `latest` tag in production
-- Deploy on Fridays without monitoring
-## Output Templates
-Provide: CI/CD pipeline config, Dockerfile, K8s/Terraform files, deployment verification, rollback procedure
-### Minimal GitHub Actions Example
-```yaml
-name: CI
-on:
-  push:
-    branches: [main]
-jobs:
-  build-test-push:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v4
-      - name: Build image
-        run: docker build -t myapp:${{ github.sha }} .
-      - name: Run tests
-        run: docker run --rm myapp:${{ github.sha }} pytest
-      - name: Scan image
-        uses: aquasecurity/trivy-action@master
-        with:
-          image-ref: myapp:${{ github.sha }}
-      - name: Push to registry
-        run: |
-          docker tag myapp:${{ github.sha }} ghcr.io/org/myapp:${{ github.sha }}
-          docker push ghcr.io/org/myapp:${{ github.sha }}
-```
-### Minimal Dockerfile Example
-```dockerfile
-FROM python:3.12-slim AS builder
-WORKDIR /app
-COPY requirements.txt .
-RUN pip install --no-cache-dir -r requirements.txt
-FROM python:3.12-slim
-WORKDIR /app
-COPY --from=builder /usr/local/lib/python3.12/site-packages /usr/local/lib/python3.12/site-packages
-COPY . .
-USER nonroot
-HEALTHCHECK --interval=30s --timeout=5s CMD curl -f http://localhost:8080/health || exit 1
-CMD ["python", "main.py"]
-```
-### Rollback Procedure Example
-```bash
-# Kubernetes: roll back to previous deployment revision
-kubectl rollout undo deployment/myapp -n production
-kubectl rollout status deployment/myapp -n production
-# Verify rollback succeeded
-kubectl get pods -n production -l app=myapp
-curl -f https://myapp.example.com/health
-```
-Always document the rollback command and verification step in the PR or change ticket before deploying.
-## Knowledge Reference
-GitHub Actions, GitLab CI, Jenkins, CircleCI, Docker, Kubernetes, Helm, ArgoCD, Flux, Terraform, Pulumi, Crossplane, AWS/GCP/Azure, Prometheus, Grafana, PagerDuty, Backstage, LaunchDarkly, Flagger