diff --git a/.claude/commands/update-infos-release.md b/.claude/commands/update-infos-release.md index 62ffe60..b1281e6 100644 --- a/.claude/commands/update-infos-release.md +++ b/.claude/commands/update-infos-release.md @@ -96,6 +96,28 @@ echo "X.Y.Z" > VERSION - Reason: [major features added / significant updates / breaking changes in CC] ``` +### 4.5. Add RSS Entry (for notable CC releases) + +Add an entry to `src/data/rss-entries.ts` in the landing repo **only if** at least one of: +- Release has ⭐ feature(s) +- Release has breaking changes +- Release has ≥3 highlights + +If none of these → skip (patch/bugfix-only releases don't need an RSS entry). + +Entry format: +```typescript +{ + type: 'guide_release', + title: 'Claude Code vX.Y.Z', + date: 'Mon DD, YYYY', + description: '[1-2 sentences: main feature(s), plain text no HTML]', + link: 'https://cc.bruniaux.com/releases/#vX.Y.Z', +}, +``` + +Prepend at the top of the `rssEntries` array. + ### 5. Verify Synchronization ```bash diff --git a/CHANGELOG.md b/CHANGELOG.md index f4404df..ea632a6 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -6,6 +6,20 @@ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/). ## [Unreleased] +- **RSS Feed added to cc.bruniaux.com** (`landing: src/pages/rss.xml.ts`, `src/data/rss-entries.ts`): Unified RSS feed at `/rss.xml` merging Claude Code CLI releases and guide content updates (guide releases, new pages, new cards, new whitepapers). Auto-discovery `` tag in all page heads, RSS icon in footer and "More" nav dropdown, mention in announcement banner. Dedicated `rss-entries.ts` data file for manual guide entries. Workflow integrated in `/release` (step 6.5 auto-drafts entry) and `/update-infos-release` (step 4.5 for notable CC releases). Post-push hook in landing repo reminds to update `rss-entries.ts`. README updated with RSS link. + +- **Footer links fixed and expanded** (`landing: src/components/global/Footer.astro`): Architecture and Data Privacy now link to in-site guide reader (`/guide/core/architecture/`, `/guide/security/data-privacy/`) instead of GitHub raw files. Added missing pages: Recap Cards, AI Roles, Context, Ecosystem, FAQ. + +- **Sitemap updated** (`landing: src/pages/sitemap/index.astro`): RSS Feed entry added in Reference section. + +- **Fix — `/release` command updated with RSS step** (`.claude/commands/release.md`): Step 6.5 added — auto-drafts an `rss-entries.ts` entry from CHANGELOG after every release (patch included). Ensures feed stays current without manual effort. + +- **Fix — Hook format updated to new matcher+hooks[] structure** (`examples/config/settings.json`, `examples/claude-md/learning-mode.md`, `~/.claude/settings.json`): Claude Code now requires hooks to use `{"matcher": "...", "hooks": [{...}]}` instead of the old flat `{"matcher": "...", "command": "..."}` format. Updated all example files and global settings accordingly. + +- **New guide sections: Cross-Model Review, Lightweight Role-Switch, Task Sizing** (`guide/ultimate-guide.md`): Three gaps filled from resource evaluation gap analysis. (1) Cross-model review pattern after SE-CoVe section: generate with one model, review with another, with cost-effective patterns table and custom agent template. (2) Lightweight role-switch review as simpler alternative to SE-CoVe for everyday development. (3) Consolidated task sizing guidance in "Mixing Unrelated Tasks" section with splitting heuristic table and cross-reference to spec-first workflow. + +- **Resource Evaluation -- Ischenko "You're probably using Claude Code wrong"** (`docs/resource-evaluations/ischenko-claude-code-workflow-quality.md`): Score 2/5 (marginal, do not integrate). LinkedIn article proposing 7 workflow patterns (reality checks, author/reviewer separation, project-aware reviews, requirements artifacts, TDD, small tasks, human elevation) with copy-paste prompt templates. 75-85% overlap with existing guide content (SE-CoVe, spec-first.md, tdd-with-claude.md, exploration-workflow.md). Headline "30% quality improvement" claim has no methodology. Only non-redundant element: the 7 prompt templates, which are formatting convenience rather than new insight. Two independent gaps surfaced for future work: multi-model review pattern (near zero coverage in guide) and consolidated task sizing section. + - **Claude Code releases tracking updated to v2.1.79** (`machine-readable/claude-code-releases.yaml`, `guide/core/claude-code-releases.md`): `--console` flag for `claude auth login` (API billing auth), Show turn duration toggle in `/config`, VSCode `/remote-control` command + AI-generated session tab titles, fixed `claude -p` hanging without explicit stdin, enterprise 429 retry fix, SessionEnd hooks on `/resume` session switch, ~18MB startup memory improvement. - **Resource Evaluation — Multi-Session Management Landscape** (`docs/resource-evaluations/082-multi-session-management-landscape.md`): Score 4/5. Landscape overview of 13 tools across 4 categories for managing multiple Claude Code sessions across multiple projects. Monitoring dashboards: ccm (212 stars, TUI + mobile WebUI), sniffly (1 170 stars, analytics), claude-code-dashboard (token/cost per session). Remote access: vibetunnel (4 276 stars), cc-hub (color themes + file diffs). Orchestrators: claudio (22 stars, isolated worktrees + 14 color themes + planning modes), multi-agent-shogun (1 082 stars, tmux fan-out hierarchy). Sound/notifications: no packaged per-project audio solution — DIY via `settings.local.json` + `afplay` hook per project. Recommends integrating a "Multi-Session Management" section in the guide's third-party tools coverage. diff --git a/README.md b/README.md index ebd72d1..8be074b 100644 --- a/README.md +++ b/README.md @@ -870,7 +870,8 @@ See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines. ### Tools - [Ask Zread](https://zread.ai/FlorianBruniaux/claude-code-ultimate-guide) — Ask questions about this guide - [Interactive Quiz](./quiz/) — 271 questions -- [Landing Site](https://florianbruniaux.github.io/claude-code-ultimate-guide-landing/) — Visual navigation +- [Landing Site](https://cc.bruniaux.com) — Visual navigation, cheat sheets, ebooks, quiz +- [RSS Feed](https://cc.bruniaux.com/rss.xml) — Subscribe to guide updates, new content, and CC releases ---