maintenance

# Maintenance Skill

Consolidated repository maintenance utilities for auditing and cleanup.

## Commands

| Command | Purpose |
|---------|---------|
| `audit diataxis` | Check documentation follows Diataxis structure |
| `audit onboarding` | Verify onboarding docs exist and are complete |
| `audit workflow` | Validate workflow documentation |
| `cleanup deprecated` | Remove deprecated files and references |
| `cleanup docs` | Clean stale documentation |
| `cleanup plans` | Archive old plan files |
| `cleanup repo` | Full repository cleanup |

## Quick Reference

```bash
# Audit commands
/maintenance audit diataxis
/maintenance audit onboarding
/maintenance audit workflow

# Cleanup commands
/maintenance cleanup deprecated
/maintenance cleanup docs
/maintenance cleanup plans
/maintenance cleanup repo
```

## Audit: Diataxis

Check that documentation follows the Diataxis framework (tutorials, how-to, reference, explanation).

```bash
#!/bin/bash
# Check for Diataxis directories
for dir in tutorials how-to reference explanation; do
  if [ -d "docs/$dir" ]; then
    echo "✅ docs/$dir exists"
  else
    echo "❌ docs/$dir missing"
  fi
done

# Check for mixed content
grep -r "Step 1:" docs/reference/ && echo "⚠️ Tutorial content in reference/"
grep -r "API Reference" docs/tutorials/ && echo "⚠️ Reference content in tutorial/"
```

## Audit: Onboarding

Verify onboarding documentation is complete.

```bash
#!/bin/bash
REQUIRED_FILES=(
  "README.md"
  "docs/getting-started.md"
  "CONTRIBUTING.md"
)

for file in "${REQUIRED_FILES[@]}"; do
  [ -f "$file" ] && echo "✅ $file" || echo "❌ $file missing"
done
```

## Audit: Workflow

Validate workflow documentation matches actual workflows.

```bash
#!/bin/bash
# Check for documented workflows
ls .github/workflows/*.yml 2>/dev/null | while read wf; do
  name=$(basename "$wf" .yml)
  grep -q "$name" docs/ && echo "✅ $name documented" || echo "❌ $name undocumented"
done
```

## Cleanup: Deprecated

Remove files marked as deprecate