Activity

Summary

This PR proposes an Architecture Decision Record (ADR) for building a Living Resume System - a dynamic, proof-backed CV generator that differentiates Progress from traditional portfolio sites.

The Vision

Traditional CV: "I have 10+ years experience with Laravel" Our CV: Live GitHub heatmap showing 847 Laravel commits this month, links to actual code

Features Proposed

1. Living Resume (/cv)

• Live Stats - Real numbers from GitHub activity
• Skills with Proof - Each skill links to actual commits and repos
• Job Spec Tailoring - Paste a job spec, system matches your data to requirements
• Match Score - Visual indicator of how well you fit the role
• PDF/TXT Export - For traditional workflows

2. Repository Overview Tab

• Tech Stack - Auto-detected from package files
• README Preview - With expand option
• Project Patterns - Detected (Actions pattern, MCP integration, etc.)
• Timeline - Key milestones (first commit, busiest week, latest)
• Dependencies - Parsed from composer.json/package.json

Key Design Decisions

1. No AI Required - Dictionary-based keyword matching + database queries against actual activity data. Gets 90% of the value with 10% of the complexity.

2. Confidence Scoring - Skills rated by: repos count (30%), total commits (40%), recent commits (30%)

3. Four Implementation Phases:

   • Phase 1: Foundation (Profile + Base CV)
   • Phase 2: Repository Overview Tab
   • Phase 3: Resume Tailoring Engine
   • Phase 4: Export & Polish

Files Changed

• docs/adr/001-living-resume-system.md - Full ADR document

Review Requested

Please review the proposed architecture and provide feedback on:

• Database schema design
• Keyword matching approach (no AI vs AI-enhanced)
• Phase ordering
• Any concerns or suggestions

---

🤖 Generated with Claude Code