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.
4.2 KiB
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