path: root/PRE-WEEK3-CHECKLIST.md

# Pre-Week 3 Checklist

## ✅ Branching Policy Implementation Complete

Before you start Week 3, verify everything is in place:

### Documentation Review

- [ ] Read `BRANCHING-POLICY.md` (5-10 min)
  - Understand why weekly branching
  - Understand branch naming convention
  - Understand merge workflow

- [ ] Review `GIT-WORKFLOW-QUICK-REF.md` (2-3 min)
  - Common commands reference
  - Have it nearby during development

- [ ] Keep `GIT-WORKFLOW.md` handy
  - Reference when needed
  - Complete guide with examples

### Project Files Updated

- [ ] `CLAUDE.md` — Work protocol now includes branching requirement
- [ ] `WEEK3-START.md` — Branching instructions before Week 3 tasks
- [ ] `WEEKS1-2-SUMMARY.md` — Week 3+ branching workflow documented
- [ ] `PROGRESS-STATUS.txt` — Branching requirement noted
- [ ] `memory/MEMORY.md` — Index updated with GIT-WORKFLOW reference

### Ready to Start Week 3

- [ ] Understand the branching requirement
- [ ] Ready to create `week-3-cards-nav` branch
- [ ] Ready to commit regularly with clear messages
- [ ] Ready to test thoroughly before merging
- [ ] Ready to merge back to master at end of week

---

## Week 3 Startup Steps

### 1. Create Feature Branch

```bash
git checkout -b week-3-cards-nav
```

Verify:
```bash
git branch -v
# Should show:
#   master          abc1234 message
# * week-3-cards-nav abc1234 message
```

### 2. Start Development

```bash
# Work on Week 3 tasks:
# - Article cards
# - Navigation header
# - Hamburger menu
# - Breadcrumbs

# After each component:
npm run build
hugo server
git commit -m "feat: add component description"
```

### 3. Daily Progress

Update memory if working across multiple sessions:
```bash
cat > /path/to/memory/week3_progress.md << 'EOF'
# Week 3 Progress

**Date:** 2026-04-17
**Status:** In progress (Day 1)

## Completed
- [x] Article cards
- [ ] Navigation header
- [ ] Hamburger menu
- [ ] Breadcrumbs
EOF

git add memory/week3_progress.md
git commit -m "docs: update week 3 progress"
```

### 4. End of Week

```bash
# Review all changes
git diff master..week-3-cards-nav
git diff --stat master..week-3-cards-nav

# Test thoroughly
# - Dark mode: all pages
# - Light mode: toggle on each page
# - Mobile (320px), Tablet (768px), Desktop (1060px+)
# - Keyboard navigation (Tab, Shift+Tab, Enter, Space, Escape)
# - All interactive components (buttons, menus, forms)
# - CSS build: npm run build (no errors)
# - Browser console: no errors

# View commits
git log master..week-3-cards-nav --oneline

# Merge to master
git checkout master
git merge week-3-cards-nav

# Delete feature branch
git branch -d week-3-cards-nav

# Verify merge
git log --oneline -5
```

---

## Documentation Structure

```
Quick Start
  └─ BRANCHING-POLICY.md (read first)

During Development
  ├─ GIT-WORKFLOW-QUICK-REF.md (reference)
  ├─ WEEK3-START.md (Week 3 tasks)
  └─ GIT-WORKFLOW.md (detailed guide)

Project Requirements
  ├─ CLAUDE.md (work protocol, includes branching)
  └─ WEEKS1-2-SUMMARY.md (how to continue pattern)
```

---

## Key Commands

```bash
# Create branch
git checkout -b week-3-cards-nav

# Check status
git status

# View changes
git diff

# Stage files
git add <file>

# Commit
git commit -m "feat: description"

# View history
git log --oneline -10
git log master..week-3-cards-nav --oneline

# Review before merge
git diff master..week-3-cards-nav
git diff --stat master..week-3-cards-nav

# Merge
git checkout master
git merge week-3-cards-nav

# Delete branch
git branch -d week-3-cards-nav
```

---

## Testing Checklist

Before merging to master, verify:

### Dark Mode
- [ ] Homepage displays correctly
- [ ] All components styled
- [ ] Text readable
- [ ] No missing styles

### Light Mode
- [ ] Toggle theme works
- [ ] All components styled
- [ ] Text readable
- [ ] No color issues

### Responsive
- [ ] Mobile (320px): Single column, readable
- [ ] Tablet (768px): Layout adjusts appropriately
- [ ] Desktop (1060px+): Full layout, sidebar visible

### Interactive
- [ ] Buttons work on click
- [ ] Menus open/close
- [ ] Links clickable
- [ ] Focus states visible on all interactive elements
- [ ] Tab navigation works
- [ ] Escape key closes modals/menus

### Quality
- [ ] CSS builds: `npm run build` (no errors, <200ms)
- [ ] No console errors: Check DevTools → Console
- [ ] No hard-coded colors in CSS
- [ ] Git history is clean: `git log --oneline`

---

## When in Doubt

1. Read `BRANCHING-POLICY.md` (answers most questions)
2. Check `GIT-WORKFLOW.md` FAQ section
3. Reference `GIT-WORKFLOW-QUICK-REF.md` for commands
4. Look at examples in `GIT-WORKFLOW.md`

---

## Summary

✅ Policy documented  
✅ Integration complete  
✅ References provided  
✅ Examples included  
✅ Ready for Week 3  

You're all set to start Week 3 with weekly branching! 🚀