@nockdev/awf 6.2.0

package/.agent/skills/core/observability/data/language-typescript.yaml

@@ -0,0 +1,165 @@
+metadata:
+  skill: observability
+  domain: language_typescript
+  version: 6.2.0
+  updated: '2026-02-05'
+  migrated_from: language-typescript.csv
+  patterns_count: 25
+  columns:
+  - pattern_id
+  - name
+  - category
+  - description
+  - example
+  - library
+patterns:
+- id: TS-001
+  name: OpenTelemetry SDK
+  category: TypeScript
+  description: Initialize OTel in Node.js
+  example: const sdk = new NodeSDK({...}); sdk.start()
+  library: '@opentelemetry/sdk-node'
+- id: TS-002
+  name: TracerProvider
+  category: TypeScript
+  description: Configure tracer provider
+  example: new NodeTracerProvider()
+  library: '@opentelemetry/sdk-trace-node'
+- id: TS-003
+  name: MeterProvider
+  category: TypeScript
+  description: Configure metrics provider
+  example: new MeterProvider()
+  library: '@opentelemetry/sdk-metrics'
+- id: TS-004
+  name: OTLP Exporter
+  category: TypeScript
+  description: Export via OTLP
+  example: 'new OTLPTraceExporter({url: ''...''})'
+  library: '@opentelemetry/exporter-trace-otlp-http'
+- id: TS-005
+  name: Auto-Instrumentation
+  category: TypeScript
+  description: Auto-instrument common libs
+  example: 'registerInstrumentations({instrumentations: [...]})'
+  library: '@opentelemetry/instrumentation'
+- id: TS-006
+  name: Manual Spans
+  category: TypeScript
+  description: Create custom spans
+  example: tracer.startActiveSpan('op', (span) => { ... })
+  library: '@opentelemetry/api'
+- id: TS-007
+  name: Span Attributes
+  category: TypeScript
+  description: Add metadata
+  example: span.setAttribute('key', 'value')
+  library: '@opentelemetry/api'
+- id: TS-008
+  name: Context Propagation
+  category: TypeScript
+  description: Pass context via headers
+  example: propagation.inject(context.active(), carrier)
+  library: '@opentelemetry/api'
+- id: TS-009
+  name: prom-client
+  category: TypeScript
+  description: Create Prometheus metrics
+  example: 'new client.Counter({name: ''...''})'
+  library: prom-client
+- id: TS-010
+  name: prom-client HTTP
+  category: TypeScript
+  description: Expose /metrics
+  example: res.set('Content-Type', register.contentType)
+  library: prom-client
+- id: TS-011
+  name: prom-client Labels
+  category: TypeScript
+  description: Add dimensions
+  example: 'counter.inc({method: ''GET''})'
+  library: prom-client
+- id: TS-012
+  name: prom-client Histogram
+  category: TypeScript
+  description: Track latency
+  example: histogram.observe({...}, duration)
+  library: prom-client
+- id: TS-013
+  name: Default Metrics
+  category: TypeScript
+  description: Collect Node.js metrics
+  example: collectDefaultMetrics()
+  library: prom-client
+- id: TS-014
+  name: dd-trace
+  category: TypeScript
+  description: Datadog APM client
+  example: import tracer from 'dd-trace'; tracer.init()
+  library: dd-trace
+- id: TS-015
+  name: dd-trace + OTel
+  category: TypeScript
+  description: Datadog with OTel API
+  example: 'tracer.init({profiling: true})'
+  library: dd-trace
+- id: TS-016
+  name: Express Instrumentation
+  category: TypeScript
+  description: Auto-trace Express
+  example: new ExpressInstrumentation()
+  library: '@opentelemetry/instrumentation-express'
+- id: TS-017
+  name: HTTP Instrumentation
+  category: TypeScript
+  description: Auto-trace HTTP calls
+  example: new HttpInstrumentation()
+  library: '@opentelemetry/instrumentation-http'
+- id: TS-018
+  name: MongoDB Tracing
+  category: TypeScript
+  description: Trace MongoDB queries
+  example: new MongoDBInstrumentation()
+  library: '@opentelemetry/instrumentation-mongodb'
+- id: TS-019
+  name: GraphQL Tracing
+  category: TypeScript
+  description: Trace GraphQL operations
+  example: new GraphQLInstrumentation()
+  library: '@opentelemetry/instrumentation-graphql'
+- id: TS-020
+  name: Clinic.js
+  category: TypeScript
+  description: Node.js profiling
+  example: clinic doctor -- node app.js
+  library: clinic
+- id: TS-021
+  name: 0x
+  category: TypeScript
+  description: Flame graph profiler
+  example: 0x app.js
+  library: 0x
+- id: TS-022
+  name: tRPC Tracing
+  category: TypeScript
+  description: Trace tRPC procedures
+  example: Custom middleware with OTel
+  library: tRPC
+- id: TS-023
+  name: NestJS Tracing
+  category: TypeScript
+  description: Trace NestJS apps
+  example: '@opentelemetry/instrumentation-nestjs-core'
+  library: '@opentelemetry/instrumentation-nestjs'
+- id: TS-024
+  name: Winston + Trace ID
+  category: TypeScript
+  description: Logs with trace context
+  example: 'logger.info(''msg'', {traceId: span.spanContext().traceId})'
+  library: winston
+- id: TS-025
+  name: Pino + OTel
+  category: TypeScript
+  description: Structured logs with traces
+  example: pino-opentelemetry-transport
+  library: pino

