Skip to main content

Activity Dashboard 2.0 - Design Package Index

Version: 2.0 Date: November 27, 2025 Status: Final Design Package

Quick Navigation​

Start Here​

📄 2025-11-27-DESIGN-UPDATE-V2.0.md Master design update document Comprehensive overview of 2.0 changes, key stakeholder insights, and implementation roadmap based on Will-Hal design review meeting.

Design Documentation​

Core Architecture Documents​

  1. SDD-Activity-Dashboard.md (48KB)

    • Software Design Document
    • System architecture overview
    • Data model and entity relationships
    • Database schema
    • API specifications
    • Complete TypeScript interfaces

  2. TDD-Activity-Dashboard.md (40KB)

    • Technical Design Document
    • Task linking algorithms (Session→Task, Commit→Task)
    • Progress calculation implementation
    • Activity feed prioritization logic
    • Real-time update mechanisms
    • Caching strategies

  3. ADRs-Activity-Dashboard.md (19KB)

    • Architecture Decision Records
    • 8 key ADRs with rationale:
      • ADR-001: Task-Centric Architecture
      • ADR-002: Checkbox as Source of Truth
      • ADR-003: Exception-Based Display
      • ADR-004: Session-to-Task Linking
      • ADR-005: Real-Time Updates
      • ADR-006: Three-Level Hierarchy
      • ADR-007: Activity Feed Prioritization
      • ADR-008: Multi-Project Portfolio

UI & Component Specifications​

  1. UI-Prompts-Activity-Dashboard.md (32KB)

    • Individual UI component prompts
    • 8 components with detailed specifications:
      1. ProjectSummaryBar
      2. KanbanBoard
      3. TaskCard
      4. ActivityFeed
      5. BlockerPanel
      6. WorkDistributionChart
      7. ProjectSelector
      8. Unified Dashboard Layout
    • Sample data for each component
    • Usage notes for AI UI generators

  2. activity-dashboard-design-spec.md (38KB)

    • Complete design specification
    • Navigation metaphor (GPS vs Engine)
    • Multi-project architecture
    • Data transformation pipeline
    • Mermaid diagrams for all flows
    • UI layout ASCII mockups

Integrated Design​

  1. MULTI-PROJECT-DASHBOARD-DESIGN.md (41KB)
    • Complete integrated design package
    • Combines SDD + TDD + ADRs + UI specs
    • 7-part comprehensive document:
      • Part 1: Executive Summary
      • Part 2: Design Philosophy
      • Part 3: Software Design Document
      • Part 4: Technical Design Document
      • Part 5: Architecture Decision Records
      • Part 6: UI Component Specifications
      • Part 7: Implementation Guide

Meeting Documentation​

  1. MEETING-TRANSCRIPT-2025-11-27-WILL-HAL.txt (19KB)
    • Full transcript of design review meeting
    • Will and Hal discussion (November 27, 2025, 10:40 AM)
    • Key stakeholder quotes and insights
    • Design decisions and rationale in context

Document Relationships​

2025-11-27-DESIGN-UPDATE-V2.0.md (Master Overview)
    │
    ├─── References: MEETING-TRANSCRIPT-2025-11-27-WILL-HAL.txt
    │    └─── Key quotes and design insights
    │
    ├─── Integrates: SDD-Activity-Dashboard.md
    │    └─── System architecture, data model
    │
    ├─── Integrates: TDD-Activity-Dashboard.md
    │    └─── Algorithms, implementation details
    │
    ├─── Integrates: ADRs-Activity-Dashboard.md
    │    └─── Design decisions with rationale
    │
    ├─── Integrates: UI-Prompts-Activity-Dashboard.md
    │    └─── Component specifications
    │
    └─── Consolidates: MULTI-PROJECT-DASHBOARD-DESIGN.md
         └─── All-in-one reference document

activity-dashboard-design-spec.md
    └─── Complete specification with visual diagrams

Reading Paths​

