# Weekly Report

> Haftalık proje ilerleme raporu. Git stats, feature completion, bug trends, agent usage. progress-tracker agent tarafından kullanılır.

- Skill: `erhankaraarslan/weekly-report` (Agent Skill)
- Install (CLI): `npx skillmds@latest add erhankaraarslan/weekly-report`
- Raw SKILL.md: https://api.skillmd.com/api/skills/erhankaraarslan/weekly-report/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: erhankaraarslan (https://skillmd.com/u/erhankaraarslan)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/erhankaraarslan/weekly-report

---


# Weekly Report Skill

Bu skill, progress-tracker agent'ın haftalık ilerleme raporu oluşturması için kullanılır.

---

## 📊 Rapor Bölümleri

### 1. Git Activity

```bash
# Son 7 gündeki commit sayısı
git log --since="7 days ago" --oneline | wc -l

# Commit'lerin dağılımı
git log --since="7 days ago" --format="%ad" --date=short | sort | uniq -c

# En aktif dosyalar
git log --since="7 days ago" --name-only --pretty=format: | sort | uniq -c | sort -rn | head -10

# Contributor listesi
git log --since="7 days ago" --format="%an" | sort | uniq -c | sort -rn
```

---

### 2. Feature Progress

```bash
# feature-list.json'dan istatistikler
cat feature-list.json | jq '{
  total: .total_features,
  completed: .completed_features,
  in_progress: [.features[] | select(.status == "in_progress")] | length,
  blocked: [.features[] | select(.status == "blocked")] | length,
  completion_rate: (.completed_features / .total_features * 100 | round)
}'

# Bu hafta tamamlanan feature'lar
cat feature-list.json | jq '.features[] | select(
  .completed_at >= (now - 7*24*60*60 | strftime("%Y-%m-%d"))
) | {id, title, completed_at}'

# Priority distribution
cat feature-list.json | jq '[.features[] | select(.status != "completed")] | group_by(.priority) | map({priority: .[0].priority, count: length})'
```

---

### 3. Code Quality Metrics

```bash
# Test coverage trend (eğer coverage report varsa)
if [ -f coverage/coverage-summary.json ]; then
  cat coverage/coverage-summary.json | jq '.total | {
    lines: .lines.pct,
    statements: .statements.pct,
    functions: .functions.pct,
    branches: .branches.pct
  }'
fi

# Lint issues
npm run lint 2>&1 | grep -E "warning|error" | wc -l

# File count ve lines of code
find src -name "*.ts" -o -name "*.js" | wc -l
find src -name "*.ts" -o -name "*.js" | xargs wc -l | tail -1
```

---

### 4. Agent Usage Statistics

```bash
# agent-metrics.json'dan özet
cat agent-metrics.json | jq '.agents | to_entries | map({
  agent: .key,
  tasks: .value.tasks_completed,
  avg_duration: .value.avg_duration_minutes,
  last_used: .value.last_used
}) | sort_by(-.tasks)'

# En aktif agent'lar
cat agent-metrics.json | jq '.agents | to_entries | map(select(.value.tasks_completed > 0)) | sort_by(-.value.tasks_completed) | .[0:5]'
```

---

### 5. Bug & Issue Tracking

```bash
# Son 7 gündeki bug count (eğer GitHub kullanıyorsa)
gh issue list --label bug --state all --created ">=$(date -v-7d +%Y-%m-%d)" --json number,title,state | jq 'length'

# Critical issues
gh issue list --label "priority:high" --state open --json number,title

# Error log analizi
if [ -f ~/.claude/error-log.txt ]; then
  tail -n 1000 ~/.claude/error-log.txt | grep "$(date -v-7d +%Y-%m-%d)" | wc -l
fi
```

---

### 6. Velocity Metrics

```bash
# Feature completion rate (son 4 hafta)
for week in 1 2 3 4; do
  start=$(date -v-${week}w -v-mon +%Y-%m-%d)
  end=$(date -v-${week}w -v+sun +%Y-%m-%d)
  count=$(cat feature-list.json | jq "[.features[] | select(.completed_at >= \"$start\" and .completed_at <= \"$end\")] | length")
  echo "Week -$week: $count features"
done

# Avg sessions per feature
cat feature-list.json | jq '[.features[] | select(.passes == true) | .actual_sessions] | add / length'
```

---

## 📝 Rapor Formatı

### Markdown Template

