Skip to main content

Architecture Agents

feature-flags​

Category: architecture

Wraps features from the last 30 days of commits in feature flags for safe rollout and instant rollback.

Process:

  1. Analyzes git log --since=30.days to identify new features
  2. For each feature, wraps the code path in a flag check
  3. Adds the flag to your feature flag config (environment variable, LaunchDarkly, Statsig, or a simple JSON config file)
  4. Adds a test that verifies the feature is disabled when the flag is off

When a flag is off, the code takes the previous code path (or returns a safe default). This means you can disable any feature introduced in the last 30 days without a rollback deployment.

nimbus run --agent feature-flags

observability-agent​

Category: architecture

Adds structured logging, metrics, and tracing to the service layer.

What it adds:

  • Structured logging — replaces print() and unstructured logger.info("string") with structured log calls (logger.info("user.created", user_id=user.id, email=user.email))
  • OpenTelemetry tracing — adds span creation at service boundaries (HTTP handlers, database calls, external API calls)
  • Metrics — adds counters and histograms for request counts, latency, and error rates

Follows the OpenTelemetry SDK conventions. Works with Python (opentelemetry-sdk) and TypeScript (@opentelemetry/sdk-node).

nimbus run --agent observability-agent