daax-dev / daax-dev/agentic-retrospective

Claude-native telemetry: waste & efficiency detectors

Open
#39 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

enhancement
Dominant language
TypeScript
Stars
3
Forks
2
PR merge metrics
No merged PRs in 30d

Description

Problem

Counting tokens shows where the fire is, not why it started. A retrospective needs actionable, evidence-linked findings: specific patterns that wasted context or signalled inefficient collaboration, each with a remediation.

Capability

A registry of rule-based detectors over normalized turns that emit findings {detector, severity, evidence, estimatedWasteTokens?, dimension, remediation}. Each detector is a small pure function with configurable thresholds.

Initial detectors

Giant tool output; repeated file reads; tool/Bash overuse; thrash; error storm; retry storm; one-shot failure; skill over-firing; model substitution; cost outlier.

Behaviour

  • Interface Detector.run(stats, baseline?) => Finding[]; no I/O inside detectors.
  • Every finding cites sessionId + uuid (or toolUseId) — never a vague claim.
  • Configurable thresholds; conservative defaults; documented as uncalibrated on small samples.

Acceptance criteria

  • Each detector has a triggering and a non-triggering fixture (true/false-positive control).
  • Every finding carries a resolvable evidence reference.
  • Config changes (disable / threshold) change output deterministically.

Dimensions: Collaboration Efficiency, Quality & Maintainability, Delivery Predictability. Tier 3. Depends on #36, #37, #38. PRD: docs/prd/features/04-waste-efficiency-detection.md.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Read docs/prd/features/04-waste-efficiency-detection.md and review the contracts from dependencies #36, #37, and #38 before tracing normalized turns. Implement the Detector.run interface and initial detector registry with configurable thresholds, then use triggering and non-triggering fixtures to verify deterministic output and resolvable evidence references.

Written by the indexing model from the issue text.

Assessment

Tech stack
typescript
Domain
observability
Issue type
Feature
Difficulty
4/5
Estimated time
3-5 days
Activity status
Quiet
Clarity
Mostly clear
Newbie friendliness
48/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.