Files
halloween-test/project-spec.md
snowprint 1c7c00204b docs(project): complete project setup and documentation
- Add agent system constitution with time recording standards
- Add Git workflow documentation for all agents
- Add comprehensive time recording policy (UTC + GMT+8)
- Add CHANGELOG with version history
- Add CONTRIBUTING guide with Git workflow and commit conventions
- Add project specification document
- Add README with project overview
- Add .gitignore for macOS and editor files
- Update CLAUDE.md with project requirements and metadata

Project initialized: 2025-10-04 08:50:35 UTC / 16:50:35 GMT+8
2025-10-04 17:31:19 +08:00

4.3 KiB

Project Specification: McDonald's IT Halloween Event Page

Executive Summary

Single-page website for McDonald's IT department Halloween event announcement, featuring extreme minimalist geek aesthetic inspired by Homebrew.

Functional Requirements

FR-1: Event Information Display

  • Display Halloween event date, time, and location
  • List activities and schedule
  • Show participation instructions
  • Include contact information

FR-2: Visual Branding

  • ASCII art McDonald's logo as primary visual element
  • Terminal/command-line aesthetic throughout
  • Maintain brand recognition while adhering to geek style

FR-3: Responsive Design

  • Seamless experience on desktop (1024px+)
  • Optimized layout for tablets (768-1023px)
  • Mobile-friendly design (320-767px)
  • ASCII art must remain legible on all devices

FR-4: Performance

  • Page load time < 1 second
  • No external dependencies
  • Single self-contained HTML file
  • Minimal file size (< 50KB)

Non-Functional Requirements

NFR-1: Accessibility

  • WCAG 2.1 AA compliance
  • Keyboard navigation support
  • Screen reader compatible
  • High contrast ratios (minimum 7:1)

NFR-2: Browser Compatibility

  • Chrome 90+
  • Firefox 88+
  • Safari 14+
  • Edge 90+

NFR-3: Maintainability

  • Clean, well-commented code
  • Semantic HTML5 markup
  • Inline CSS for portability
  • Easy content updates

Design Specifications

Color Palette

  • Background: #000000 (pure black)
  • Primary Text: #00FF00 (terminal green) or #FFFFFF (white)
  • Accent: #FFBF00 (amber) for highlights
  • No gradients, shadows, or transparency

Typography

  • Font Family: 'Courier New', 'Monaco', 'Consolas', 'Menlo', monospace
  • Base Font Size: 16px (desktop), 14px (mobile)
  • Line Height: 1.6
  • Letter Spacing: Normal (monospace default)

Layout

+----------------------------------+
|                                  |
|         [ASCII LOGO]             |
|         McDonald's               |
|                                  |
|    🎃 Halloween Event            |
|                                  |
|    Date: [TBD]                   |
|    Time: [TBD]                   |
|    Location: IT Department       |
|                                  |
|    Activities:                   |
|    • Costume Contest             |
|    • Code & Candy                |
|    • Spooky Debugging Challenge  |
|                                  |
+----------------------------------+

ASCII Art Requirements

  • Centered horizontally
  • Approximately 40-60 characters wide (desktop)
  • Scaled version for mobile (20-30 characters)
  • Uses only standard ASCII characters
  • Maintains McDonald's brand recognition

Content Requirements

Event Details

  • Event name: "McDonald's IT Halloween Event"
  • Date: TBD (To be confirmed by McDonald's IT)
  • Time: TBD (To be confirmed by McDonald's IT)
  • Location: McDonald's IT Department (specific location TBD)

Activities (Example - to be confirmed)

  1. Costume Contest - Best tech-themed costume wins
  2. Code & Candy - Solve coding challenges for treats
  3. Spooky Debugging Challenge - Find the bugs, win prizes
  4. Halloween Trivia - Tech and pop culture questions

Call to Action

  • RSVP instructions
  • Contact information
  • Dress code (optional costumes)

Technical Constraints

  • No external CSS files
  • No external JavaScript libraries
  • No image files (ASCII art only)
  • No web fonts (system fonts only)
  • No backend/server-side code required

Success Criteria

  1. Page loads in < 1 second on 3G connection
  2. ASCII art is legible on iPhone SE (375px width)
  3. Passes HTML5 validation
  4. Achieves WCAG 2.1 AA contrast ratios
  5. Works without JavaScript enabled
  6. Receives positive feedback from IT staff

Out of Scope

  • User registration system
  • Database integration
  • Content management system
  • Multi-language support
  • Animation or video content
  • Social media integration

Deliverables

  1. index.html - Complete, production-ready webpage
  2. Documentation in README.md
  3. Testing notes and browser compatibility report

Timeline

Project Initiated: 2025-10-04 08:50:35 UTC / 2025-10-04 16:50:35 GMT+8

  • Project setup: Complete (2025-10-04)
  • Design & development: 1-2 hours (estimated)
  • Testing & refinement: 30 minutes (estimated)
  • Deployment: 15 minutes (estimated)

Total estimated time: 2-3 hours Target completion: TBD