diff --git a/.claude/.shared-blocks.sha256 b/.claude/.shared-blocks.sha256 new file mode 100644 index 0000000..3431a36 --- /dev/null +++ b/.claude/.shared-blocks.sha256 @@ -0,0 +1,2 @@ +0ed3ffb3d7e2fe3fecb9a161bf25e157a37d65f1d28939c875a7d619c8457f70 rules-discipline .claude/rules/rules-discipline.md +7d4f2112a43515d458f232108532c7b52ab270129792119a73588c5b35c8ba50 markdown-docs .claude/rules/markdown-docs.md diff --git a/.claude/CLAUDE.md b/.claude/CLAUDE.md new file mode 100644 index 0000000..872f13e --- /dev/null +++ b/.claude/CLAUDE.md @@ -0,0 +1,43 @@ +# roanny-site + +The operator's personal CV and portfolio, served at https://roanny.github.io/. The repository is `roanny/roanny.github.io`, under his personal GitHub account rather than the Coabana organization. It is a site, not a product: nothing consumes it, and it names no fleet product. + +## The tree + +- `index.html` — the whole site: content, styles, the `i18n` dictionaries and the script. No framework, no build step. +- `404.html` — the themed not-found page, self-contained. +- `favicon.svg`, `favicon-32.png`, `og-image.jpg` (the 1200×630 social card), `robots.txt`, `sitemap.xml`, `googlede4b53d1c977dbfc.html` (Search Console verification; never removed). +- `.nojekyll` — Pages serves the tree as it is, without Jekyll. +- `.github/scripts/check_site.py`, `.github/htmlvalidate.json` — the site's own gates, run by `Validate`. + +## Editing and previewing + +- Text lives in the `i18n` object at the end of `index.html`: two dictionaries, `en` and `es`, with the same keys; each translatable element carries `data-i18n=""`, and the English default in the HTML stays aligned with `en`. +- Preview: `python3 -m http.server 8000`, then http://localhost:8000 (`?lang=en|es` and `?theme=light|dark` force the language and the theme). +- The gates by hand, as CI runs them: `npx --yes html-validate@11.16.0 --config .github/htmlvalidate.json index.html 404.html`, `python3 .github/scripts/check_site.py i18n`, `python3 .github/scripts/check_site.py sitemap`. +- A content change updates `lastmod` in `sitemap.xml`. + +## Serving + +GitHub Pages serves the root of `main`; a push to `main` is live in 1–2 minutes. There is no release and no `/release`: the fleet's `release` shared block does not apply, and a landing that changes the pages is a deploy (`git-hygiene.md`). + +## The one coupling + +The design tokens (palette, type, chips, buttons, motion) mirror `DESIGN.md` of `coabana-site` (`Coabana/coabana.github.io`), the canonical source, copied by hand into the `