@equal-experts/kuat-react 0.13.0 → 0.14.0-beta.0

package/agent-docs/external/kuat-agent-rules/reference/brand/README.md

@@ -0,0 +1,9 @@
+# Brand
+
+Equal Experts brand identity: who EE is and how the brand expresses itself.
+
+| File | Scope |
+|------|-------|
+| [brand.md](./brand.md) | Brand principles and identity |
+| [logo.md](./logo.md) | Logo variants, sizing, placement, clear space |
+| [voice-and-tone.md](./voice-and-tone.md) | Voice, tone, audience, content quality |

package/agent-docs/external/kuat-agent-rules/reference/brand/brand.md

@@ -0,0 +1,109 @@
+# Equal Experts Brand
+
+Core brand principles and identity guidelines for Equal Experts.
+
+---
+
+## Brand Identity
+
+Equal Experts is a network of experienced software consultants, helping organisations deliver better digital products and services.
+
+**Key Brand Attributes:**
+- **Expert** - Deep technical expertise and experience
+- **Equal** - Collaborative, flat structure, no hierarchies
+- **Honest** - Direct, transparent communication
+- **Pragmatic** - Practical solutions over theoretical perfection
+
+---
+
+## Brand Values
+
+The Equal Experts values act as principles of how we work with our customers. They are intended to give all members of the network autonomy in making decisions that are aligned with the way we want to behave, as well as how we want to be recognised.
+
+### 1. We deliver as teams of equals
+
+Teams are greater than the sum of their parts. No matter what role people play in a team, they all have something to contribute, and they all have a voice in delivery decisions.
+
+### 2. We prioritise outcomes over approach
+
+We work in complex and highly dynamic environments. We’re not interested in a cookie-cutter approach.
+
+### 3. We narrow our focus but widen our context
+
+We deliver concrete value as early as possible by quickly identifying key opportunities, but framing them within the wider organisational context.
+
+### 4. We bring step-by-step change
+
+It can be tempting to look for a WOW factor, but we know that lasting change is best achieved through small, incremental practices that build towards larger transformation.
+
+### 5. We have a passion for learning over knowing all the answers
+
+We may be experts, but we don’t pretend to know all the answers.
+
+### 6. We seek customer success over our own short-term interests
+
+We thrive by our reputation, so the only way to guarantee our future success is to do what’s right, right now, for our customers.
+
+---
+
+## Brand Voice
+
+### Tone Characteristics
+
+| Characteristic | Description |
+|----------------|-------------|
+| Confident | We know our craft and speak with authority |
+| Humble | We acknowledge what we don't know |
+| Direct | We get to the point without jargon |
+| Helpful | We focus on enabling others to succeed |
+| Pragmatic | We favour practical over theoretical |
+
+### Voice Do's
+
+- Be clear and direct
+- Use plain language
+- Show expertise through clarity, not complexity
+- Acknowledge uncertainty when appropriate
+- Focus on outcomes and value
+
+### Voice Don'ts
+
+- Don't use buzzwords without substance
+- Don't overclaim or overpromise
+- Don't hide behind jargon
+- Don't be condescending
+- Don't use corporate speak
+
+---
+
+## Brand Positioning
+
+**What we are:**
+- A network of experienced software consultants
+- Partners who work alongside client teams
+- Experts who deliver, not just advise
+
+**What we're not:**
+- A traditional consultancy with hierarchies
+- A body shop providing resources
+- Theorists who don't get hands dirty
+
+---
+
+## Brand Consistency
+
+When representing Equal Experts:
+
+1. **Use official brand assets** - Logo, colors, typography from brand guidelines
+2. **Maintain voice consistency** - Apply brand voice across all touchpoints
+3. **Respect the brand** - Don't modify, distort, or misrepresent
+4. **Be authentic** - Represent the real Equal Experts culture
+
+---
+
+## Related Documentation
+
+- [Logo Usage](./logo.md) - Logo variants, sizing, placement
+- [Colours](../design-language/colours.md) - Brand color palette
+- [Typography](../design-language/typography.md) - Brand fonts
+- [Reference index](../README.md) - All brand reference guides

