diff options
Diffstat (limited to 'PRE-WEEK3-CHECKLIST.md')
| -rw-r--r-- | PRE-WEEK3-CHECKLIST.md | 233 |
1 files changed, 233 insertions, 0 deletions
diff --git a/PRE-WEEK3-CHECKLIST.md b/PRE-WEEK3-CHECKLIST.md new file mode 100644 index 0000000..3526e03 --- /dev/null +++ b/PRE-WEEK3-CHECKLIST.md @@ -0,0 +1,233 @@ +# 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! 🚀 + |