For Product Managers / Stakeholders​

Quick Start (15 minutes):

  1. Read: 2025-11-27-DESIGN-UPDATE-V2.0.md - Sections 1-3
    • Executive Summary
    • Key Design Insights
    • Design Philosophy

Deep Dive (45 minutes): 2. Read: MEETING-TRANSCRIPT-2025-11-27-WILL-HAL.txt

  • Understand stakeholder requirements
  • See design evolution discussion
  1. Read: activity-dashboard-design-spec.md - Sections 1-4
    • Visual diagrams and mockups
    • Navigation metaphor
    • UI layout

For Developers / Engineers​

Quick Start (20 minutes):

  1. Read: 2025-11-27-DESIGN-UPDATE-V2.0.md - Sections 4-5
    • Data Model
    • API Design
    • Implementation Roadmap
  2. Skim: TDD-Activity-Dashboard.md - Code Examples
    • Linking algorithms
    • Progress calculation

Deep Dive (2 hours): 3. Read: SDD-Activity-Dashboard.md

  • Complete system architecture
  • Database schema
  • TypeScript interfaces
  1. Read: TDD-Activity-Dashboard.md
    • All implementation details
    • Real-time update logic
    • Caching strategies
  2. Reference: ADRs-Activity-Dashboard.md
    • Understand "why" behind decisions

For UI/UX Designers​

Quick Start (20 minutes):

  1. Read: 2025-11-27-DESIGN-UPDATE-V2.0.md - Section 2
    • Key Design Insights (GPS metaphor)
    • Three-Level Hierarchy
    • 5-Second Test
  2. View: activity-dashboard-design-spec.md - UI Layout
    • ASCII mockups
    • Component structure

Deep Dive (1.5 hours): 3. Read: UI-Prompts-Activity-Dashboard.md

  • All 8 component specifications
  • Sample data
  • Styling guidelines
  1. Reference: ADRs-Activity-Dashboard.md
    • ADR-003: Exception-Based Display
    • ADR-006: Three-Level Hierarchy

For AI/LLM Developers​

Quick Start (15 minutes):

  1. Read: TDD-Activity-Dashboard.md - Section 4.1
    • Task Linking Algorithms
    • Session-to-Task matching
  2. Read: ADRs-Activity-Dashboard.md
    • ADR-004: Session-to-Task Linking

Deep Dive (1 hour): 3. Read: SDD-Activity-Dashboard.md - Data Model

  • Linking tables schema
  • Confidence scoring
  1. Review: Python code examples in TDD

Key Concepts by Document​

Design Philosophy​

  • GPS Navigation Metaphor: 2025-11-27-DESIGN-UPDATE-V2.0.md, activity-dashboard-design-spec.md
  • Exception-Based Display: ADRs-Activity-Dashboard.md (ADR-003), 2025-11-27-DESIGN-UPDATE-V2.0.md
  • Task-Centric Architecture: All documents
  • Three-Level Hierarchy: activity-dashboard-design-spec.md, ADRs-Activity-Dashboard.md (ADR-006)

Technical Implementation​

  • Linking Algorithms: TDD-Activity-Dashboard.md (Section 4.1), SDD-Activity-Dashboard.md
  • Progress Calculation: TDD-Activity-Dashboard.md (Section 4.2), ADRs-Activity-Dashboard.md (ADR-002)
  • Real-Time Updates: TDD-Activity-Dashboard.md (Section 4.4), ADRs-Activity-Dashboard.md (ADR-005)
  • Caching Strategy: TDD-Activity-Dashboard.md (Section 4.5)

UI Components​

  • Complete Prompts: UI-Prompts-Activity-Dashboard.md
  • Layout Specifications: activity-dashboard-design-spec.md (Section 11), MULTI-PROJECT-DASHBOARD-DESIGN.md (Part 6)
  • Component Props: SDD-Activity-Dashboard.md (TypeScript interfaces)