```markdown
# 📊 Weekly Report - Week of [TARIH]

## Executive Summary

- **Features Completed:** X
- **Active Development:** Y features
- **Code Quality:** Z% test coverage
- **Velocity:** W features/week

---

## 🎯 Feature Progress

### Completed This Week
- [F001] User Registration ✅
- [F002] Login System ✅

### In Progress
- [F003] Profile Management (60%)
- [F004] Password Reset (30%)

### Blocked
- [F005] OAuth Integration (waiting for API keys)

---

## 📈 Metrics

| Metric | This Week | Last Week | Trend |
|--------|-----------|-----------|-------|
| Commits | 45 | 38 | ⬆️ +18% |
| Features | 3 | 2 | ⬆️ +50% |
| Test Coverage | 78% | 75% | ⬆️ +3% |
| Bugs Found | 2 | 5 | ⬇️ -60% |

---

## 🤖 Agent Activity

| Agent | Tasks | Avg Duration | Most Used |
|-------|-------|--------------|-----------|
| backend-developer | 12 | 25min | ⭐ |
| qa-engineer | 8 | 15min | |
| architect | 3 | 45min | |

---

## 🔥 Highlights

- ✅ Completed user authentication flow
- ✅ Achieved 78% test coverage
- ⚠️ Database migration pending review

---

## 📅 Next Week Goals

- [ ] Complete profile management (F003)
- [ ] Implement password reset (F004)
- [ ] Increase test coverage to 80%
- [ ] Resolve OAuth blocker (F005)

---

**Report Generated:** [TIMESTAMP]
**By:** progress-tracker agent
```

---

## 🎨 Visualization (Optional)

### Velocity Chart (Mermaid)

```mermaid
xychart-beta
  title "Feature Completion Velocity"
  x-axis [Week-4, Week-3, Week-2, Week-1]
  y-axis "Features" 0 --> 10
  line [2, 3, 4, 3]
```

### Priority Distribution

```mermaid
pie title "Feature Priority Distribution"
  "P0 Critical" : 2
  "P1 High" : 5
  "P2 Medium" : 8
  "P3 Low" : 3
```

---

## 🔧 Kullanım

### Manual Report Generation

```bash
# progress-tracker agent'ı çağır
/weekly-report
```

### Automated Weekly Report

Cron job veya GitHub Actions ile:

```yaml
# .github/workflows/weekly-report.yml
name: Weekly Report
on:
  schedule:
    - cron: '0 9 * * 1'  # Her Pazartesi 09:00
jobs:
  report:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - name: Generate Report
        run: |
          # progress-tracker agent'ı tetikle
          echo "Weekly report generation"
```

---

## 📊 Trend Analysis

### Feature Completion Trend

```bash
# Son 8 haftanın completion rate'i
for i in {1..8}; do
  week_start=$(date -v-${i}w -v-mon +%Y-%m-%d)
  week_end=$(date -v-${i}w -v+sun +%Y-%m-%d)
  completed=$(cat feature-list.json | jq "[.features[] | select(.completed_at >= \"$week_start\" and .completed_at <= \"$week_end\")] | length")
  echo "Week -$i: $completed"
done | gnuplot -e "set term dumb; plot '-' with lines"
```

### Agent Efficiency Trend

```bash
# Agent başına ortalama süre değişimi
cat agent-metrics.json | jq '.agents | to_entries | map({
  agent: .key,
  efficiency: (if .value.avg_duration_minutes > 0 then .value.tasks_completed / .value.avg_duration_minutes else 0 end)
}) | sort_by(-.efficiency)'
```

---

## 🎯 KPI'lar (Key Performance Indicators)

| KPI | Target | Current | Status |
|-----|--------|---------|--------|
| Features/Week | 3 | 3 | ✅ On Track |
| Test Coverage | 80% | 78% | ⚠️ Near Target |
| Bug Backlog | <5 | 3 | ✅ Healthy |
| Deployment Frequency | 2/week | 2 | ✅ On Track |
| MTTR (Mean Time To Repair) | <2h | 1.5h | ✅ Excellent |

---

## 📧 Report Distribution

Raporu Slack'e gönder:

```bash
# Slack MCP ile
curl -X POST https://hooks.slack.com/services/YOUR/WEBHOOK/URL \
  -H 'Content-Type: application/json' \
  -d '{
    "text": "📊 Weekly Report Ready!",
    "attachments": [{
      "title": "Week of 2026-01-26",
      "text": "Features: 3 completed, 2 in progress",
      "color": "good"
    }]
  }'
```

---

## 🔗 Related Skills

- **feature-tracking** - Feature verileri
- **monitoring** - Production metrics
- **error-recovery** - Error trends
- **incremental-coding** - Session stats

---

## 📚 Örnek Komutlar

```bash
# Tam rapor oluştur
/weekly-report full

# Sadece feature özeti
/weekly-report features

# Agent metrics
/weekly-report agents

# Velocity trend
/weekly-report velocity
```

---

**Son Güncelleme:** 2026-01-26
**Kullanıcı:** progress-tracker agent
**Frequency:** Haftalık (Pazartesi sabahları)