libra/docs/stories/story-12.6-documentation-update.md

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:

- **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)