Cline rules

1# Writing Style Rules
2 
3## Voice and Tone
4- Professional but accessible, narrative-driven with technical depth
5- Use conversational elements and real-world examples to make technical concepts relatable
6- Maintain authoritative voice while being approachable
7 
8## Content Structure Pattern
91. **Introduction**: Compelling hook/scenario with context and preview of what reader will learn
102. **Historical Context**: Evolution and background of the topic
113. **Technical Deep Dive**: Detailed analysis with code/architecture examples
124. **Practical Applications**: Real-world implications and use cases
135. **Future Outlook**: Forward-looking analysis and predictions
14 
15## British English Standards (CRITICAL)
16**ALL content MUST use British English spellings exclusively.**
17 
18### Common -ise/-isation endings (NOT -ize/-ization)
19- organise, organisation, recognise, realise, specialise
20- optimise, optimisation, customise, customisation
21- analyse, utilise, summarise, categorise, materialise, digitise
22 
23### -our endings (NOT -or)
24- behaviour, colour, honour, favour, labour, humour, rigour, vigour
25- harbour, flavour, endeavour
26 
27### -re endings (NOT -er)
28- centre, theatre, metre, litre, fibre, calibre
29 
30### -ce endings for nouns (NOT -se)
31- licence (noun), defence, offence, practice (noun)
32- **Note**: license/practise are verbs; licence/practice are nouns
33 
34### Other Important British Spellings
35- analogue (NOT analog), catalogue, dialogue, grey (NOT gray)
36- tyre (NOT tire), focussed (NOT focused), travelled (NOT traveled)
37 
38### Pre-Publication Verification
39Before publishing, search for and correct these American spellings:
40- Words ending in -ize, -ization
41- Words ending in -or when should be -our
42- Words ending in -er when should be -re
43- Common words: center, defense, license (noun), realize, organize, analyze, optimise
44 
45## File Structure Reference
46```
47_posts/
48  └── YYYY/
49      ├── YYYY-MM-DD-post-slug.md    # Blog posts by year
50      └── YYYY-MM-DD-another-post.md
51_pages/
52    ├── about.md
53    ├── categories.md
54    ├── disclaimer.md
55    ├── posts.md
56    └── tags.md
57_data/
58  └── navigation.yml
59_includes/
60  └── head/
61      └── custom.html
62assets/
63  ├── css/
64  │   └── main.scss
65  └── images/
66_config.yml          # Main site configuration
67Gemfile              # Ruby dependencies
68```
69 
70## Local Development Commands
71```bash
72# Install dependencies
73bundle install
74 
75# Serve locally with live reload
76bundle exec jekyll serve
77 
78# Serve with drafts (for preview)
79bundle exec jekyll serve --drafts
80 
81# Build site for production
82bundle exec jekyll build
83 
84# Clean generated files
85bundle exec jekyll clean
86```
87 
88## Development Workflow
891. Make changes to posts or configuration
902. Test locally with `bundle exec jekyll serve`
913. Review changes at `http://localhost:4000`
924. Commit and push to trigger automatic deployment
93 
94## Deployment Process
951. **Local Development**: Test changes locally
962. **Git Push**: Push to main branch
973. **GitHub Actions**: Automatic build and deployment
984. **GitHub Pages**: Site updated at jonbeckett.github.io
99 
100## Common Technical Issues
101 
102### Build Failures
103- Check for YAML syntax errors in front matter
104- Ensure all required front matter fields are present
105- Verify Markdown syntax is correct
106- Check for broken image URLs
107 
108### Archive Configuration
109- Never change archive type from `liquid` to `jekyll-archives`
110- This will break all category and tag links site-wide
111- GitHub Pages has limited plugin support
112 
113## QUICK REFERENCE
114 
115### Essential File Patterns
116```
117_posts/YYYY/YYYY-MM-DD-slug-title.md   # Blog posts
118_pages/*.md                             # Static pages
119_config.yml                            # Site configuration
120_data/navigation.yml                    # Navigation menu
121```
122 
123### Core Front Matter (Minimal)
124```yaml
125---
126title: "Main Title: Subtitle"
127layout: single
128date: YYYY-MM-DD
129categories: [primary-category]
130tags: [tag1, tag2, tag3]
131excerpt: "Compelling one-sentence description"
132---
133```
134 
135### Critical Reminders
136- **British English spellings exclusively** (organise, colour, centre, optimise)
137- **Target length**: 2,000-5,000+ words
138- **Content structure**: Hook → History → Technical → Applications → Future
139- **Archive type**: Must use `liquid` NOT `jekyll-archives` (GitHub Pages limitation)
140- **Layout**: Always `single` for blog posts
141- **Unsplash images**: Always include photographer attribution