package/.agent/skills/core/observability/data/metrics-patterns.yaml

@@ -0,0 +1,135 @@
+metadata:
+  skill: observability
+  domain: metrics_patterns
+  version: 6.2.0
+  updated: '2026-02-05'
+  migrated_from: metrics-patterns.csv
+  patterns_count: 20
+  columns:
+  - pattern_id
+  - name
+  - category
+  - description
+  - example
+  - level
+patterns:
+- id: MET-001
+  name: RED Method Rate
+  category: Metrics
+  description: Requests per second
+  example: http_requests_total / interval
+  level: beginner
+- id: MET-002
+  name: RED Method Errors
+  category: Metrics
+  description: Error rate percentage
+  example: http_errors_total / http_requests_total * 100
+  level: beginner
+- id: MET-003
+  name: RED Method Duration
+  category: Metrics
+  description: Request latency distribution
+  example: p50, p95, p99 latencies
+  level: beginner
+- id: MET-004
+  name: USE Method Utilization
+  category: Metrics
+  description: Resource usage percentage
+  example: cpu_usage / cpu_total * 100
+  level: intermediate
+- id: MET-005
+  name: USE Method Saturation
+  category: Metrics
+  description: Queue depth / waiting
+  example: thread_pool_queue_size
+  level: intermediate
+- id: MET-006
+  name: USE Method Errors
+  category: Metrics
+  description: Error counts for resources
+  example: disk_errors_total
+  level: intermediate
+- id: MET-007
+  name: Business Metrics
+  category: Metrics
+  description: Domain-specific KPIs
+  example: orders_placed_total, revenue_dollars
+  level: intermediate
+- id: MET-008
+  name: SLI Metrics
+  category: Metrics
+  description: Service Level Indicators
+  example: successful_requests / total_requests
+  level: intermediate
+- id: MET-009
+  name: Latency Histograms
+  category: Metrics
+  description: Distribution buckets for latency
+  example: '[0.01, 0.05, 0.1, 0.25, 0.5, 1, 2.5, 5, 10]'
+  level: intermediate
+- id: MET-010
+  name: Percentiles
+  category: Metrics
+  description: p50/p90/p95/p99 calculations
+  example: histogram_quantile() in PromQL
+  level: intermediate
+- id: MET-011
+  name: Throughput Metrics
+  category: Metrics
+  description: Operations per time unit
+  example: requests_per_second, messages_per_minute
+  level: beginner
+- id: MET-012
+  name: Error Classification
+  category: Metrics
+  description: Categorize errors by type
+  example: 4xx vs 5xx, timeout vs connection
+  level: intermediate
+- id: MET-013
+  name: Resource Metrics
+  category: Metrics
+  description: CPU/Memory/Disk/Network
+  example: process_cpu_seconds_total
+  level: beginner
+- id: MET-014
+  name: Queue Metrics
+  category: Metrics
+  description: Queue depth, processing time
+  example: messages_in_queue, message_age_seconds
+  level: intermediate
+- id: MET-015
+  name: Connection Pool Metrics
+  category: Metrics
+  description: Pool size, usage, wait time
+  example: db_pool_connections_active
+  level: intermediate
+- id: MET-016
+  name: Cache Metrics
+  category: Metrics
+  description: Hit rate, miss rate, evictions
+  example: cache_hits_total, cache_misses_total
+  level: intermediate
+- id: MET-017
+  name: Custom Dimensions
+  category: Metrics
+  description: Add context via labels
+  example: environment, version, region
+  level: beginner
+- id: MET-018
+  name: Metric Aggregation
+  category: Metrics
+  description: Combine metrics across instances
+  example: sum, avg, max by dimensions
+  level: intermediate
+- id: MET-019
+  name: Derived Metrics
+  category: Metrics
+  description: Calculate from raw metrics
+  example: error_rate = errors / requests
+  level: intermediate
+- id: MET-020
+  name: Baseline Metrics
+  category: Metrics
+  description: Normal operating ranges
+  example: Compare current to historical baseline
+  level: advanced