package/agent-docs/external/kuat-agent-rules/reference/brand/logo.md

@@ -0,0 +1,152 @@
+# Logo Rules
+
+Logo usage specifications for Equal Experts. This document defines logo composition, sizing, variants, and placement guidelines.
+
+---
+
+## Overview
+
+The Equal Experts logo is a core brand asset that must be used consistently and correctly.
+
+**Key Principle:** Always use official logo assets. Never recreate, modify, or distort the logo.
+
+---
+
+## Logo Composition
+
+The logo consists of two elements:
+
+1. **Brand mark:** Square brackets containing an equals sign `[=]` in blue
+2. **Wordmark:** "EQUAL EXPERTS" text in dark gray/charcoal
+
+**Rule:** These elements should always be used together unless space constraints require the brand mark only.
+
+---
+
+## Size Requirements
+
+### Minimum Sizes
+
+| Medium | Minimum Width |
+|--------|---------------|
+| Digital | 100px |
+| Print | 26.5mm |
+
+**Never scale below minimums.** If space is constrained, use brand mark only.
+
+### Recommended Sizes by Context
+
+| Context | Width |
+|---------|-------|
+| Large headers/hero areas | 150-200px |
+| Standard headers | 120-150px |
+| Footers | 100-120px |
+| Small placements | 100px minimum |
+| Favicons/Icons | Brand mark only |
+
+---
+
+## Clear Space
+
+The logo requires breathing room equal to the width of **one bracket and the equals sign** on all sides.
+
+This ensures visual prominence and brand recognition.
+
+---
+
+## Color Variants
+
+### Primary Logos (Default)
+
+Always prefer primary logos for maximum brand recognition:
+
+| Variant | File | Background | Brand Mark | Wordmark |
+|---------|------|------------|------------|----------|
+| Full color | `logo-colour.svg` | Light | Blue | Dark gray |
+| White text | `logo-white-text.svg` | Dark | Blue | White |
+
+### Monochrome Logos (Secondary)
+
+Use only when primary logos cannot be used:
+
+| Variant | File | Background | Usage |
+|---------|------|------------|-------|
+| White | `logo-monochrome-white.svg` | Dark | When primary contrast is insufficient |
+| Black | `logo-monochrome-black.svg` | Light | When monochrome is specifically required |
+
+### Selection Guide
+
+| Background | First Choice | Second Choice |
+|------------|--------------|---------------|
+| Light (white, light gray) | `logo-colour.svg` | `logo-monochrome-black.svg` |
+| Dark (navy, black, dark blue) | `logo-white-text.svg` | `logo-monochrome-white.svg` |
+| Brand color (EE Blue) | `logo-white-text.svg` | `logo-monochrome-white.svg` |
+| Photography/images | `logo-monochrome-white.svg` | Ensure sufficient contrast |
+
+---
+
+## Brand Mark Only
+
+The brand mark (without wordmark) should only be used when:
+
+1. **Space is severely limited** (favicons, small icons, social media avatars)
+2. **Shape requirements** (must fit square/circular shape)
+3. **Decorative use** (design element in presentations)
+4. **Context is clear** (obviously represents Equal Experts)
+
+---
+
+## Usage Guidelines
+
+### Do's
+
+1. **Use official assets** from the brand-assets repository
+2. **Maintain size requirements** - minimum 100px digital, 26.5mm print
+3. **Provide adequate clear space** - bracket+equals width on all sides
+4. **Choose appropriate variant** based on background color
+5. **Ensure accessibility** - sufficient contrast in all contexts
+
+### Don'ts
+
+1. **Don't transform** - No rotation, distortion, skewing
+2. **Don't modify colors** - Use only official variants
+3. **Don't alter composition** - Don't add text, separate elements
+4. **Don't compromise visibility** - No busy backgrounds, no undersizing
+5. **Don't create variations** - No custom colors or effects
+6. **Don't place on low-contrast backgrounds** - Ensure legibility
+
+---
+
+## Platform-Specific Placement
+
+For platform-specific logo placement guidance:
+
+- **Web product** - See [media-types/web-product/](../media-types/web-product/)
+- **Web marketing** - See [media-types/web-marketing/](../media-types/web-marketing/)
+- **Slides** - See [media-types/slides/](../media-types/slides/)
+- **Graphics** - See [media-types/imagery/patterns/graphics/](../media-types/imagery/patterns/graphics/)
+
+---
+
+## Official Logo Assets
+
+All logos are available in the [Equal Experts brand-assets repository](https://github.com/EqualExperts/brand-assets/tree/master/logo).
+
+### Primary Logos
+- `logo-colour.svg` - Full color (light backgrounds)
+- `logo-white-text.svg` - Blue mark, white text (dark backgrounds)
+
+### Monochrome Logos
+- `logo-monochrome-white.svg` - All white (dark backgrounds)
+- `logo-monochrome-black.svg` - All black (light backgrounds)
+
+### Brand Marks
+- `brand-mark-blue.svg` - Blue mark without text
+- `brand-mark-monochrome-white.svg` - White mark without text
+
+---
+
+## Related Documentation
+
+- [Brand Guidelines](./brand.md) - Brand principles
+- [Colours](../design-language/colours.md) - Brand color palette

package/agent-docs/external/kuat-agent-rules/reference/brand/voice-and-tone.md

@@ -0,0 +1,166 @@
+# Voice and Tone
+
+Universal voice and tone for Equal Experts content. Applies to all platforms and media.
+
+---
+
+## Overview
+
+It's not just *what* we say but *how* we say it that matters. A consistent voice — aligned with our vision, mission, and values — helps us speak to our audience clearly, reflects our culture, and differentiates us from the competition. If the voice isn't reflective of Equal Experts, our work, and our values, we risk key messages being misunderstood or overlooked.
+
+Our **voice** is constant: it's who we are. Our **tone** flexes to suit the audience, channel, and purpose.
+
+---
+
+## Quick Reference
+
+**Always:**
+- Be friendly, clear, and approachable — one human to another
+- Be confident, but never arrogant; back claims with evidence
+- Focus on the audience and their needs
+- Use plain language; be specific, not vague
+- Be consistent across channels and materials
+
+**Never:**
+- Make bold claims without backing them up
+- Hide behind jargon, acronyms, or buzzwords
+- Talk down to, over-simplify for, or patronise the audience
+- Overuse "we" so the content reads as boastful
+- Mix and match tones and styles within a piece
+
+---
+
+## How We Describe Equal Experts
+
+Equal Experts is a global network of technology shapers. We work collaboratively with clients on digital initiatives that deliver long-lasting change and pragmatic innovation. Engaging around 3,000 consultants across five continents, we help solve complex business problems and create leading digital products and services. We decide with data, design for users, deliver at pace, and scale sustainably.
+
+What makes us unique: we engage only senior consultants (averaging around 18 years' experience), we're low-ego and curious, we're vendor-agnostic and don't offer cookie-cutter solutions, and our flexible global delivery model means we're not limited by geography.
+
+---
+
+## Writing in the Equal Experts Voice
+
+**Friendly, clear, and approachable.** We speak from one human to another. Though we work with cutting-edge technology, we're not robots and neither are our customers. Content is clear, concise, and purposeful, but reflects how we'd speak face-to-face. Gentle humour is welcome when it arises naturally, is appropriate, and will be widely understood.
+
+**Confident, but never arrogant.** With a word as powerful as "expert" in our name, we embody it with humility. We show our knowledge through tangible results and a passion for learning. We're confident without being condescending, and knowledgeable without being know-it-alls.
+
+**Focused on the audience.** Our voice adapts to different audiences, channels, and platforms. When we talk about technology, we consider the audience and don't cloud the message with terminology, acronyms, or phrases they're unlikely to understand. We're not dumbing down or patronising — we're meeting the audience where they are.
+
+**Genuine, and a team of equals.** Our voice instils trust in our work and our people. We speak positively about our customers — past and present — emphasising collaboration, transparency, and honesty. We voice our opinions but stay open to compromise for the good of the client or team. We're considerate and intentional with our words, paying close attention to inclusivity and accessibility.
+
+---
+
+## Adapting Tone for the Audience
+
+The Equal Experts voice flexes to the audience and content type. Internal audiences allow a more informal, conversational tone with more room for humour; sales materials dial up confident, persuasive language.
+
+| Audience / channel | Tone |
+|--------------------|------|
+| Case studies (external) | Straightforward and factual, with a focus on storytelling, client collaboration, and results |
+| Blogs (external & internal) | Purposeful and informative, letting the author's personality shine through; answer the audience's questions |
+| Playbooks & informative content | Clear and informative, with evidence-based insights and examples; a strong expert tone |
+| Pitch decks & sales materials | Confident, authoritative, persuasive; definitive statements about our work and impact, always backed by results |
+| Social media | Conversational, friendly, and informal; often addressed to the audience |
+| Internal Blogin & Slack | Friendly, approachable, reflecting the author's personality. Remember NDAs |
+| Knowledge Portal | Deeper, less-polished opinions and insights, useful for the network but not for external view. Remember NDAs |
+
+We don't adapt the tone in a way that compromises our values, and we always read as professional, reliable experts who deliver results.
+
+---
+
+## Content Principles
+
+These principles underpin all our content, from planning to maintenance.
+
+1. **Always be human.** We're humans talking to humans — simple, authentic, and genuine, with personality and humour where it suits.
+2. **Have a clear purpose.** Set the aim, audience, and the goal it serves before you start. What question does this piece answer?
+3. **Know who your audience is.** Understand their situation, behaviours, attitudes, problems, and goals.
+4. **Be clear and concise.** Plain English, the best chance of being read and understood. Don't use ten words when three will do.
+5. **Collaborate with others.** Draw on people with the right skills at the right point in the process.
+6. **Test, iterate, and learn.** Try new content, improve it on feedback and evidence, and share what you learn across the network.
+
+---
+
+## Top Tips
+
+- **Write for all readers.** Some read every word; others skim. Descriptive headers, subheaders, lists, and diagrams help people find what they need
+- **Lead with the key message.** Open with the main or most interesting point, then back it up
+- **Use the active voice.** "We reviewed the code", not "The code was reviewed by Equal Experts"
+- **Be clear, concise, and specific.** Plain English, no slang, no unnecessary jargon or acronyms; don't assume prior knowledge
+- **Write like a human.** Being an expert means removing complexity — be relatable, warm, and friendly
+- **Adapt to the audience.** Suit the situation, the reader, and the subject
+- **Don't "we" all over the content.** Too much "we" reads as boastful; emphasise the client and the collaboration
+- **Be consistent.** Apply the same standards and style throughout; don't mix tones
+
+---
+
+## UK English and Local Markets
+
+We focus on **UK English** for global content, but respect local markets — Australia, the US, Europe, South Africa, and India — where appropriate, adopting local spelling, grammar, and currency in location-specific content.
+
+---
+
+## Audience Considerations
+
+### Technical audiences (developers, engineers)
+
+**Tone:** Pragmatic, evidence-based, respectful of expertise. Use specific technical detail, code examples, and trade-offs. Avoid over-simplification, buzzwords, and marketing language.
+
+### Business stakeholders (product owners, leaders)
+
+**Tone:** Outcome-focused, clear, strategic. Use business metrics, efficiency gains, and impact. Avoid deep technical detail without context and unexplained acronyms.
+
+### General audiences
+
+**Tone:** Helpful, clear, accessible. Use plain language, clear explanations, and practical examples. Avoid corporate speak and jargon.
+
+---
+
+## Common Pitfalls
+
+### Buzzword bingo
+Trendy terminology without substance.
+
+❌ "Leveraging synergistic, AI-enabled solutions"  
+✅ "We automated invoice processing using existing APIs"
+
+### Unbacked claims
+Bold statements without evidence.
+
+❌ "We'll dramatically improve your performance"  
+✅ "The health check saved the client £3 million"
+
+### Over-explanation
+Explaining what needs no explanation.
+
+❌ "Click the button below to continue to the next screen"  
+✅ [Continue]
+
+---
+
+## Content Quality Checklist
+
+- **Clarity:** Can it be understood from a 30-second skim?
+- **Purpose:** Does it answer a specific question or solve a problem?
+- **Consistency:** Does it use consistent terminology and patterns?
+- **Audience:** Is it pitched right for the intended reader?
+- **Accessibility:** Does it work for everyone, including assistive-technology users?
+
+---
+
+## Platform-Specific Content
+
+For platform-specific content guidance:
+
+- **Web Marketing** - See [media-types/web-marketing/](../media-types/web-marketing/)
+- **Web Product** - See [media-types/web-product/](../media-types/web-product/)
+- **Slides** - See [media-types/slides/](../media-types/slides/)
+
+---
+
+## Related Documentation
+
+- [Brand Guidelines](./brand.md) - Brand voice and values
+- [Writing style](../content/writing-style.md) - Active voice, plain language, conventions
+- [Inclusive language](../accessibility/accessibility.md#inclusive-language) - Accessible, bias-free word choices
+- [Design language](../design-language/design-language.md) - Visual design principles

package/agent-docs/external/kuat-agent-rules/reference/content/README.md

@@ -0,0 +1,12 @@
+# Content
+
+How Equal Experts writes — style and usage conventions that apply across every medium. (Voice and tone lives in [brand/](../brand/voice-and-tone.md).)
+
+| File | Scope |
+|------|-------|
+| [writing-style.md](./writing-style.md) | Active voice, plain language, conciseness |
+| [formatting.md](./formatting.md) | Capitalisation, headings, links, lists, acronyms |
+| [numbers.md](./numbers.md) | Dates, times, currency, percentages, units |
+| [punctuation.md](./punctuation.md) | Commas, dashes, apostrophes, quotation marks |
+
+Inclusive, bias-free word choices live in [accessibility/](../accessibility/accessibility.md#inclusive-language) and are cross-linked from [writing-style.md](./writing-style.md).

package/agent-docs/external/kuat-agent-rules/reference/content/formatting.md

@@ -0,0 +1,120 @@
+# Formatting
+
+How to use bold, capitalisation, headings, links, lists, and abbreviations in Equal Experts content.
+
+---
+
+## Quick Reference
+
+- **Capitalisation:** Sentence case for headings, buttons, and body copy; capitals only for proper nouns and product names
+- **Bold:** Use sparingly, only to draw attention to a key point
+- **Italics:** Use only to denote a quote
+- **Underline:** Use only to indicate a link
+- **Links:** Descriptive link text, not "click here" or raw URLs
+- **Lists:** Use sparingly; punctuate by whether items are full sentences
+- **Acronyms:** Spell out on first use, then use the short form
+
+---
+
+## Capitalisation
+
+### Sentence case
+
+Use sentence case for:
+- Headings, subheadings, and content titles (no full stop)
+- Button and link labels
+- List items
+- Body copy
+
+**Examples:**  
+"Helping ease the path to AI adoption in the enterprise"  
+"Save and continue"  
+"Contact the team"
+
+### Capitals in body copy
+
+Within the body of the content, use a capital letter only for a **proper noun** (for example a customer or product name). Don't use title case for general headings or UI labels.
+
+---
+
+## Bold, Italics, and Underline
+
+- **Bold:** Use sparingly, only when you want to draw attention to a key point: "Building a culture of innovation? You need **Experts** by your side."
+- *Italics:* Use **only to denote a quote**. Don't use italics for emphasis, titles of works, or technical terms.
+- <u>Underline:</u> Use **only to indicate the presence of a link**. Don't underline for emphasis.
+
+---
+
+## Headings
+
+- Use headings and subheadings to break up text and help readers scan or jump to what they need
+- Write them in **sentence case with no full stop**, and keep them concise and informative: "Why autonomous agents could be the best thing to happen to AI"
+- One H1 per page or screen; use a logical hierarchy (H1 → H2 → H3) and don't skip levels
+
+---
+
+## Links
+
+- Provide a link whenever you refer to something on another website or page
+- Link text should tell people where they're going and why they'd want to visit — link the relevant keywords, written as a normal sentence
+- Don't use words that wouldn't make sense without the link, and avoid "click here" or "read this" — they're bad for accessibility
+
+| Prefer | Avoid |
+|--------|--------|
+| Find out more on our Design service page | Click here for more |
+| Read the accessibility guidelines | Read this |
+| Contact the team | https://example.com/contact |
+
+---
+
+## Lists
+
+Use bullet points for items in no particular order; use a numbered list when the order matters. Use lists sparingly — too many in one piece dilutes their impact. Introduce a list with text followed by a colon.
+
+**Items that are not full sentences:** start each with a lower-case letter, follow each with a comma, end the penultimate item with "and", and end the last item with a full stop:
+
+> Equal Experts can help your business in many ways. We can:
+> - solve complex business problems,
+> - upskill your staff and
+> - scale your business for the future.
+
+**Items that are full sentences:** punctuate them like sentences, with a capital letter and a full stop:
+
+> Inceptions are based on principles and paradigms that we know make the difference:
+> - We validate that our solution is desirable, viable and feasible.
+> - We deliver the most valuable outcomes when we focus on the problem and the outcome.
+
+---
+
+## Buttons
+
+- Button text should describe the resulting **action** and be clear and concise
+- **Capitalise only the first word** ("Save and continue", "Contact us")
+- For product UI button patterns, see [web-product actions](../media-types/web-product/content/actions.md)
+
+---
+
+## Abbreviations and Acronyms
+
+- Spell out on first use with the short form in parentheses: "The Planning and Resource Allocation Committee (PRAC) decided to continue." Then use the short form: "We meet with the PRAC every two weeks."
+- This **isn't required for well-known acronyms** (for example NHS, BBC)
+- **Latin abbreviations** (e.g., etc., i.e.) may be used, but must be used correctly, in the right context, and with full stops
+
+---
+
+## Emojis and Hashtags
+
+Use emojis and hashtags thoughtfully, mainly in social media posts.
+
+- Don't add too many emojis; they should complement the text, not replace it. Check the post still makes sense if the emoji is removed
+- Make sure an emoji is appropriate and doesn't carry an alternative meaning online
+- Use **camel case** for hashtags so they're readable for assistive technology: #BlackLivesMatter, not #blacklivesmatter
+- Use 3–5 hashtags on LinkedIn and 1–2 on X; look for relevant event, industry, or topic tags
+
+---
+
+## Related Documentation
+
+- [Voice and tone](../brand/voice-and-tone.md)
+- [Writing style](./writing-style.md)
+- [Numbers](./numbers.md) - Dates, currency, units

package/agent-docs/external/kuat-agent-rules/reference/content/numbers.md

@@ -0,0 +1,87 @@
+# Numbers
+
+Guidance for numbers, dates, times, and currency in Equal Experts content.
+
+---
+
+## Quick Reference
+
+- **Words vs figures:** Spell out one to ten; use figures for 11 and above
+- **Always figures:** Percentages, measurements, and currency always use figures and symbols (10%, 1.61m, £4m)
+- **Dates:** Day before month, no "th"/"st", never "the" (13 April, not the 13th of April)
+- **Times:** 12-hour uses a full stop (11.30am); 24-hour uses a colon (13:00). Don't mix the two
+- **Currency:** Default to a generic £ for global content; use local currency for single-country content
+- **Large numbers:** Use commas for thousands (3,000); abbreviate very large round numbers (1k, 2m)
+
+---
+
+## Words or Figures
+
+- Spell out whole numbers from **one to ten**: "We worked with the client for two months."
+- Use **figures for 11 and above**: "Our work involved 35 teams across the organisation."
+- If a number is the **first word of a sentence**, spell it out: "Eleven people worked in the team."
+- If a paragraph has **multiple figures**, use figures throughout so readers can compare easily: "There were 2 people in the team when we started, and 22 when we finished."
+
+**Exception:** percentages, measurements, and currency always use figures and symbols, even below 11 (see below).
+
+---
+
+## Ordinals
+
+- Spell out **first to tenth**: "She was the first person to see the problem."
+- Use figures with **st, nd, rd, th** for larger ordinals: "The 19th president of the United States was Rutherford B Hayes."
+
+---
+
+## Percentages, Measurements, and Currency
+
+Always use figures and symbols, regardless of the one-to-ten rule.
+
+- **Percentages:** Use the % symbol with the figure (10%, 12.5%). For a range, "40–60%" (en dash, no space)
+- **Measurements:** "The average height of a woman in the UK is 1.61m." Leave a space when spelling out units in prose where it reads naturally
+- **Currency:** See [Money and currency](#money-and-currency) below
+
+---
+
+## Large Numbers
+
+- Use commas as thousand separators: "We reviewed 3,000 lines of code."
+- For very large round numbers, combine a figure with a word or letter, or abbreviate to 1k or 2m: "The population of the earth is now more than 7 billion people." / "The budget came in at just under £2m."
+- Keep formatting consistent across tables and lists.
+
+---
+
+## Money and Currency
+
+- The default currency is a **generic £** sign on anything that may be referenced globally
+- If content is intended for a **single country**, adopt the local currency: "Our US-based client has seen efficiencies in the region of $1.3m."
+- Abbreviate large round amounts: "The cost savings for our client were £4m."
+
+---
+
+## Dates
+
+- Always put the **date before the month** — even in US-focused content, for clarity: "Easter this year is on 13 April." / "Armistice Day is on 11 November."
+- Don't use "th", "st", "nd", or "rd" with dates, and never precede the number with "the"
+- **Shorten periods** of time where it isn't ambiguous: "The First World War (1914–18)."
+- For a **financial year**, use the format "2020–21": "The company did better in 2020–21 than in 2019–20."
+- Use the **day of the week with a date** only for emphasis or to avoid confusion: "The Agile on the Beach conference starts on Friday 13 April."
+- In code, data, and other technical fields where an unambiguous machine format is needed, ISO 8601 (YYYY-MM-DD) is acceptable; it is the exception, not the prose style.
+
+---
+
+## Time
+
+- Use either the 12-hour or 24-hour clock — **not both** in the same text
+- **12-hour clock:** Use a full stop between hours and minutes, with am/pm: "The meeting starts at 11.30am and ends at 1pm."
+- **24-hour clock:** Use a colon and omit am/pm: "The meeting starts at 11:30 and ends at 13:00."
+- Use **"noon"** or **"midnight"** instead of "12", "12 noon", or "12 midnight"
+- When you use "from" with a start time or date, pair it with "to" for the end — not a dash: "The third financial quarter runs from October to December."
+- Specify a time zone when the reader needs to act or compare across regions ("2.30pm GMT")
+
+---
+
+## Related Documentation
+
+- [Formatting](./formatting.md) - Capitalisation, lists
+- [Punctuation](./punctuation.md) - En dash for ranges, "from … to"