Observer Agent (v4.5, Addendum B)

Repo-aware suggestions from design + code.

Observer Agent connects to your GitHub repos and surfaces high-signal suggestions by cross-referencing design flows, coded flows, and codebase structure.

Suggestion types

  • Missing glue — Backend feature exists, no UI exposed (e.g. API endpoint with no user-facing flow)
  • Refactor / Consolidate — Overlapping flows or duplicate patterns across routes
  • Expose feature — Capability in code not surfaced in design or main flows
  • Debt reduction — Technical/UX debt that impacts flows

Observer Suggestions panel (Spec v4.5)

Each suggestion includes: Title (short, actionable), Type (e.g. missing_flow, refactor, expose_feature, debt_reduction), Evidence (linked flows/screens, file paths/routes, analytics if relevant), Description (why it matters), Proposed Action, Estimated Effort (low/medium/high), and optional related Blue Painter issue IDs.

List view supports filters by type, effort, and flow. You can copy to clipboard (for tickets), or mark as Accepted / Rejected / Done.

How to use

Connect GitHub in Settings. In Project Settings, add repos under Connected Repositories and choose role per repo (frontend, backend, design-system, mobile). Click Run Observer Analysis on the project (or use scheduled batch). Open the Observer Suggestions tab to view, filter, and act on suggestions.

Optional: Expert Review experts can see Observer suggestions, endorse or down-rank them, add commentary, and include them in the action plan.