docs: add auto-claude spec and tracking files

- Add spec.md and requirements.json for task definition
- Add qa_report.md with QA findings
- Add task_logs.json and task_metadata.json for tracking
This commit is contained in:
2026-01-11 23:35:47 +01:00
parent a4d61fe170
commit d86a8ffa0e
5 changed files with 14353 additions and 0 deletions

View File

@@ -0,0 +1,17 @@
# Conceptual Explanations
Add brief 'Why This Works' explanations to each lesson that explain the concept behind the CSS property, not just the syntax. Include visual diagrams where helpful.
## Rationale
The #1 criticism of Flexbox Froggy and similar tools is they teach syntax without explaining WHY. Codecademy and freeCodeCamp also criticized for 'just type this without understanding'. This is a major market gap we can fill.
## User Stories
- As a beginner, I want to understand WHY CSS properties work so that I can apply knowledge to new situations
- As a self-taught developer, I want conceptual understanding so that I can build from scratch, not just follow tutorials
## Acceptance Criteria
- [ ] Each lesson includes a 'Concept' section explaining WHY the CSS property works
- [ ] Explanations are concise (2-4 sentences) and beginner-friendly
- [ ] Visual diagrams or illustrations included where helpful
- [ ] Concept section is collapsible so advanced users can skip
- [ ] Flexbox lessons explicitly explain container vs item distinction