170 lines
4.7 KiB
Markdown
170 lines
4.7 KiB
Markdown
# Story 12.6: Brand Documentation Update - Dark Charcoal & Warm Gold
|
|
|
|
## Story
|
|
|
|
**As a** developer
|
|
**I want to** update all brand documentation to reflect the new dark charcoal and warm gold color palette
|
|
**So that** documentation accurately represents the current brand identity
|
|
|
|
## Acceptance Criteria
|
|
|
|
### AC1: Update `docs/brand.md`
|
|
|
|
**Given** the brand documentation references old colors
|
|
**When** I update the file
|
|
**Then** the following sections are updated:
|
|
- Color palette section with new hex values
|
|
- Color usage guidelines
|
|
- Any color swatches or examples
|
|
|
|
**New Color Palette:**
|
|
|
|
| Color Name | Hex | Usage |
|
|
|------------|-----|-------|
|
|
| Dark Forest Green | `#2D3624` | Header/Footer backgrounds |
|
|
| Warm Gold | `#A68966` | CTA buttons, links, accents |
|
|
| Warm Cream | `#F4F1EA` | Main page background |
|
|
| Forest Green | `#2D322A` | Headings, body text |
|
|
| Pure White | `#FFFFFF` | Card backgrounds |
|
|
| Olive Green | `#4A5D23` | Active states |
|
|
| Gold Hover | `#8A7555` | Button hover states |
|
|
| Gold Light | `#C4A882` | Light accents |
|
|
| Primary Light | `#3D4634` | Primary hover states |
|
|
|
|
### AC2: Update `CLAUDE.md`
|
|
|
|
**Given** CLAUDE.md contains design requirements with old colors
|
|
**When** I update the file
|
|
**Then** the Design Requirements section reflects new palette:
|
|
- Update color scheme description
|
|
- Update hex values
|
|
- Maintain bilingual requirement notes
|
|
|
|
### AC3: Update `docs/architecture.md` (if applicable)
|
|
|
|
**Given** architecture docs may reference brand colors
|
|
**When** I review the file
|
|
**Then** any color references are updated to new palette
|
|
|
|
### AC4: Update `docs/prd.md` (if applicable)
|
|
|
|
**Given** PRD may reference brand colors
|
|
**When** I review the file
|
|
**Then** any color references are updated to new palette
|
|
|
|
### AC5: Update Test Color Assertions
|
|
|
|
**Given** tests may assert specific color values
|
|
**When** I review test files
|
|
**Then** color assertions are updated:
|
|
- `tests/Feature/Admin/PdfBrandColorsTest.php`
|
|
- Any other tests checking brand colors
|
|
|
|
### AC6: Review and Update Code Comments
|
|
|
|
**Given** code comments may reference old color names
|
|
**When** I review key files
|
|
**Then** comments are updated:
|
|
- `resources/css/app.css` - CSS comments
|
|
- Any inline style comments in Blade files
|
|
|
|
### AC7: Update Logo Generation Instructions (if exists)
|
|
|
|
**Given** `docs/logo-generation-instructions.md` may exist
|
|
**When** I review the file
|
|
**Then** any color references match new palette
|
|
|
|
## Technical Notes
|
|
|
|
### Files to Review/Modify
|
|
|
|
**Documentation:**
|
|
- `docs/brand.md` - Primary brand documentation
|
|
- `CLAUDE.md` - Project instructions
|
|
- `docs/architecture.md` - Architecture documentation
|
|
- `docs/prd.md` - Product requirements
|
|
|
|
**Tests:**
|
|
- `tests/Feature/Admin/PdfBrandColorsTest.php`
|
|
- Any other brand color tests
|
|
|
|
**Code Comments:**
|
|
- `resources/css/app.css`
|
|
|
|
### Color Reference Quick Sheet
|
|
|
|
```
|
|
Primary Colors:
|
|
- Dark Forest Green: #2D3624 (header/footer bg)
|
|
- Warm Gold: #A68966 (CTA, links)
|
|
- Warm Cream: #F4F1EA (page background)
|
|
- Forest Green: #2D322A (text)
|
|
- Pure White: #FFFFFF (cards)
|
|
- Olive Green: #4A5D23 (active states)
|
|
|
|
Variants:
|
|
- Primary Light: #3D4634
|
|
- Gold Hover: #8A7555
|
|
- Gold Light: #C4A882
|
|
- Olive Hover: #5A7030
|
|
```
|
|
|
|
### CLAUDE.md Design Requirements Update
|
|
|
|
Replace the existing color scheme section with:
|
|
|
|
```markdown
|
|
- **Color scheme:**
|
|
- Dark Forest Green (#2D3624) - Header/Footer backgrounds
|
|
- Warm Gold (#A68966) - CTA buttons, links, accents
|
|
- Warm Cream (#F4F1EA) - Main page background
|
|
- Forest Green (#2D322A) - Headings, body text
|
|
- Pure White (#FFFFFF) - Card backgrounds
|
|
- Olive Green (#4A5D23) - Active states
|
|
```
|
|
|
|
## Dev Checklist
|
|
|
|
- [ ] Update `docs/brand.md` color palette section
|
|
- [ ] Update `docs/brand.md` color usage guidelines
|
|
- [ ] Update `CLAUDE.md` Design Requirements section
|
|
- [ ] Review `docs/architecture.md` for color references
|
|
- [ ] Review `docs/prd.md` for color references
|
|
- [ ] Update `PdfBrandColorsTest.php` assertions
|
|
- [ ] Review other test files for color assertions
|
|
- [ ] Update CSS comments in `app.css`
|
|
- [ ] Review `docs/logo-generation-instructions.md` if exists
|
|
- [ ] Final review of all documentation for consistency
|
|
|
|
## Estimation
|
|
|
|
**Complexity:** Low
|
|
**Risk:** Low - Documentation only, no code changes
|
|
|
|
## Dependencies
|
|
|
|
- Stories 12.2, 12.3, 12.4, 12.5 must be completed first
|
|
- New colors must be implemented and verified before documenting
|
|
|
|
---
|
|
|
|
## Dev Agent Record
|
|
|
|
### Status
|
|
Not Started - Blocked (waiting for Stories 12.2-12.5 completion)
|
|
|
|
### Agent Model Used
|
|
(To be filled during implementation)
|
|
|
|
### File List
|
|
(To be filled during implementation)
|
|
|
|
### Change Log
|
|
|
|
| Date | Change |
|
|
|------|--------|
|
|
| 2026-01-04 | Story created for documenting new Dark Charcoal & Warm Gold palette |
|
|
|
|
### Completion Notes
|
|
(To be filled during implementation)
|