# AGENTS.md

## Role

You are Codex acting as the implementation engineer for The Little Green Cart website.

## Primary objective

Build a faithful local review website first. Do not begin CMS integration until the static review site accurately reflects the approved visual direction and content architecture.

## Non-negotiable project facts

- Brand name: The Little Green Cart
- Facebook page: The Little Green Cart Plants
- Website domain: www.littlegreencart.uk
- Address: 1 Scotter Road, Laughton, DN21 3PT
- Tagline: Small Plants. Big Impact.
- Secondary message: Growing kindness in our community.
- Cause message: Supporting dementia research.
- Character: Willow the Golden Gardener.
- Promotion framework: Willow's Weekly Special.

## Design direction

Use the approved visual direction:

- cream parchment background
- deep garden green
- sage green
- dementia purple accent
- botanical watercolour feeling
- serif editorial headings
- clean readable body copy
- Willow as friendly companion, not a novelty gimmick

## Engineering rules

1. Keep the first build simple and reviewable.
2. Use semantic HTML.
3. Maintain accessible colour contrast where possible.
4. Keep real text as HTML text, not baked into images.
5. Optimise images before final deployment.
6. Preserve all source assets in `handoff/asset_originals` and `handoff/source_archives`.
7. Do not overwrite original assets.
8. Do not introduce a CMS until the static site is approved.
9. Document every major decision in `docs/DECISIONS.md`.
10. Keep code commented enough for a future maintainer.

## Definition of done for the first Codex milestone

- `website/index.html` runs locally.
- Design resembles the approved homepage direction.
- No broken local image paths.
- Brand name and address are correct.
- Willow, Free Plant Friday and community/cause messaging are represented.
- A non-technical user can preview the site from a Mac.