Commit Graph
100 Commits
Author SHA1 Message Date
Shayan RaisandClaude 45b9682bf2 docs(readme): add CROSS-MODEL WORKFLOWS section with 4 repos (10k+ stars)
Insert new section between DEVELOPMENT WORKFLOWS and SKILL COLLECTIONS.
Seeds the table with musistudio/claude-code-router (34k Router),
router-for-me/CLIProxyAPI (32k Router), openai/codex-plugin-cc (18k
Plugin), and BeehiveInnovations/pal-mcp-server (12k MCP, formerly
zen-mcp-server). Re-home the existing Cross-Model methodology doc as
the section intro and drop the now-redundant bullet from Others.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-13 00:51:51 +05:00
Shayan RaisandClaude 30de4e491d chore(skill-collections): append 2026-05-13 entry for pbakaus/impeccable add
Record the manual addition of pbakaus/impeccable (27k stars, 1 SKILL.md
with 7 domain references) into the SKILL COLLECTIONS table — mirrors the
2026-05-01 entry pattern used when addyosmani/agent-skills was added.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-13 00:11:57 +05:00
Shayan RaisandClaude 3a12c8d01a chore(skill-collections): add pbakaus/impeccable (27k/1) and bump badge timestamp
Insert pbakaus/impeccable at row 4 of SKILL COLLECTIONS table (between
wshobson/agents 35k and addyosmani/agent-skills 27k). Note 1 SKILL.md
with 7 design domain references. Refresh badge to May 13, 2026 12:10 AM PKT.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-13 00:11:51 +05:00
Shayan Rais 2239d1ce04 Merge remote-tracking branch 'origin/main' 2026-05-12 23:51:39 +05:00
Shayan RaisandClaude 0bea2799c9 chore(skill-collections): append v2.1.139 changelog entry
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-12 23:51:27 +05:00
Shayan RaisandClaude b4be17d1e5 chore(development-workflows): append 2026-05-12 changelog entry — 19 updates across 11 repos
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-12 23:51:24 +05:00
Shayan RaisandClaude 7689cc1ec5 chore(concepts): append v2.1.139 changelog entry — Deep Links, Agent View, Goal
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-12 23:51:17 +05:00
Shayan RaisandClaude c7257504f4 chore(claude-subagents): append v2.1.139 no-drift changelog entry
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-12 23:51:15 +05:00
Shayan RaisandClaude 6504be55eb chore(claude-settings): append v2.1.139 changelog entry for env var bump
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-12 23:51:13 +05:00
Shayan RaisandClaude c6f74d84ae chore(claude-commands): append v2.1.139 changelog entry for 75→80 command count
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-12 23:51:10 +05:00
Shayan RaisandClaude 6246e968ea chore(claude-subagents): sync badge to v2.1.139 (no-drift)
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-12 23:51:04 +05:00
Shayan RaisandClaude aaeb69e5bc chore(claude-settings): bump env var count 175+→180+, badge to v2.1.139
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-12 23:51:02 +05:00
Shayan RaisandClaude e84f708484 chore(claude-commands): bump official command count 75→80, badge to v2.1.139
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-12 23:51:00 +05:00
Shayan RaisandClaude fe981aa0fa chore(readme): refresh tables + add Deep Links, Agent View, Goal concepts; badge to v2.1.139
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-12 23:50:53 +05:00
Shayan RaisandClaude d75361d54c log v2.1.139 no-drift entry in skills changelog
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-12 23:40:38 +05:00
Shayan RaisandClaude bd72ef06d3 sync skills report badge to Claude Code v2.1.139
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-12 23:40:32 +05:00
Shayan Rais 1f001b277c chore(agent-collections): scheduled refresh
- README badge: May 12, 2026 8:47 PM PKT
- AGENT COLLECTIONS table: msitarzewski 185→198, VoltAgent 145→189
- Changelog: 2026-05-12 08:47 PM PKT entry appended

