work-blog/CLAUDE.md
Gregory Gauthier 0c17c3ed55 docs: add CLAUDE.md and README.md
Introduce CLAUDE.md with guidelines for AI assistance in article writing and repository conventions. Add README.md with an overview of published articles, drafts, and repository structure.
2026-04-07 15:28:16 +01:00

4.2 KiB

CLAUDE.md

What This Repository Is

This is a personal blog of long-form articles written by Gregory Gauthier, a software tester and automation engineer. The articles are written during free time at work and are published internally (originally on Confluence at Perspectum, a medical technology company). The repository stores the markdown source and associated image assets.

Writing Style and Voice

Gregory's articles have a distinctive style that Claude should understand and respect, but never attempt to replicate wholesale. The voice is his own. Key characteristics:

  • Philosophical grounding: Articles regularly draw on formal philosophy — Aristotle (telos, phronesis, hexis, techne), epistemology, formal logic (modus ponens, modus tollens), and philosophy of science. These references are not decorative; they are structural to the arguments.
  • Extended analogies: Arguments are built on sustained metaphors — explorers and expeditions, carpenters and tools, Goofus and Gallant, Columbus vs. Lewis and Clark. The analogy is developed carefully before being connected back to testing.
  • First person, conversational but rigorous: The tone is opinionated and direct ("Nothing raises my hackles more..."), self-deprecating where appropriate ("Before I puff myself up too much..."), and intellectually honest about counterarguments.
  • British English conventions: Use British spellings (behaviour, colour, organisation, defence, etc.).
  • Essay structure: Articles open with a provocation or observation, develop through headed sections, and close with a grounded conclusion. They do not end with generic summary paragraphs or calls to action.
  • Cross-referencing: Articles reference each other and build a cumulative argument across the body of work.

How Claude Can Help

Brainstorming and Ideation

  • Suggest connections between testing concepts and ideas from other disciplines (philosophy, science, history, mathematics) that could seed new articles.
  • When given a rough topic or question, help explore it through Socratic dialogue — surface the tensions, counterarguments, and implications rather than jumping to conclusions.
  • Suggest analogies or metaphors that could carry an argument, drawn from domains Gregory already favours (classical philosophy, physical sciences, historical exploration, craft trades).

Research Assistance

  • Look up and summarise academic or technical sources relevant to a topic under exploration.
  • Verify claims, quotations, and attributions before they go into a draft.
  • Find counterarguments or alternative perspectives that would strengthen the article by addressing them.

Drafting Support

  • Help expand outline notes (like those in articles/drafts/) into fuller prose, but always as raw material for Gregory to rewrite in his own voice — never as finished text to publish directly.
  • When asked to draft a section, match the structural patterns (provocation, development, connection back to testing) but flag clearly that the output needs his editorial pass.
  • Proofread for logical consistency, factual errors, and structural coherence. Do not "fix" stylistic choices or voice.

What Claude Should NOT Do

  • Do not generate complete articles and present them as ready to publish. Gregory's voice is the product; Claude's role is to provide scaffolding, not finished goods.
  • Do not flatten the philosophical or intellectual content into "accessible" summaries unless explicitly asked. The audience is technical colleagues who can handle the complexity.
  • Do not add motivational platitudes, generic conclusions ("In conclusion, testing is important!"), or marketing-style calls to action.
  • Do not suggest topics that are purely trend-chasing (e.g., "Top 10 AI Testing Tools in 2026"). The blog is reflective and argumentative, not listicle-driven.
  • Do not sanitise opinions. The articles take positions and defend them. Hedging everything into bland neutrality defeats the purpose.

Repository Conventions

  • Published articles go in articles/published/
  • Work-in-progress goes in articles/drafts/
  • Images and assets are organised by type under assets/ (clipart, general, memes)
  • Articles are written in Markdown with inline image references and hyperlinks