CLAUDE.md

This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.

Project Overview

This is a Quarto blog for Zuline Services, focussing on human-centred leadership, organisational change, and dynamic documents. The blog is deployed to https://blog.zuline.com.au.

Writing Style Guidelines

Based on analysis of existing posts, maintain these characteristics:

Tone & Approach: - Professional yet approachable and conversational - Direct and practical, avoiding jargon where possible - Focus on real-world problems and pragmatic solutions - Use rhetorical questions to engage readers (“Do you ever feel like you’re drinking from a firehose?”) - Include personal touches and relatable scenarios

Content Structure: - Start with a relatable problem or scenario - Use descriptive headings that clearly convey the section’s purpose - Break complex concepts into numbered lists or clear sections - Include practical examples and actionable advice - End with clear calls-to-action or next steps

Language Patterns: - Use active voice - Employ metaphors and analogies (e.g., “drinking from a firehose”) - Address the reader directly with “you” and “your” - Use contractions naturally (they’d, you’ve, can’t)

Australian English Requirements

CRITICAL: All content must use Australian English spelling, usage, and grammar:

Spelling: - organisation (not organization) - colour (not color) - centre (not center) - realise (not realize) - analyse (not analyze) - labour (not labor) - favour (not favor) - behaviour (not behavior) - honour (not honor) - programme (not program, except for computer programs) - licence (noun), license (verb) - practice (noun), practise (verb)

Grammar and Usage: - Use collective nouns with singular verbs (“the team is”, not “the team are”) - Use “whilst” instead of “while” where appropriate - Follow Australian punctuation conventions - Use Australian date format when relevant (day/month/year)

Quarto Blog Structure

Post Requirements: - All posts must be in /posts/[post-slug]/index.qmd - Include a featured image in the post directory - Frontmatter must include: title, author, date, categories, image - Use draft: true for unpublished posts, draft: false for published

Markdown Formatting: - CRITICAL: All headings, paragraphs, list items require extra whitespace before, between, and after them - Extra whitespace is not a problem, lack of it causes rendering issues - Always add blank lines before and after headers, lists, paragraphs, and other elements

Example Post Structure:

---
title: "Post Title"
author: "Mike"
date: "YYYY-MM-DD"
categories: [tag1, tag2, tag3]
image: "image.jpg"
draft: false
---

# Main Heading

Introductory paragraph with proper spacing.


## Subheading

Content with proper spacing before and after.


1. First list item

2. Second list item

3. Third list item


Another paragraph after the list.


## Another Section

More content here.

Development Commands

  • quarto preview: Start development server to preview the blog locally
  • quarto render: Build the static site to _site/ directory
  • quarto publish: Deploy the site (configured in _publish.yml)
  • ./cc.sh: Launch Claude Code with project-specific MCP configuration

Theme and Branding

The blog uses a custom theme defined in: - _brand.yml: Core branding (colours, fonts, logo) - avterra.scss: Custom SCSS styling - styles.css: Additional CSS overrides

Brand Colours: - Dark: #13293d - Blue: #00a8aa
- Ivory: #fff7eb

Typography: - Headers: Montserrat (weight 700) - Body: Roboto Slab (regular)

Key Configuration Files

  • _quarto.yml: Main project configuration
  • posts/_metadata.yml: Global post settings (freeze: true, title-block-banner: true)
  • _brand.yml: Brand identity and styling
  • _publish.yml: Publishing configuration

Content Guidelines

  • Focus on organisational development, leadership, and change management topics
  • Include practical advice and real-world examples
  • Use Australian English spellings, usage, and grammar throughout
  • Reference Zuline Services website (https://zuline.com.au) for contact/more information
  • Maintain professional but approachable tone throughout