Data Architecture​

  • Database Schema: SDD-Activity-Dashboard.md (Section 3.2), MULTI-PROJECT-DASHBOARD-DESIGN.md (Part 3)
  • API Endpoints: SDD-Activity-Dashboard.md (Section 3.3), 2025-11-27-DESIGN-UPDATE-V2.0.md
  • WebSocket Events: SDD-Activity-Dashboard.md, TDD-Activity-Dashboard.md

File Sizes & Estimated Reading Times​

DocumentSizeRead TimeType
2025-11-27-DESIGN-UPDATE-V2.0.md19KB20 minOverview
SDD-Activity-Dashboard.md48KB45 minArchitecture
TDD-Activity-Dashboard.md40KB40 minTechnical
ADRs-Activity-Dashboard.md19KB20 minDecisions
UI-Prompts-Activity-Dashboard.md32KB30 minUI Specs
activity-dashboard-design-spec.md38KB35 minComplete Spec
MULTI-PROJECT-DASHBOARD-DESIGN.md41KB50 minIntegrated
MEETING-TRANSCRIPT-2025-11-27-WILL-HAL.txt19KB25 minTranscript
TOTAL256KB~4.5 hoursFull Package

Version History​

Version 2.0 (November 27, 2025)​

  • Complete redesign based on Will-Hal design review
  • Shifted from session-centric to task-centric architecture
  • Implemented GPS navigation metaphor
  • Added exception-based display principle
  • Introduced three-level information hierarchy
  • Created comprehensive linking algorithms
  • Designed 8 core UI components
  • Established 8 architecture decision records

Version 1.0 (November 26, 2025)​

  • Initial activity board design
  • Session-based metrics focus
  • Single-project view

Existing Dashboard Documentation:

POC Implementations:

  • poc/ - Proof of concept implementations

Usage Guidelines​

For Implementation​

  1. Start with Data Model

    • Reference: SDD-Activity-Dashboard.md (Section 3.2)
    • Implement: Database schema with task checkboxes as source of truth

  2. Build Core Components

    • Reference: UI-Prompts-Activity-Dashboard.md
    • Implement: Following component specifications and sample data

  3. Implement Linking

    • Reference: TDD-Activity-Dashboard.md (Section 4.1)
    • Implement: Session→Task and Commit→Task linking algorithms

  4. Add Real-Time

    • Reference: TDD-Activity-Dashboard.md (Section 4.4), ADRs-Activity-Dashboard.md (ADR-005)
    • Implement: WebSocket infrastructure

For Design Decisions​

  1. Consult ADRs First

    • All major decisions documented in ADRs-Activity-Dashboard.md
    • Each ADR includes context, decision, and consequences

  2. Check Stakeholder Intent

    • Review: MEETING-TRANSCRIPT-2025-11-27-WILL-HAL.txt
    • Understand: Original requirements and priorities

  3. Follow Design Principles

    • Exception-based display
    • Task-centric architecture
    • Three-level hierarchy
    • 5-second test

Support & Questions​

For questions about:

  • Design Philosophy: See MEETING-TRANSCRIPT or contact Will
  • Technical Implementation: See TDD-Activity-Dashboard.md or contact development team
  • UI Components: See UI-Prompts-Activity-Dashboard.md or contact design team
  • Architecture Decisions: See ADRs-Activity-Dashboard.md

Quick Reference: Key Stakeholder Quotes​

"The gold isn't in how is it doing it... the real stuff is features, deliverables, targets reached."

"What you want is: How do I get from A to B? What are my obstacles? And what's my route?"

"If it's 40, 40, 40, 40, 40 every time, don't show it."

"Actual information on a non-scrolling screen."

"Sessions are segments of the journey... we need to connect them into the map."

"A Kanban board has value because you can see features moving from left to right."

Source: MEETING-TRANSCRIPT-2025-11-27-WILL-HAL.txt

Last Updated: November 27, 2025 Document Owner: Design Team Status: Final - Ready for Implementation