Skip to content

nWave-ai/nWave / nWave/skills/nw-investigation-techniques

nw-investigation-techniques

Verified

Evidence collection methods, problem categorization, analysis techniques, and solution design patterns

Investigation Techniques

Problem Categorization

Technical Problems

CategorySub-CategoryCommon Symptoms
System FailuresApp crashes, memory leaks, deadlocks, data corruptionService unavailability, resource exhaustion, integrity errors
System FailuresHardware, network, database, securityConnectivity loss, capacity limits, access failures
PerformanceResponse time: slow queries, latency, algorithmic inefficiencyHigh p95/p99, user-reported slowness
PerformanceThroughput: thread pool exhaustion, connection limits, queue backlogReduced capacity, growing queues
IntegrationInternal: component comms, data format, version conflictsInterface errors, serialization failures
IntegrationExternal: third-party availability, API changes, auth failuresTimeouts, contract violations

Operational Problems

CategoryCommon Symptoms
Deployment: script failures, config drift, migration errorsFailed releases, environment inconsistencies
Monitoring: alerting gaps, backup failures, incident responseMissed incidents, slow recovery
Human factors: communication gaps, knowledge silos, skill gapsRepeated mistakes, slow onboarding

Evidence Collection

Technical Evidence Sources

Logs: application (timestamp correlation) | system/infrastructure | database | network traces

Metrics: performance/resource utilization | error rates/response time trends | user behavior/transaction patterns | infrastructure health/capacity

Configuration: system/deployment settings | code changes/VCS history (git log, blame) | env vars/dependencies | security/access controls

Evidence Validation

  1. Cross-reference: verify from multiple independent sources
  2. Timestamp validation: confirm event sequence accuracy
  3. Completeness check: identify data gaps/corruption
  4. Correlation vs causation: distinguish co-occurrence from causation

Analysis Techniques

Quantitative

  • Trend: time series of metrics, error pattern frequency
  • Distribution: response time percentiles, error rate across components
  • Pattern recognition: log anomalies, behavior patterns, error clustering

Qualitative

  • Timeline reconstruction: detailed incident timeline, correlate changes with symptoms
  • Process analysis: workflow disruptions, communication flow, decision chains
  • Environmental: recent changes, system load, external factors, related incidents

Solution Design Patterns

Immediate Mitigations (restore service)

Quick fixes | workarounds to minimize impact | emergency procedures | monitoring enhancements

Permanent Fixes (prevent recurrence)

Architecture modifications | code quality/defensive programming | config management/environment consistency | testing/validation improvements

Early Detection (catch faster)

Leading indicators | anomaly detection/predictive alerting | automated quality gates | threshold tuning from learnings

Solution Prioritization Matrix

PriorityCriteriaAction
P0Active incident, users impactedImmediate mitigation, hours
P1Root cause fix for recurring issuePermanent fix, current sprint
P2Prevention for potential issuesNext sprint
P3Systemic improvementBacklog with evidence
brainstormingobra/superpowersYou MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or planning anything new, in software or out of it (a talk, a business, a renovation).Stars: 322kUpdated Claude CodeCodexVerifiedInstall
brand-guidelinesanthropics/skillsApplies Anthropic's official brand colors and typography to any sort of artifact that may benefit from having Anthropic's look-and-feel. Use it when brand colors or style guidelines, visual formatting, or company design standards apply.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
frontend-designanthropics/skillsGuidance for distinctive, intentional visual design when building new UI or reshaping an existing one. Helps with aesthetic direction, typography, and making choices that don't read as templated defaults.Stars: 198kUpdated Claude CodeCodexVerifiedInstall
mcp-builderanthropics/skillsGuide for creating high-quality MCP (Model Context Protocol) servers that enable LLMs to interact with external services through well-designed tools. Use when building MCP servers to integrate external APIs or services, whether in Python (FastMCP) or Node/TypeScript (MCP SDK).Stars: 198kUpdated Claude CodeCodexVerifiedInstall