I asked for an article and got four questions
· Alessandro Azzaretto · 3 min read
I typed /articolo. Instead of an article, I got four questions.
Fair enough. The command wanted to save the article in two languages, inside a folder that didn't exist yet.
Where I started
Earlier today the site was Italian only. Then I changed the rules in CLAUDE.md:
- English becomes the main language, with a full Italian version under
/it/; - every page exists in both languages, with an EN | IT switch at the top and two small SVG flags;
- no automatic translator: both versions are written properly.
I also rewrote the rules for articles. Before, they said: first person, short sentences. Now there's a whole list. Start from a concrete scene. Cut the warm-up. Short paragraphs. After every technical fact, a line that answers "so what?".
That's why this article reads differently from the first one.
Then I updated /articolo: every article in English and Italian, every page updated in both.
What broke
The order.
The command was ready. The bilingual site wasn't. No it/ folder, no switch, no English pages. And the plan for the new structure was still waiting for my OK.
So instead of writing, it stopped and asked:
- migrate the site first, or write the article in Italian only?
- English folder names in both languages, or translated ones?
- British flag or American?
- just translate the first article, or rewrite it with the new rules?
My answers: migrate first, English folders, British flag, rewrite.
I wrote the instructions before the thing they described existed.
The structure
The key rule: the Italian version of a page has the same path as the English one, with it/ in front.
projects/website/index.html → it/projects/website/index.html
Same folders, same file names. So what? The EN | IT switch can't point to the wrong page. Every page has a twin, and you find it by adding or removing two letters.
That's why the folders now have English names in both languages. Two projects got renamed: sito became website, tabellone-treni became train-board.
The switch uses no JavaScript. Each page has a plain link to its twin, written in the HTML. Nobody gets redirected based on their browser language: you land on English, and one click takes you to Italian.
Dates are now written as 2026-11-03 in both languages. Neutral, and in the monospaced font they look like entries in a log.
What I learned
Instructions written for something that doesn't exist yet fail in the most boring way possible. They can't find the folder.
A command that stops and asks beats one that guesses. A guess would have left me with a half-bilingual site and an article in the wrong place.
Next step
Same as before, only twice: real texts for the other four projects, in English and in Italian.
Four questions, four answers. One site, two languages.