# Documentation Continuous Improvement - Quick Reference


**Last Updated:** 2025-11-20

## Daily Operations

### Health Check

```bash
python3 scripts/monitor-documentation-health.py --all
open docs/dashboard/index.html
```

### Performance Monitoring

```bash
python3 scripts/measure-rule-performance.py --report
```

### Debt Tracking

```bash
python3 scripts/track-documentation-debt.py --scan --summary
```

## Weekly Operations

### Generate Weekly Report

```bash
python3 scripts/generate-weekly-report.py
```

### Check Alerts

```bash
python3 scripts/alert-documentation-health.py
python3 scripts/alert-debt-backlog.py --weekly
```

## Monthly Operations

### Monthly Review

```bash
python3 scripts/monthly-documentation-review.py
```

### Generate Monthly Metrics

```bash
python3 scripts/generate-monthly-metrics.py
```

## Testing & Validation

### Run All Tests

```bash
python3 scripts/test-rule-structure.py
python3 scripts/test-documentation-consistency.py
python3 scripts/test-planning-system.py
python3 scripts/test-split-files.py
python3 scripts/validate-cross-references.py
```

### Quality Checks

```bash
python3 scripts/validate-documentation-style.py
python3 scripts/analyze-readability.py
python3 scripts/check-documentation-completeness.py
```

## Maintenance

### Auto-fix Issues (Dry Run)

```bash
python3 scripts/auto-fix-documentation-issues.py
```

### Auto-fix Issues (Apply)

```bash
python3 scripts/auto-fix-documentation-issues.py --apply
```

### Generate New Rule File

```bash
python3 scripts/generate-documentation-template.py --interactive
```

### Optimize Rules

```bash
python3 scripts/optimize-rule-files.py
```

## Quarterly/Annual

### Quarterly Analysis

```bash
python3 scripts/quarterly-optimization-analysis.py
```

### Annual Audit

```bash
python3 scripts/annual-documentation-audit.py
```

## Dashboards

- **Health:** `docs/dashboard/index.html`
- **Performance:** `docs/dashboard/performance.html`
- **Debt:** `docs/dashboard/debt.html`

## Reports Location

- **Health Reports:** `docs/metrics/documentation-health.json`
- **Performance Reports:** `docs/metrics/rule-performance-report.json`
- **Debt Backlog:** `docs/debt/backlog.json`
- **Weekly Reports:** `docs/reports/weekly-*.md`
- **Monthly Reviews:** `docs/reviews/review-*.md`

## CI/CD

- **Pre-commit:** Automatically runs on `git commit`
- **GitHub Actions:** Runs on PR/push (see `.github/workflows/documentation-checks.yml`)

## Key Metrics

- **Health Score Target:** >80/100
- **Planning Time:** <2 min (maintenance tasks)
- **Debt Backlog:** <10 high-priority items
- **File Size Limit:** <600 lines per rule file