package/.agent/skills/core/observability/data/metrics-prometheus.yaml

@@ -0,0 +1,165 @@
+metadata:
+  skill: observability
+  domain: metrics_prometheus
+  version: 6.2.0
+  updated: '2026-02-05'
+  migrated_from: metrics-prometheus.csv
+  patterns_count: 25
+  columns:
+  - pattern_id
+  - name
+  - category
+  - description
+  - example
+  - level
+patterns:
+- id: PROM-001
+  name: Counter
+  category: Prometheus
+  description: Monotonically increasing metric
+  example: http_requests_total
+  level: beginner
+- id: PROM-002
+  name: Gauge
+  category: Prometheus
+  description: Value that can go up or down
+  example: temperature_celsius
+  level: beginner
+- id: PROM-003
+  name: Histogram
+  category: Prometheus
+  description: Distribution of values in buckets
+  example: http_request_duration_seconds
+  level: intermediate
+- id: PROM-004
+  name: Summary
+  category: Prometheus
+  description: Pre-calculated quantiles
+  example: request_latency_seconds{quantile='0.99'}
+  level: intermediate
+- id: PROM-005
+  name: Labels
+  category: Prometheus
+  description: Key-value pairs for dimensions
+  example: method, path, status_code
+  level: beginner
+- id: PROM-006
+  name: Label Best Practices
+  category: Prometheus
+  description: Limit cardinality
+  example: Avoid user_id, use bounded values
+  level: intermediate
+- id: PROM-007
+  name: Naming Conventions
+  category: Prometheus
+  description: snake_case with unit suffix
+  example: http_request_duration_seconds
+  level: beginner
+- id: PROM-008
+  name: PromQL Basics
+  category: Prometheus
+  description: Query language for metrics
+  example: rate(http_requests_total[5m])
+  level: beginner
+- id: PROM-009
+  name: Rate vs Increase
+  category: Prometheus
+  description: Per-second rate vs total increase
+  example: rate() for counters, irate() for spiky
+  level: intermediate
+- id: PROM-010
+  name: Aggregation
+  category: Prometheus
+  description: sum, avg, max, min by labels
+  example: sum by (instance) (cpu_usage)
+  level: intermediate
+- id: PROM-011
+  name: Histogram Quantiles
+  category: Prometheus
+  description: Calculate percentiles from histogram
+  example: histogram_quantile(0.95, sum(rate(h_bucket[5m])) by (le))
+  level: advanced
+- id: PROM-012
+  name: Recording Rules
+  category: Prometheus
+  description: Pre-compute expensive queries
+  example: 'record: job:http_requests:rate5m'
+  level: intermediate
+- id: PROM-013
+  name: Alerting Rules
+  category: Prometheus
+  description: Define alert conditions
+  example: 'expr: up == 0 for: 5m'
+  level: intermediate
+- id: PROM-014
+  name: Service Discovery
+  category: Prometheus
+  description: Auto-discover scrape targets
+  example: kubernetes_sd_configs, consul_sd_configs
+  level: intermediate
+- id: PROM-015
+  name: Scrape Configs
+  category: Prometheus
+  description: Define how to scrape targets
+  example: 'scrape_interval: 15s, metrics_path: /metrics'
+  level: beginner
+- id: PROM-016
+  name: Federation
+  category: Prometheus
+  description: Aggregate from multiple Prometheus
+  example: match[] selector for hierarchical setup
+  level: advanced
+- id: PROM-017
+  name: Remote Write
+  category: Prometheus
+  description: Send metrics to remote storage
+  example: Cortex, Thanos, VictoriaMetrics
+  level: advanced
+- id: PROM-018
+  name: Pushgateway
+  category: Prometheus
+  description: Accept pushed metrics
+  example: For batch jobs, short-lived processes
+  level: intermediate
+- id: PROM-019
+  name: Exporters
+  category: Prometheus
+  description: Expose metrics from systems
+  example: node_exporter, mysql_exporter
+  level: beginner
+- id: PROM-020
+  name: Client Libraries
+  category: Prometheus
+  description: Instrument applications
+  example: prometheus-go, prom-client, prometheus_client
+  level: beginner
+- id: PROM-021
+  name: Alertmanager
+  category: Prometheus
+  description: Route and manage alerts
+  example: Grouping, silencing, inhibition
+  level: intermediate
+- id: PROM-022
+  name: Silence Alerts
+  category: Prometheus
+  description: Temporarily suppress alerts
+  example: During maintenance windows
+  level: beginner
+- id: PROM-023
+  name: Alert Routing
+  category: Prometheus
+  description: Send alerts to different channels
+  example: Slack, PagerDuty, email by severity
+  level: intermediate
+- id: PROM-024
+  name: High Availability
+  category: Prometheus
+  description: Run multiple Prometheus instances
+  example: Identical configs, same targets
+  level: advanced
+- id: PROM-025
+  name: Long-term Storage
+  category: Prometheus
+  description: Store metrics beyond retention
+  example: Thanos, Cortex, VictoriaMetrics
+  level: advanced

