From d4221b4f34dceea1390f45d88ade5c904d76e9b1 Mon Sep 17 00:00:00 2001 From: Branimir Georgiev Date: Mon, 27 Apr 2026 13:07:54 +0300 Subject: [PATCH 1/2] docs: update CLAUDE.md to reflect current CI pipeline and templates - Add missing template references (testing, cicd, devsecops, platform) - Update CI/CD section: document Lighthouse CI, CodeQL, permissions - Update release process: add package.json bump and gh release steps - Reference quality-gates.md for planned ESLint/Prettier setup Co-Authored-By: Claude Opus 4.6 (1M context) --- CLAUDE.md | 40 ++++++++++++++++++++++++++++++++-------- 1 file changed, 32 insertions(+), 8 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index c4261bb..1c6d88b 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -11,6 +11,10 @@ Key references: - `docs/solid-ai-templates/base/issues.md` — issue templates (epic, task, bug, incident, spike) - `docs/solid-ai-templates/base/scope.md` — scope guard, session protocol - `docs/solid-ai-templates/base/quality-gates.md` — three-layer gate model +- `docs/solid-ai-templates/base/testing.md` — test pyramid, coverage thresholds +- `docs/solid-ai-templates/base/cicd.md` — pipeline stages, triggers, environments +- `docs/solid-ai-templates/base/devsecops.md` — SAST, secret detection, SCA +- `docs/solid-ai-templates/platform/github.md` — CodeQL, GitHub Actions, gitleaks - `docs/solid-ai-templates/frontend/ux.md` — UX principles, WCAG 2.1 AA, accessibility testing - `docs/solid-ai-templates/frontend/quality.md` — CSS conventions, performance, SEO - `docs/solid-ai-templates/frontend/static-site.md` — static site architecture @@ -298,28 +302,48 @@ Extends `docs/solid-ai-templates/stack/static-site-astro.md`: - Default to `.astro` components — zero JS shipped unless islands are used - MUST NOT use `set:html` — bypasses escaping; use `{expression}` instead - ESLint and Prettier are not yet configured — follow `base/quality.md` - style rules manually until tooling is added + style rules manually; see `base/quality-gates.md` for the planned + tooling setup - `.astro` files: keep component scripts minimal, logic in `src/lib/` ### 2.10 CI/CD -Two GitHub Actions workflows: +Extends `docs/solid-ai-templates/base/cicd.md` and +`docs/solid-ai-templates/platform/github.md`. + +Three GitHub Actions workflows + GitHub-native CodeQL: **`build.yml`** — triggers on pull requests to `main` - Checkout, setup Node (pinned to match `engines` in `package.json`), - npm ci, build + npm ci, build, lychee link checking +- Permissions: `contents: read` + +**`lighthouse.yml`** — triggers on pull requests to `main` +- Builds the site and runs Lighthouse CI against 4 pages +- Accessibility < 90 fails the check (error); performance, SEO, + best practices < 90 warn +- Reports uploaded as GitHub Actions artifacts +- Permissions: `contents: read` +- Config: `lighthouserc.json` + +**CodeQL** — GitHub default setup (no workflow file) +- Analyzes JavaScript/TypeScript and GitHub Actions +- Results in Security tab → Code scanning alerts **`deploy.yml`** — triggers on push to `main` -- Same build steps, plus upload artifact and deploy to GitHub Pages +- Same build steps as `build.yml`, plus upload artifact and deploy to + GitHub Pages ### 2.11 Release process Follow `docs/solid-ai-templates/base/git.md` release process: 1. `git checkout -b chore/release-vX.Y.Z` -2. `git commit --allow-empty -m "chore: release vX.Y.Z"` -3. Push, open PR, merge -4. `git checkout main && git pull` -5. `git tag vX.Y.Z && git push origin vX.Y.Z` +2. Bump `version` in `astro-site/package.json` to match +3. Commit: `chore: release vX.Y.Z` +4. Push, open PR, wait for CI, merge +5. `git checkout main && git pull` +6. `git tag vX.Y.Z && git push origin vX.Y.Z` +7. `gh release create vX.Y.Z --title "vX.Y.Z" --notes "..."` Tags use semver: `v1.0.0` (lowercase v, three segments). From bfd88e223afa6354ec1765431e89a03d623ac131 Mon Sep 17 00:00:00 2001 From: Branimir Georgiev Date: Mon, 27 Apr 2026 13:09:38 +0300 Subject: [PATCH 2/2] docs: add model field to CLAUDE.md project section MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Reference model — base conventions in solid-ai-templates submodule, project-specific overrides inline. Co-Authored-By: Claude Opus 4.6 (1M context) --- CLAUDE.md | 1 + 1 file changed, 1 insertion(+) diff --git a/CLAUDE.md b/CLAUDE.md index 1c6d88b..a556060 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -30,6 +30,7 @@ Project-specific overrides and additions follow below. - **Owner**: Branimir Georgiev — braboj - **Repo**: github.com/braboj/tutorial-git - **Stack**: Astro static site, Markdown content, draw.io diagrams +- **Model**: reference — base conventions in `docs/solid-ai-templates/`, project overrides inline - **Hosting**: GitHub Pages via GitHub Actions - **Domain**: braboj.me/tutorial-git (codewithbranko.com pending)