From ea43f92c24125fc4a0ab1947d4da8602f7ce73ec Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Csaba=20Attila=20Bir=C3=B3?= Date: Sat, 28 Mar 2026 00:20:22 +0100 Subject: [PATCH] fix: update CLAUDE.md Architecture and Testing sections Add scripts/ directory to Architecture, update .github/ description to include workflows, and modernize Testing section with lint and install script references. --- CLAUDE.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) diff --git a/CLAUDE.md b/CLAUDE.md index 5a9d975..2720494 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -15,7 +15,8 @@ This repo follows the same Gitflow workflow described in SKILL.md. Apply the ski ## Architecture - **SKILL.md** — The entire skill definition. Self-contained installable artifact. Contains YAML frontmatter (`name`, `description`, `version`, `metadata`) followed by the complete workflow specification: branch model, commit format, issue-driven flow, semantic versioning, release process, and forbidden operations. -- **`.github/`** — PR template and issue templates (bug report, feature request). +- **`scripts/`** — Tooling: `lint.sh` (structural validation of SKILL.md), `install_linux.sh`, `install_macos.sh`, `install_windows.ps1` (platform-specific install/uninstall via symlink). +- **`.github/`** — PR template, issue templates (bug report, feature request), and GitHub Actions workflows (`lint.yml`, `close-linked-issues.yml`). ## Key Invariants @@ -33,12 +34,11 @@ When modifying SKILL.md, preserve these non-negotiable rules: - SKILL.md must remain **self-contained** — it is the installable artifact - The `description` field in frontmatter controls when Claude Code triggers the skill — keep trigger keywords updated if scope changes -- Keep version in sync between frontmatter `version`, `metadata.version`, and CHANGELOG.md +- Keep version in sync between frontmatter `version`, `metadata.version`, README.md badge, and CHANGELOG.md — run `./scripts/lint.sh` to verify ## Testing Changes -No automated tests. Manual verification: - -1. Copy updated `SKILL.md` to `~/.claude/skills/git-workflow/SKILL.md` -2. Start a new Claude Code session -3. Ask Claude to perform git operations and verify it follows the workflow +1. Run the linter: `./scripts/lint.sh` +2. Install the updated skill: `./scripts/install_linux.sh` (or platform equivalent) +3. Start a new Claude Code session +4. Ask Claude to perform git operations and verify it follows the workflow