How razi2001/brief works
Brief is a browser-extension and web service for capturing bug evidence, generating a ticket, and filing it to an issue tracker. The central workflow runs from extension capture and draft editing through upload, server-side transcription and ticket composition, then tracker filing and ticket review. Replay capture and team workflows are additional product branches. Edges reflect README claims and the supplied excerpts/index; unsampled implementation details are represented only at supported directory scope.
Main entry points: background.js Extension worker · popup.js Capture popup · cloud.js Cloud client · process-brief.ts Ticket processing
Components 26
Extension capture
- Capture popup
extension/popup.js - Extension worker
extension/background.js - Draft state
extension/draft.js - Evidence files
extension/filestore.js - Evidence editor
extension/editor/shot-editor.js - Tab capture
extension/page-capture.js - Replay site rules
extension/replay-sites.js - Replay capture
extension/replay.js - Replay assets
extension/replay-store.js - Cloud client
extension/cloud.js
Brief service
- Brief API
web/app/api/briefs/route.ts - Transcription API
web/app/api/transcribe/route.ts - Ticket processing
web/lib/agent/process-brief.ts - Evidence context
web/lib/agent/context-block.ts - Speech transcription
web/lib/agent/transcribe.ts - Brief storage
web/lib/agent/brief-store.ts - Tracker filing
web/lib/brief-filing.ts
Tracker integrations
- Tracker adapters
web/lib/trackers/registry.ts - Issue trackers
Web app
- Setup wizard
web/components/Onboarding.tsx - Tracker connections
web/components/useTrackerConnect.ts - Ticket views
web/components/BriefPage.tsx - Replay player
web/components/ReplayPlayer.tsx - Team workflows
web/app/(main)/competition/page.tsx
Other components
- Reporter
- Web user
Connections 28
- Reporter → Capture popup: captures bug
- Capture popup → Draft state: updates draft
extension/popup.js - Capture popup → Evidence files: stores evidence
extension/popup.js - Capture popup → Cloud client: transcribes note
extension/popup.js - Extension worker → Draft state: updates draft
extension/background.js - Extension worker → Evidence files: stores captures
extension/background.js - Extension worker → Tab capture: captures tab
extension/background.js - Extension worker → Replay site rules: checks rules
extension/background.js - Extension worker → Tracker filing: files brief
extension/background.js - Evidence editor → Evidence files: saves edits
- Replay site rules → Cloud client: fetches site rules
extension/replay-sites.js - Replay capture → Replay assets: stores replay
- Reporter → Evidence editor: edits evidence
- Cloud client → Brief API: creates brief
extension/cloud.js - Cloud client → Transcription API: sends audio
extension/cloud.js - Brief API → Brief storage: persists brief
- Transcription API → Speech transcription: transcribes audio
- Ticket processing → Evidence context: builds context
web/lib/agent/context-block.ts - Evidence context → Speech transcription: uses transcript
web/lib/agent/context-block.ts - Ticket processing → Brief storage: loads brief
- Ticket processing → Tracker filing: composes ticket
- Tracker filing → Tracker adapters: selects adapter
- Tracker adapters → Issue trackers: files ticket
- Web user → Setup wizard: sets up account
- Setup wizard → Tracker connections: connects tracker
web/components/Onboarding.tsx - Web user → Ticket views: reviews ticket
- Web user → Replay player: views replay
- Web user → Team workflows: joins team activity