Skip to content

Commit d4221b4

Browse files
brabojclaude
andcommitted
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) <noreply@anthropic.com>
1 parent ccf692a commit d4221b4

1 file changed

Lines changed: 32 additions & 8 deletions

File tree

CLAUDE.md

Lines changed: 32 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,10 @@ Key references:
1111
- `docs/solid-ai-templates/base/issues.md` — issue templates (epic, task, bug, incident, spike)
1212
- `docs/solid-ai-templates/base/scope.md` — scope guard, session protocol
1313
- `docs/solid-ai-templates/base/quality-gates.md` — three-layer gate model
14+
- `docs/solid-ai-templates/base/testing.md` — test pyramid, coverage thresholds
15+
- `docs/solid-ai-templates/base/cicd.md` — pipeline stages, triggers, environments
16+
- `docs/solid-ai-templates/base/devsecops.md` — SAST, secret detection, SCA
17+
- `docs/solid-ai-templates/platform/github.md` — CodeQL, GitHub Actions, gitleaks
1418
- `docs/solid-ai-templates/frontend/ux.md` — UX principles, WCAG 2.1 AA, accessibility testing
1519
- `docs/solid-ai-templates/frontend/quality.md` — CSS conventions, performance, SEO
1620
- `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`:
298302
- Default to `.astro` components — zero JS shipped unless islands are used
299303
- MUST NOT use `set:html` — bypasses escaping; use `{expression}` instead
300304
- ESLint and Prettier are not yet configured — follow `base/quality.md`
301-
style rules manually until tooling is added
305+
style rules manually; see `base/quality-gates.md` for the planned
306+
tooling setup
302307
- `.astro` files: keep component scripts minimal, logic in `src/lib/`
303308

304309
### 2.10 CI/CD
305310

306-
Two GitHub Actions workflows:
311+
Extends `docs/solid-ai-templates/base/cicd.md` and
312+
`docs/solid-ai-templates/platform/github.md`.
313+
314+
Three GitHub Actions workflows + GitHub-native CodeQL:
307315

308316
**`build.yml`** — triggers on pull requests to `main`
309317
- Checkout, setup Node (pinned to match `engines` in `package.json`),
310-
npm ci, build
318+
npm ci, build, lychee link checking
319+
- Permissions: `contents: read`
320+
321+
**`lighthouse.yml`** — triggers on pull requests to `main`
322+
- Builds the site and runs Lighthouse CI against 4 pages
323+
- Accessibility < 90 fails the check (error); performance, SEO,
324+
best practices < 90 warn
325+
- Reports uploaded as GitHub Actions artifacts
326+
- Permissions: `contents: read`
327+
- Config: `lighthouserc.json`
328+
329+
**CodeQL** — GitHub default setup (no workflow file)
330+
- Analyzes JavaScript/TypeScript and GitHub Actions
331+
- Results in Security tab → Code scanning alerts
311332

312333
**`deploy.yml`** — triggers on push to `main`
313-
- Same build steps, plus upload artifact and deploy to GitHub Pages
334+
- Same build steps as `build.yml`, plus upload artifact and deploy to
335+
GitHub Pages
314336

315337
### 2.11 Release process
316338

317339
Follow `docs/solid-ai-templates/base/git.md` release process:
318340
1. `git checkout -b chore/release-vX.Y.Z`
319-
2. `git commit --allow-empty -m "chore: release vX.Y.Z"`
320-
3. Push, open PR, merge
321-
4. `git checkout main && git pull`
322-
5. `git tag vX.Y.Z && git push origin vX.Y.Z`
341+
2. Bump `version` in `astro-site/package.json` to match
342+
3. Commit: `chore: release vX.Y.Z`
343+
4. Push, open PR, wait for CI, merge
344+
5. `git checkout main && git pull`
345+
6. `git tag vX.Y.Z && git push origin vX.Y.Z`
346+
7. `gh release create vX.Y.Z --title "vX.Y.Z" --notes "..."`
323347

324348
Tags use semver: `v1.0.0` (lowercase v, three segments).
325349

0 commit comments

Comments
 (0)