https://claude.ai/code/session_01FaX9yzRQMqaoKgsLZBW1HU
2026-05-12 20:57:01 +05:00
Shayan RaisandClaude 4527f4d4e7 chore(readme): refresh Last Updated badge timestamp to 2026-05-11 10:36 AM PKT
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-11 10:37:35 +05:00
Shayan RaisandClaude 3a13ceaaef chore(readme): refresh Last Updated badge timestamp to 2026-05-10 11:26 PM PKT
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-10 23:27:06 +05:00
Shayan Rais 8430d237e2 chore(agent-collections): update README — badge to May 10 8:47 PM PKT; agent table ★ msitarzewski 95k→96k, VoltAgent 19k→20k 2026-05-10 21:10:30 +05:00
Shayan Rais c42f38d668 chore(agent-collections): append 2026-05-10 8:47 PM PKT changelog — msitarzewski ★ 95k→96k, VoltAgent ★ 19k→20k 2026-05-10 21:03:50 +05:00
Shayan Rais 95809f8a32 chore(agent-collections): scheduled refresh 2026-05-09 20:56:47 +05:00
Shayan RaisandClaude d86d1b070e chore(concepts): append 2026-05-09 7:58 PM same-day re-run entry
Records second v2.1.138 audit run within the day. README CONCEPTS table
unchanged between runs (no commits touched lines 22–68). Findings entirely
INVALID or ON HOLD: 1 spurious drift claim verified false (Tasks `/tasks`
command is real per claude-commands.md:75); 6 RECURRING-INVALID findings
re-flagged per durable user policy (platform surfaces, SDK-scoped pages,
sibling beta inconsistency); 1 ON HOLD (Voice Dictation page no longer
reads as beta but tag persists conservatively); 4 verifications COMPLETE.
No CONCEPTS table edits applied.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-09 20:07:37 +05:00
Shayan RaisandClaude db88ca0375 chore(readme): refresh Last Updated badge timestamp to 2026-05-09 7:58 PM PKT
Same-day timestamp refresh after the second concepts drift workflow run.
No table content changes — version still v2.1.138.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-09 20:07:30 +05:00
Shayan RaisandClaude f4e9c1d805 chore(skill-collections): append 2026-05-09 changelog entry
Two simultaneous rank swaps in one update — unusual: addyosmani 27k→37k
(+10k) overtakes wshobson (35k flat) for row 3; VoltAgent 20,933 overtakes
scientific 20,478 for row 5. Star surges: anthropics 127k→131k, mattpocock
51k→68k (+15k+ second consecutive surge — sustained external amplification).
Skill counts: mattpocock 18→19 (handoff/prototype promoted from in-progress),
wshobson 152→153 (brand-landingpage), addyosmani 21→22 (doubt-driven-
development), scientific 134→137 (+3 PRs), VoltAgent curated 930+→938.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-09 19:57:06 +05:00
Shayan RaisandClaude 9951de59f3 chore(development-workflows): append 2026-05-09 changelog entry
29 actions across 11 workflow repos, all COMPLETE: star bumps for Superpowers
(175k→184k), ECC (171k→176k), Spec Kit (92k→94k), gstack (88k→92k), GSD
(59k→61k), Matt Pocock (51k→67k, +16k single-run jump), BMAD (46k→47k),
OpenSpec (45k→47k), oh-my-claudecode (32k→33k). Material chain rewrites for
ECC (PRP-prefix family), Matt Pocock (rerank to row 5), BMAD (interleaved
agent-persona+task-skill chain), oh-my-claudecode (v4.13.x flow). Notable
methodology call-outs: ECC counts use README values despite 8th consecutive
directory-enumeration mismatch; Matt Pocock skills 22→13 from canonical
plugin.json install manifest excluding deprecated/in-progress.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-09 19:56:58 +05:00
Shayan RaisandClaude 138156ae11 chore(concepts): append 2026-05-09 v2.1.138 changelog entry
One HIGH COMPLETE (badge bumped to v2.1.138 / May 09 2026 7:02 PM PKT). Four
ON HOLD (worktree.baseRef, parentSettingsBehavior, --plugin-url, hard_deny —
deferred as compact rows or admin-tier fields not warranting CONCEPTS surface).
Eight INVALID (recurring-style /slash-commands redirect, missing standalone
rows for Output Styles/Sandboxing/Permission Modes/Headless/etc, Effort Levels,
Workflows row critique — all per established user policy). Five LOW
verifications confirmed all 35+ external URLs and 21 local file paths still
resolve.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-09 19:56:49 +05:00
Shayan RaisandClaude cf2035b4d0 chore(claude-subagents): append 2026-05-09 v2.1.138 no-drift changelog entry
All 16 frontmatter fields and 5 built-in agents match across the 12-version
window (v2.1.126 → v2.1.138). No add/remove changes to subagent surfaces.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-09 19:56:40 +05:00
Shayan RaisandClaude 7dbc6d95ac chore(claude-skills): append 2026-05-09 v2.1.138 no-drift changelog entry
Frontmatter fields (15) and bundled skills (6) fully synchronized with official
docs across the v2.1.126 → v2.1.138 window. No actionable drift.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-09 19:56:36 +05:00
Shayan RaisandClaude 278fde59da chore(claude-commands): append 2026-05-09 v2.1.138 changelog entry
Records four COMPLETE actions: 1 HIGH (added /radio at Config #12, count
75→76 with renumbering), 3 MED (signature refinements for /clear [name],
/review [PR], /context [all]).

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-09 19:56:31 +05:00
Shayan RaisandClaude d57bffb551 chore(agent-collections): append 2026-05-09 changelog entry
Records msitarzewski/agency-agents 185→186 oscillation as INVALID (within ±1
margin per prior 184–186 oscillation policy; per-directory enumeration sums to
172 vs Python crawl's 186, agent confidence 0.93). VoltAgent 144 confirmed as
real (per-category sum exact, prior 144↔145 oscillation resolved as content
change rather than pagination artifact). Star counts unchanged
(msitarzewski 95k, VoltAgent 19k); sort order preserved.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-09 19:56:26 +05:00
Shayan RaisandClaude da6a99b6cb chore(claude-subagents): bump version badge to v2.1.138
No drift detected on the two tracked dimensions — all 16 frontmatter fields
and 5 built-in agent types match official docs across the 12-version window.
Badge timestamp refreshed to May 09 2026 6:58 PM PKT.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-09 19:56:18 +05:00
Shayan RaisandClaude 296418438a chore(claude-skills): bump version badge to v2.1.138
No drift detected — frontmatter fields (15) and bundled skills (6) remain
fully synchronized with official docs across the v2.1.126 → v2.1.138 window.
Badge timestamp refreshed to May 09 2026 6:58 PM PKT.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-09 19:56:14 +05:00
Shayan RaisandClaude 6902a5df3f chore(claude-commands): add /radio + /rewind, refine /clear /review /context signatures, bump to v2.1.138
Insert /radio under Config tag (#12) — opens Claude FM lo-fi radio in browser,
prints stream URL when no browser is available; not on Bedrock/Vertex/Foundry.
Add /rewind under Session tag (#76) — checkpointing alias for /checkpoint and
/undo. Update three signatures with optional arguments: /clear → /clear [name]
(label previous conversation in /resume picker), /review → /review [PR]
(accept optional PR), /context → /context [all] (expand per-item breakdown).
Total grows 75 → 76 with renumbering. Badge to v2.1.138 / May 09 2026 6:58 PM
PKT.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-09 19:56:10 +05:00
Shayan RaisandClaude 9826dcb079 chore(readme): refresh tables — workflows star+command updates, skill collections rerank, badge to v2.1.138
DEVELOPMENT WORKFLOWS table: Superpowers (175k→184k, agents 5→0 after v5.1.0
removed superpowers:code-reviewer, +verification-before-completion step), ECC
(171k→176k, commands 143→71, skills 230→182, replaced chain with PRP-prefix
family), Spec Kit (92k→94k, dropped clarify, added checklist+taskstoissues),
gstack (88k→92k, skills 43→56, renamed implement→autoplan, +devex-review and
canary), GSD (59k→61k, +map-codebase entry and new-milestone final), Matt
Pocock (51k→67k, skills 22→13 from plugin.json manifest, rerank to row 5),
BMAD (46k→47k, agents 0→6 persona-skills, interleaved chain), OpenSpec
(45k→47k, +explore/verify/sync), oh-my-claudecode (32k→33k, commands 0→27 shim
files, replaced with v4.13.x flow), Compound Engineering (skills 39→38, new
strategy/debug/doc-review/product-pulse), HumanLayer (+research/describe-pr/
handoff). SKILL COLLECTIONS table: anthropics 127k→131k, mattpocock 51k→68k
(skills 18→19), wshobson skills 152→153, addyosmani 27k→37k (skills 21→22,
promoted to row 3), scientific 134→137, VoltAgent 20k→21k (curated 930+→938,
promoted to row 5). Badge to v2.1.138 / May 09 2026 7:06 PM PKT.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-09 19:56:00 +05:00
Shayan RaisandClaude cdd557059c chore(claude-settings): append 2026-05-09 v2.1.138 changelog entry
Records this run's drift triage: 14 HIGH actions COMPLETE (7 settings + 6 env
vars + version bump), 7 MED items ON HOLD (deferred per user scope), 2 INVALID
items (false-positive drift claims from agents).

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-09 19:55:39 +05:00
Shayan RaisandClaude d58615df07 chore(claude-settings): drift refresh to v2.1.138 — add 7 settings keys + 6 env vars
Bump report version badge and body header from v2.1.126 → v2.1.138 (12-version
gap). Add 7 settings keys: worktree.baseRef (v2.1.133), sandbox.bwrapPath /
sandbox.socatPath (v2.1.133, managed Linux/WSL), skillOverrides (v2.1.129),
parentSettingsBehavior (v2.1.133) and policyHelper (v2.1.136) in a new
"Dynamic & Parent-Tier Policy" subsection under Settings Hierarchy. Extend
autoMode description with the hard_deny array (v2.1.136). Add 6 new env vars
(CLAUDE_CODE_SESSION_ID, CLAUDE_CODE_DISABLE_ALTERNATE_SCREEN,
CLAUDE_CODE_FORCE_SYNC_OUTPUT, CLAUDE_CODE_PACKAGE_MANAGER_AUTO_UPDATE,
CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY,
CLAUDE_CODE_ENABLE_FEEDBACK_SURVEY_FOR_OTEL).

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-09 19:54:40 +05:00
Shayan Rais bcaa2ccac2 Merge branch 'main' of https://github.com/shanraisshan/claude-code-best-practice 2026-05-07 23:55:35 +05:00
Shayan RaisandClaude 924c72ad90 insert slide 29 Uncle Bob counterpoint + rename slides 28/29 to name-attributed pair
New slide 29 "Vibe Coding — Robert C. 'Uncle Bob' Martin" pairs with the
existing Karpathy slide as a thesis/antithesis on vibe coding before the
deck's synthesis at slide 30 (Vibe Coding vs Agentic Engineering).

Layout: 2-column CSS grid (45/55 split). Left: Uncle Bob image with the
same rounded corners + box shadow style as Karpathy's image on slide 28.
Right: 3-sentence summary (setup → mechanism → punchline), attribution
line ("Robert C. 'Uncle Bob' Martin — author of Clean Code · Clean
Architecture · co-author of the Agile Manifesto"), and source link
matching slide 28's source-link styling but left-aligned for the
right-column context.

The 3-sentence summary preserves Uncle Bob's arc: vibe coding is
hazardous for novices, LLMs are mathematical functions predicting next
tokens via matmul on internet/GitHub training data, and they are power
tools where novices lose fingers. Italicized closing quote sets it apart
as Uncle Bob's voice rather than the deck's voice.

Heading renames for parallel structure on the back-to-back voices:
- Slide 28 "Vibe Coding" → "Vibe Coding — Andrej Karpathy"
- Slide 29 (new) "Vibe Coding — A Skeptic's View" → "Vibe Coding —
  Robert C. 'Uncle Bob' Martin"

The earlier "skeptic's view" framing was authorial editorial; the new
name-attributed framing lets each voice speak on its own terms before
the deck stakes its synthesis position at slide 30.

Renumbering: former slides 29–55 shifted to 30–56. Total slide count
55 → 56. data-level distribution preserved.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-07 15:24:01 +05:00
Shayan RaisandClaude 3b848b7823 add vibe-coding-uncle-bob.png — image of Robert C. Martin's vibe coding critique
Used on the new slide 29 ("Vibe Coding — Robert C. 'Uncle Bob' Martin")
as the counterpoint pairing to slide 28's Karpathy origin tweet.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-07 15:23:41 +05:00
Shayan Rais b3f884f5e4 Update index.html 2026-05-07 12:57:35 +05:00
Shayan RaisandClaude 6718a977c7 reformat slides 11, 14, 15, 16 — heading-with-separator pattern + emoji prefixes
Slide 11 ("Tokens, not words"): heading and figcaption removed entirely —
now a pure-picture slide (just the OpenAI tokenizer screenshot at
max-width 1100px). The screenshot is self-titled (visible tokenizer UI
labels), so a slide heading was redundant. Flex-centering wrapper dropped.

Slide 14 ("💬 Models are stateless"): flex-centering wrapper dropped,
<h1> now uses default styling (no inline overrides) so it picks up the
deck's border-bottom separator. Dialog diagram retained with margin-top
adjusted for breathing room. The two-line caption strip ("Every turn is
a fresh API call." / "Memory only exists if the harness replays the
transcript.") preserved — it's the slide's conceptual punchline.

Slide 15 ("🦜 Stochastic Parrots"): the standalone large parrot emoji
that previously floated above the heading was merged into the heading
itself (matches the deck's emoji-prefix convention used by slides 14 and
17). <h1> uses default styling for the separator. Subtitle paragraph
preserved as the subheading below the separator.

Slide 16 ("🌡️ Even temperature = 0 isn't deterministic."): thermometer
emoji prepended to the heading, matching the emoji-prefix pattern. <h1>
uses default styling for the separator. Subtitle paragraph preserved as
the subheading.

All four slides now follow (or, in slide 11's case, deliberately depart
from) the canonical slide-17 heading-with-separator pattern. Slide count
unchanged at 55. No data-level changes. No SVG/asset modifications.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-07 12:54:29 +05:00
Shayan RaisandClaude 00116d393e reformat slides 12 and 13 to match slide 10 pattern; trim slide 12 heading
Slides 12 ("How an LLM tokenizes input") and 13 ("What the LLM actually
sees: integer token IDs") restructured to use the heading-with-separator
pattern modeled after slide 17 (and just-applied to slide 10):
- <h1> uses default styling (no inline overrides) → border-bottom separator
- Outer flex-centering wrapper dropped
- SVG-internal title promoted to slide heading; SVG-internal subtitle
  promoted to single-line bold caption
- Figure max-width: 860px → 1100px (slide 12); 960px → 1100px (slide 13)

Slide 12 heading shortened to "How an LLM tokenizes input" (was
"How an LLM tokenizes input and generates text autoregressively") — the
longer form was wrapping to two lines on a projector. Autoregressive
generation is already covered on slide 10; slide 12's caption makes
clear this slide's focus is tokenization specifically.

Slide 13 heading trimmed: "What the LLM actually sees: integer token IDs"
(dropped "(advanced view)" parenthetical — read as redundant scaffolding
in heading position).

Slide 13 caption: chose the comma-as-ID-11 line over the abstract
sequence-of-integers definition. The math notation from the SVG subtitle
was deliberately not promoted — it's been removed from the SVG entirely
(see paired commit b667fc5).

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-07 12:48:20 +05:00
Shayan RaisandClaude b667fc5234 restructure llm-animation-tokenids.svg for projector legibility
Same pattern as 13f7ca9 (llm-basic.svg). Title and subtitle removed from
the SVG; both promoted to the slide-level heading and caption on slide 13.
The math-notation subtitle (f: ℤᵏ → ℝⱽ ; next_id = argmax(f(ids))) was
removed entirely — not promoted anywhere, since it doesn't help PMs and
there's no good place for it after the bottom section was simplified to
a single line.

Iteration counter relocated from y=83 (top) to y=550 (bottom, just above
the feedback caption), font size 13 → 20.

Entire diagram shifted upward by 80px to reclaim the space freed by the
removed title and subtitle. Feedback path arc shifted accordingly:
M 1090 510 Q 680 568 270 510 → M 1090 430 Q 680 488 270 430. Feedback
caption pushed slightly: y=565 → y=575. Footnote about illustrative
response IDs shifted: y=588 → y=613.

ViewBox extended 600 → 630 at the bottom. Background rect height bumped
to 630 to match.

The decorative f: ℤᵏ → ℝⱽ label *inside* the LLM black box was preserved
as visual texture (too small to read at projector distance, just signals
"math is happening here") — distinct from the removed top subtitle.

All 7 <animate> blocks on iteration elements preserved verbatim.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-07 12:48:04 +05:00
Shayan RaisandClaude 33cd221a91 restructure llm-advanced.svg for projector legibility
Same pattern as 13f7ca9 (llm-basic.svg). Title and subtitle removed from
the SVG (now promoted to the slide-level heading and caption on slide 12).
Iteration counter relocated from y=83 (top) to y=480 (bottom, just above
the feedback caption), font size 13 → 20.

Entire diagram shifted upward by 80px to reclaim the space freed by the
removed title and subtitle (panels, LLM box, all token rows, arrows,
animated circles, output panel, feedback path control point).

ViewBox extended 540 → 570 at the bottom to accommodate the relocated
iteration counter. Background rect height bumped to 570 to match.
Feedback path arc shifted: M 990 410 Q 620 480 250 410 →
M 990 330 Q 620 400 250 330. Feedback caption stays at y=510 — the
upshift creates enough clearance.

All 7 <animate> blocks on iteration elements preserved verbatim.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-07 12:47:48 +05:00
Shayan RaisandClaude 40c302040d reformat slide 10 to match slide 17 pattern (heading + separator + content)
Slide 10 ("How an LLM generates text") restructured to use the deck's
canonical heading-with-separator pattern modeled after slide 17:
- <h1> uses default styling (no inline overrides) → gets the default
  border-bottom that acts as the separator
- Outer flex-centering wrapper dropped, matching slide 17's flat layout

Heading text changed from "One token at a time" → "How an LLM generates
text (autoregressive)" — promoted out of the SVG asset (which has been
trimmed to diagram-only in the paired commit).

Caption simplified to a single bold line: "Each predicted token is
appended to the input, then fed back into the LLM." (was previously the
SVG's subtitle). The secondary streaming/cost line is removed for focus.

Figure max-width increased 860px → 1100px (~28% larger) for projector
legibility — combined with the SVG's diagram-shifted-up restructuring,
the on-screen diagram is now roughly 2x the previous size.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-07 12:35:03 +05:00
Shayan RaisandClaude 13f7ca9e48 restructure llm-basic.svg for projector legibility
Title and subtitle removed from the SVG (now promoted to the slide-level
heading and caption). Iteration counter relocated from the top of the SVG
(y=85) to the bottom (y=480), just above the feedback caption, with font
size increased from 13 to 20 for projector readability.

The whole diagram (panels, LLM box, arrows, animated circles, feedback
path) shifted upward by 80px to reclaim the space freed by the removed
title and subtitle — the diagram now fills more of its viewBox rather
than leaving empty space at the top.

ViewBox extended 500 → 530 at the bottom to accommodate the relocated
iteration counter and pushed-down feedback caption (y=488 → y=510).
Background rect height bumped to 530 to match (otherwise the new bottom
strip would render transparent).

All 7 <animate> blocks on iteration elements preserved verbatim — only
the parent <text> y and font-size attributes changed.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-07 12:34:51 +05:00
Shayan RaisandClaude f50f4414f2 record presentation-claude-code Learnings from horse-teaser insertion
Agent self-update appending one Learnings bullet for the 2026-05-07 insert
of slide 9 "A horse. A model.": notes the stripped horse SVG composition,
the tightened viewBox (110 25 340 345 vs source's expanded -130 -50 780 450
that accommodated callouts), the etymology-line omission rationale, and a
regex-quirk for future integrity checks (CSS selector .slide[data-slide="1"]
matches naive data-slide="(\d+)" patterns — use <div[^>]+data-slide="(\d+)"
to scope to actual slide divs).

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-07 12:22:19 +05:00
Shayan RaisandClaude 6b93c44806 insert slide 9 "A horse. A model." — bare-horse teaser for the harness reveal
New slide plants the model-as-horse metaphor before the LLM mechanics arc
(slides 10–13: tokens, autoregression, IDs, statelessness). Stripped-down
version of the existing harness slide: horse body only, no harness elements,
no callouts. Two text lines:

  "A horse. A model."
  "The model is the horse. Raw power, no direction." (red)

The full harness reveal with all 5 callouts (Control loop, Tool allowlist,
Context management, Evaluator, State persistence) and etymology footnote
remains intact at its later position.

Mechanical changes:
- viewBox tightened to "110 25 340 345" (was wider to accommodate callouts)
- <defs> block dropped (no arrow markers needed without callouts)
- former slides 9–54 renumbered to 10–55 (the original harness slide moved
  from position 18 to 19)
- Total slide count: 54 → 55. data-level distribution preserved.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-07 12:21:48 +05:00
Shayan Rais 27df7ce8d0 reorder 2026-05-07 12:15:12 +05:00
Shayan RaisandClaude a3f84f446f insert slide 14 "What the model actually sees" with token IDs visualization
New slide goes one level deeper than slide 13 — shows the integer token IDs
the model actually receives, not just the colored subword tiles. Uses
llm-animation-tokenids.svg with figure max-width 960px (vs 860px for the
narrower LLM SVGs) since the asset's viewBox is 1360×600.

Caption translates the math notation deliberately left in the SVG:
- "The model never reads text — it reads a sequence of integers, each one
  an index into a vocabulary of ~200,000 entries."
- "Notice the comma is always ID 11 — the same punctuation mark maps to
  the same integer, everywhere, every time."

Renumbering: former slides 14–53 shifted to 15–54. Total slide count
53 → 54. data-level distribution preserved.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-07 11:59:09 +05:00
Shayan RaisandClaude 9a2657c431 add llm-animation-tokenids.svg — advanced tokenization view with integer IDs
Animated SVG showing what the LLM actually receives: integer token IDs (one
layer deeper than llm-advanced.svg). Each of the 32 input tokens displays the
ID prominently with the token text in small italic underneath (e.g., 28133
"Does", 17554 " Chat", 162016 "GPT", 97481 " Claude", 29683 " Anth", 71571
"ropic"). Same 7-iteration autoregressive loop; generated tokens also shown
as IDs. Vocab size labeled V ≈ 200,000. Title formula: f: ℤᵏ → ℝⱽ;
next_id = argmax(f(ids)). ViewBox 1360×600 (wider than the other LLM SVGs).

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-07 11:58:57 +05:00
Shayan RaisandClaude 73da14473e insert 3 LLM intro slides at positions 11–13 in claude-code-best-practice deck
New slides introduce LLM fundamentals before the Claude Code content for a PM
and beginner-technical audience:
- Slide 11 "One token at a time" — autoregressive generation (llm-basic.svg)
- Slide 12 "Tokens, not words" — tokenization basics (tokens.jpg)
- Slide 13 "Tokens in, tokens out" — combined view (llm-advanced.svg)

Renumbering: former slides 11–50 shifted to 14–53 by incrementing data-slide
attributes and updating SLIDE-N banner comments. data-level groupings
(agents/claude-md/skills/context/workflow) preserved. Total slide count
50 → 53. Asset path: ../assets/llm/.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-07 11:45:27 +05:00
Shayan RaisandClaude a05c791c41 add llm-advanced.svg — combined BPE tokenization + autoregressive diagram
Animated SVG showing the same BPE-tokenized prompt from tokens.jpg (32 colored
subword tiles, e.g., "Anthropic" → "Anth"+"ropic", "Perplexity" →
"Per"+"plex"+"ity") feeding into the LLM and generating "Yes, they all use
BPE." token-by-token across 7 iterations. Combines tokenization and
autoregressive generation into one view.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-07 11:45:16 +05:00
Shayan RaisandClaude faa82716b0 add tokens.jpg — OpenAI tokenizer screenshot for tokenization slide
Screenshot of platform.openai.com/tokenizer showing the sentence "Does ChatGPT,
Claude, Anthropic, Llama, Mistral, Gemini, and Perplexity all use Byte-Pair
Encoding (BPE)?" tokenizing to 32 tokens / 105 characters. Visible tabs:
GPT-5.x & O1/3, GPT-4 & GPT-3.5 (legacy), GPT-3 (legacy) — illustrates that
different model generations use different tokenizers.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-07 11:45:09 +05:00
Shayan RaisandClaude e53739367a add llm-basic.svg — animated autoregressive generation diagram
Three-panel SVG (input context, LLM black box, predicted next token) with
7-iteration loop generating "The capital of Japan is Tokyo." from the prompt
"What is the capital of Japan?". Includes purple feedback loop showing each
predicted token appended back into the input.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-07 11:45:00 +05:00
Shayan RaisandClaude a56ea4a3c7 update README badge to Claude Code v2.1.128 (May 05, 2026 9:33 PM PKT)
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-05 21:34:24 +05:00
Shayan RaisandClaude b28a0aa996 add agent-collections changelog with first-run entry — captures star and count drift for msitarzewski/agency-agents (92k→93k, 206→197) and VoltAgent/awesome-claude-code-subagents (148→144)
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-05 21:31:16 +05:00
Shayan RaisandClaude 724c58b351 add /workflows:agent-collections slash command mirroring skill-collections workflow — researches AGENT COLLECTIONS repos in parallel, appends changelog, updates last-updated badge
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-05 21:31:00 +05:00
Shayan RaisandClaude 2773d6e2c4 update README: bump badge to May 05 9:20 PM PKT, register /workflows:agent-collections at #3 in workflow registry, resize Videos/Presentations thumbnails 300→240px (80%)
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-05 21:30:54 +05:00
Shayan RaisandClaude cb8bb58ea4 add AGENT COLLECTIONS section with msitarzewski/agency-agents and VoltAgent/awesome-claude-code-subagents (10k+ stars)
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-04 22:43:01 +05:00
Shayan RaisandClaude 2cc8d4b889 add slide on temperature=0 nondeterminism and Source: footers to slides 7, 9, 10, 15, 23, 46
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-04 19:34:53 +05:00
Shayan RaisandClaude 776acb6a0a add video-2.png tile to Videos section linking to youtu.be/lPjhM6BBK0Q
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-03 22:25:09 +05:00
Shayan RaisandClaude 8891d88031 add video-2.png thumbnail
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-03 22:25:06 +05:00
Shayan Rais edec436626 karparthy 2026-05-03 22:03:46 +05:00
Shayan RaisandClaude 58e9c35084 update README badge timestamp to May 03, 2026 9:59 PM PKT
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-03 22:01:13 +05:00
Shayan Rais 64fffd53a7 karparthy added 2026-05-02 16:56:40 +05:00
Shayan RaisandClaude 3126a0ef05 add Matt Pocock to Subscribe X handles list
Insert the Matt Pocock entry between Lex Christopherson (GSD) and
Dani Avila (CC Templates) in the SUBSCRIBE -> Community section,
keeping the dev-workflow-creators cluster intact. Links to his X
handle and the Skills repo (51k stars, already referenced in the
videos table and the development-workflows table).

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-02 15:49:03 +05:00
Shayan RaisandClaude 79d42d5dd1 unbold "community" in WhatsApp banner SVG
Split the first bold tspan so only "Claude Pakistan" remains bold;
"community" now renders in normal weight while "WhatsApp" stays
bold. Aria-label and title are unchanged.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-02 15:48:58 +05:00
Shayan RaisandClaude 21b441268a update video.psd thumbnail source
Photoshop source file refreshed alongside the new
presentation-1.png export.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-02 15:41:51 +05:00
Shayan RaisandClaude 814fcd0c56 add Videos and Presentations sub-sections to How to Use
- Promote the existing YouTube thumbnail under a new
  `**🎬 Videos**` bold sub-heading
- Add a new `**📊 Presentations**` bold sub-heading with a
  thumbnail (presentation-1.png, width 300 to match the video
  thumbnail) linking to the GDG Kolachi "Claude Code & Gemini CLI"
  deck on GitHub (tree view of
  presentation/2026-04-25-gdg-kolachi-cli-claude-code-gemini/)
- Heading style follows the bold-inline `**Heading**` pattern
  from the existing Specs & Documentation sub-section, with
  emojis matching the repo's category-icon convention

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-02 15:41:48 +05:00
Shayan RaisandClaude 1e8a5e53bd add presentation-1.png thumbnail
GDG Kolachi "Claude Code & Gemini CLI" presentation thumbnail used by
the new How to Use → Presentations sub-section in README.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-02 15:41:41 +05:00
Shayan RaisandClaude e9b36f7d6c rework How to Use section into 7-step guide and add TIP callout
- Replace small how-to-use badge with new HD variant inside a `##`
  heading and add explicit <a id="how-to-use"></a> anchor for
  reliable linking from elsewhere in the README
- Expand the numbered list from 3 code-block lines to 7 markdown
  bullets with parallel imperative leads and clickable cross-refs
  to the Hooks repo, Agent Teams implementation, Tips section,
  Subscribe section, and the new advanced-topics bullet pointing
  at the Hot sub-table and the Ralph Wiggum implementation
- Add `[!TIP]` callout between the Boris Cherny block and the
  CONCEPTS heading, directing readers to the How to Use section
- Rename three occurrences of shanraisshan/novel-llm-26 to
  shanraisshan/ralph-wiggum-self-evolving-loop (CONCEPTS Hot row,
  Development Workflows Others list, Tips and Tricks row)
- Refresh updated_with_Claude_Code badge timestamp to
  May 02, 2026 3:17 PM PKT (version unchanged at v2.1.126)

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-02 15:21:10 +05:00
Shayan RaisandClaude c45bcfc50d add HD How to Use badge SVG
144x40 variant of how-to-use.svg with shimmer animation, matching the
orchestration-workflow-hd pattern but keeping the original green fill
(#2ea44f). Used by the How to Use section heading in README.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-02 15:21:04 +05:00
Shayan RaisandClaude cd4f08251a delete second-most-starred badge SVG
No longer referenced from README after the previous commit.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-02 14:33:36 +05:00
Shayan RaisandClaude 80433d9d21 remove 2nd-most-starred badge reference from README header
Drops the !/root/second-most-starred.svg image from line 4. The next
commit deletes the SVG file itself.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-02 14:33:28 +05:00
Shayan RaisandClaude 0fb01c1cc3 add Design and Agent SDK rows to STARTUPS / BUSINESSES table
- Design vs Figma, Framer, Sketch, v0 (creative-tool tier disruption)
- Agent SDK vs LangChain, LangGraph, CrewAI, AutoGen, OpenAI Assistants
  API (orchestration-framework tier disruption)

Inserted between Plan Mode and Skills/Plugins so the catch-all
"YC AI wrapper startups" row remains the table's editorial closer.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-02 14:31:30 +05:00
Shayan Rais efc8cde886 does code matter? 2026-05-02 13:56:55 +05:00
Shayan RaisandClaude 18472ad565 add Matt Pocock to videos table and vertical-slices tip to Planning
- New row in Videos/Podcasts table for the 24 Apr 2026 workshop,
  using the new community-matt.svg badge and linking to the local
  transcript file
- New Planning/Specs tip on vertical slices vs horizontal phasing
  (tracer bullets from Pragmatic Programmer); placed adjacent to
  Dex's phase-wise plan tip as a contrasting refinement
- Bumped section count Planning/Specs (6) -> (7) and master count
  TIPS AND TRICKS (82) -> (83)

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-02 13:23:04 +05:00
Shayan RaisandClaude a5d5c5732b add Matt Pocock workshop transcript (24 Apr 2026)
Full Walkthrough: Workflow for AI Coding (~2 hour conference workshop).
Covers grill-me alignment skill, smart/dumb zone theory, vertical
slices/tracer bullets, AFK Ralph loops, deep vs shallow modules
(Ousterhout), TDD red-green-refactor, and Sand Castle parallel agent
orchestration.

Organized into 17 topical sections instead of timestamped paragraphs
since the auto-transcript didn't include time anchors.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-02 13:22:57 +05:00
Shayan RaisandClaude b584173fad add Matt community badge SVG
Yellow community-palette badge (#f1c40f) for Matt Pocock, structured
identically to community-dex.svg/community-shayan.svg. Width 40px to
fit the 4-character "Matt" label.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-02 13:22:50 +05:00
Shayan RaisandClaude 060bd697ce add 50k stars celebration thumbnail
Pixel-art mascot raising a waving Pakistani flag, GitHub-flavored
50,000+ stars banner with shimmer/glow, tagline reset to vibe-coding-to-agentic-engineering line, tab title set to "50k stars on GitHub".

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-02 12:19:00 +05:00
Shayan Rais 41f503c913 Update README.md 2026-05-01 22:50:29 +05:00
Shayan RaisandClaude f75bd499ec add /workflows:skill-collections row to Developed by table; renumber subsequent rows
Insert as row 2 alongside /workflows:development-workflows so the two top-level table-updater workflows sit together at the top, with the five best-practice/* drift-detector workflows stacked below as rows 3-7.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-01 18:01:19 +05:00
Shayan Rais fccaa0fd90 updated tweets 2026-05-01 17:25:10 +05:00
Shayan RaisandClaude ca7e155c29 add Extras section with 5 affiliation/community banners; move Star History above Other Repos
- group the 4 affiliation banners (Claude for OSS, Community Ambassador, Certified Architect, Anthropic Academy) and the new WhatsApp community-invite banner under a new "## Extras" heading
- relocate Star History section from below Developed by to between the March 2026 trending image and Other Repos so the chart anchors a "trending → growth → other repos" narrative

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-01 17:24:25 +05:00
Shayan RaisandClaude 9876143d63 add WhatsApp banner SVG for Claude Pakistan community invite
420x32 badge styled after badge-top-poster.svg pattern: WhatsApp green (#25D366) background, white WhatsApp logo on the left, Verdana text reading "Join Claude Pakistan community on WhatsApp" with the community name and platform name in bold.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-01 17:24:18 +05:00
Shayan RaisandClaude b079499311 strip prose from CONCEPTS + Hot table Description columns; cluster Scheduled Tasks → Routines → Tasks rows
- keep only tags and named hyperlinks in the Description column across both tables
- drop /schedule link that pointed to /routines (text/URL mismatch surfaced once prose was removed); /schedule is still listed as a keyword in the Scheduled Tasks Location column and Routines has its own row
- move Routines next to Scheduled Tasks and Tasks so the umbrella → cloud surface → tracking trio reads in adjacency

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-01 16:50:36 +05:00
Shayan RaisandClaude 60f6831ddd log v2.1.126 settings workflow run with 14 actions
Appends a new dated entry (2026-05-01 03:29 PM PKT) for the Claude Code v2.1.126 settings update:
- 9 COMPLETE: version-bump, 3 new keys (preferredNotifChannel, ANTHROPIC_BEDROCK_SERVICE_TIER, CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST), enriched bypassPermissions/defaultShell/spinnerTipsOverride descriptions, /config persistence note, Quick Reference example refresh
- 2 ON HOLD: OTEL_LOG_TOOL_DETAILS and OTEL_LOG_TOOL_CONTENT (changelog-only, recurring 16+ runs)
- 3 INVALID: spurious drift claims from research agent (autoSummaryEnabled non-existent, Agent(agent:name) prefix unverified, descriptive defaults flipped to "-" with no user benefit)

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-01 16:15:49 +05:00
Shayan RaisandClaude 27ff6b6c9b update settings report to Claude Code v2.1.126
Adds three new keys documented on the official settings/env-vars pages:
- preferredNotifChannel (Display Settings) — task-complete/permission notification channel with 7 enum values; default "auto" sends desktop notifications in iTerm2/Ghostty/Kitty
- ANTHROPIC_BEDROCK_SERVICE_TIER (Env Vars, v2.1.122) — Bedrock service tier (default/flex/priority) sent as X-Amzn-Bedrock-Service-Tier header
- CLAUDE_CODE_PROVIDER_MANAGED_BY_HOST (Env Vars, v2.1.126) — set by embedding host platforms; provider/auth env vars in settings.json are ignored when set

Enriches existing descriptions for v2.1.126 behavior changes:
- bypassPermissions exemption extended to .claude/, .git/, .vscode/, and shell config files
- defaultShell: PowerShell becomes primary shell when CLAUDE_CODE_USE_POWERSHELL_TOOL=1; PowerShell 7 detection covers Microsoft Store, MSI off-PATH, and .NET global tool installs
- spinnerTipsOverride.excludeDefault now also suppresses time-based tips (v2.1.121)
- /config now persists changes to ~/.claude/settings.json (v2.1.126)

Quick Reference example showcases the new keys.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-01 16:15:40 +05:00
Shayan RaisandClaude 438df7fd89 log 2026-05-01 dev workflows update: add addyosmani/agent-skills row
User-requested addition of addyosmani/agent-skills (27k stars / 3 agents / 7 commands / 21 skills) at row 10, between oh-my-claudecode (32k) and Compound Engineering (16k). Workflow chain: /spec → /plan → /build → /test → /review → /ship (DEFINE → PLAN → BUILD → VERIFY → REVIEW → SHIP lifecycle). Cross-listed in skill-collections table for its SKILL.md library.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-01 16:12:51 +05:00
Shayan RaisandClaude bec6e073a3 log 2026-05-01 skill collections updates: 4 star bumps + agent-skills add
Two dated entries appended:
- 03:31 PM PKT: 4 star refreshes from research-agent run (anthropics +2k, mattpocock +15k, wshobson +1k, voltagent +1k)
- 04:05 PM PKT: user-requested addition of addyosmani/agent-skills (27k/21) at row 4

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-01 16:12:45 +05:00
Shayan RaisandClaude 2902a7195c add addyosmani/agent-skills to skill-collections + dev-workflows tables, refresh stars and badge
skill-collections: bump anthropics 125k→127k, mattpocock 36k→51k, wshobson 34k→35k, voltagent 19k→20k; insert agent-skills row (27k/21) at row 4
dev-workflows: insert agent-skills row (27k/3 agents/7 commands/21 skills) at row 10 with /spec → /plan → /build → /test → /review → /ship chain
badge: refresh timestamp to May 01 2026 4:05 PM PKT

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-01 16:12:40 +05:00
Shayan RaisandClaude 33e4a85b50 log v2.1.126 concepts workflow run with 3 ON HOLD v2.1.122-126 features
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-01 16:00:37 +05:00
Shayan RaisandClaude 137e5719fc sync README badge to Claude Code v2.1.126
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-01 16:00:30 +05:00
Shayan RaisandClaude 4aae095313 log v2.1.126 no-drift entry in skills changelog
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-01 15:59:40 +05:00
Shayan RaisandClaude 0d4fecdddf sync skills report badge to Claude Code v2.1.126
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-01 15:59:37 +05:00
Shayan RaisandClaude 57b0ad2607 log v2.1.126 commands workflow run — clean, no priority actions
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-01 15:58:40 +05:00
Shayan RaisandClaude 87086745da sync commands report badge to Claude Code v2.1.126
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-01 15:58:37 +05:00
Shayan RaisandClaude f0388e31c9 log v2.1.126 no-drift entry in subagents changelog
Records the 2026-05-01 workflow run. No frontmatter or built-in agent
changes vs the v2.1.121 baseline.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-01 15:58:30 +05:00