package/.agent/skills/core/observability/data/otel-core.yaml

@@ -0,0 +1,195 @@
+metadata:
+  skill: observability
+  domain: otel_core
+  version: 6.2.0
+  updated: '2026-02-05'
+  migrated_from: otel-core.csv
+  patterns_count: 30
+  columns:
+  - pattern_id
+  - name
+  - category
+  - description
+  - example
+  - level
+patterns:
+- id: OTEL-001
+  name: SDK Initialization
+  category: OpenTelemetry
+  description: Initialize OTel SDK in app startup
+  example: Configure TracerProvider, MeterProvider
+  level: beginner
+- id: OTEL-002
+  name: TracerProvider
+  category: OpenTelemetry
+  description: Factory for creating Tracers
+  example: Set exporter, sampler, resource
+  level: intermediate
+- id: OTEL-003
+  name: MeterProvider
+  category: OpenTelemetry
+  description: Factory for creating Meters
+  example: Configure views, readers
+  level: intermediate
+- id: OTEL-004
+  name: LoggerProvider
+  category: OpenTelemetry
+  description: Factory for creating Loggers
+  example: Bridge existing logging frameworks
+  level: intermediate
+- id: OTEL-005
+  name: OTLP Exporter
+  category: OpenTelemetry
+  description: Export telemetry via OTLP
+  example: Send to collector or backend
+  level: beginner
+- id: OTEL-006
+  name: Collector
+  category: OpenTelemetry
+  description: Receive, process, export telemetry
+  example: Central pipeline for all signals
+  level: intermediate
+- id: OTEL-007
+  name: Collector Processors
+  category: OpenTelemetry
+  description: Transform telemetry in collector
+  example: batch, filter, attributes processors
+  level: advanced
+- id: OTEL-008
+  name: Semantic Conventions
+  category: OpenTelemetry
+  description: Standardized attribute names
+  example: http.method, db.system, rpc.service
+  level: intermediate
+- id: OTEL-009
+  name: Resource Attributes
+  category: OpenTelemetry
+  description: Describe the entity producing telemetry
+  example: service.name, host.id, cloud.provider
+  level: beginner
+- id: OTEL-010
+  name: Auto-Instrumentation
+  category: OpenTelemetry
+  description: Zero-code instrumentation
+  example: OTel agents for frameworks
+  level: beginner
+- id: OTEL-011
+  name: Manual Instrumentation
+  category: OpenTelemetry
+  description: Add custom spans/metrics
+  example: tracer.startSpan(), meter.createCounter()
+  level: intermediate
+- id: OTEL-012
+  name: Span Creation
+  category: OpenTelemetry
+  description: Create a unit of work trace
+  example: withSpan('operation', () => {})
+  level: beginner
+- id: OTEL-013
+  name: Span Attributes
+  category: OpenTelemetry
+  description: Add metadata to spans
+  example: span.setAttribute('user.id', userId)
+  level: beginner
+- id: OTEL-014
+  name: Span Events
+  category: OpenTelemetry
+  description: Add timestamped events to span
+  example: span.addEvent('cache_miss')
+  level: intermediate
+- id: OTEL-015
+  name: Span Links
+  category: OpenTelemetry
+  description: Connect related but non-parent traces
+  example: Batch processing links
+  level: advanced
+- id: OTEL-016
+  name: Span Status
+  category: OpenTelemetry
+  description: Mark span as ok/error
+  example: span.setStatus(StatusCode.ERROR)
+  level: beginner
+- id: OTEL-017
+  name: Context API
+  category: OpenTelemetry
+  description: Propagate context across async
+  example: Context.current(), with(context)
+  level: intermediate
+- id: OTEL-018
+  name: W3C TraceContext
+  category: OpenTelemetry
+  description: Standard trace propagation headers
+  example: traceparent, tracestate
+  level: intermediate
+- id: OTEL-019
+  name: Baggage
+  category: OpenTelemetry
+  description: Pass user-defined key-value pairs
+  example: tenant_id in baggage
+  level: intermediate
+- id: OTEL-020
+  name: Metrics Types
+  category: OpenTelemetry
+  description: Counter, UpDownCounter, Histogram, Gauge
+  example: Choose appropriate type
+  level: beginner
+- id: OTEL-021
+  name: Metric Views
+  category: OpenTelemetry
+  description: Customize metric aggregation
+  example: Drop attributes, change aggregation
+  level: advanced
+- id: OTEL-022
+  name: Exemplars
+  category: OpenTelemetry
+  description: Link metrics to traces
+  example: Trace context in histogram bucket
+  level: advanced
+- id: OTEL-023
+  name: OTel Bridge
+  category: OpenTelemetry
+  description: Connect existing instrumentation to OTel
+  example: OpenTracing/OpenCensus bridge
+  level: advanced
+- id: OTEL-024
+  name: SDK Configuration
+  category: OpenTelemetry
+  description: Environment-based config
+  example: OTEL_EXPORTER_OTLP_ENDPOINT
+  level: beginner
+- id: OTEL-025
+  name: Span Sampling
+  category: OpenTelemetry
+  description: Control which spans are recorded
+  example: ParentBased, TraceIdRatio
+  level: intermediate
+- id: OTEL-026
+  name: Batch Processing
+  category: OpenTelemetry
+  description: Batch telemetry before export
+  example: BatchSpanProcessor
+  level: intermediate
+- id: OTEL-027
+  name: Delta vs Cumulative
+  category: OpenTelemetry
+  description: Temporality for metrics
+  example: Delta for StatsD, Cumulative for Prometheus
+  level: advanced
+- id: OTEL-028
+  name: OTLP Protocol
+  category: OpenTelemetry
+  description: Binary protocol for telemetry
+  example: gRPC or HTTP/protobuf
+  level: intermediate
+- id: OTEL-029
+  name: SDK vs API
+  category: OpenTelemetry
+  description: Separation of concerns
+  example: Libraries use API, apps configure SDK
+  level: intermediate
+- id: OTEL-030
+  name: Zero-Dependency API
+  category: OpenTelemetry
+  description: No-op API for libraries
+  example: Instrumented libraries without SDK overhead
+  level: advanced