Commit Graph

704 Commits

Author SHA1 Message Date
Shayan Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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
Claude Routine 48f2cebeb8 chore(agent-collections): append 2026-05-08 changelog entry
https://claude.ai/code/session_01AQnxHc79GtLzgQ8YNC1yVs
2026-05-08 15:47:01 +00:00
Claude Routine 2442a21380 chore(agent-collections): update VoltAgent agents 145→144, refresh badge timestamp
https://claude.ai/code/session_01AQnxHc79GtLzgQ8YNC1yVs
2026-05-08 15:46:47 +00:00
Shayan Rais bcaa2ccac2 Merge branch 'main' of https://github.com/shanraisshan/claude-code-best-practice 2026-05-07 23:55:35 +05:00
Claude Routine 4671f03677 chore(agent-collections): scheduled refresh 2026-05-07 15:50:20 +00:00
Shayan Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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
Claude Routine 8931c73dd7 chore(agent-collections): scheduled refresh 2026-05-06 17:04:15 +00:00
Claude Routine 34f48b6b54 chore(agent-collections): scheduled refresh 2026-05-06 15:49:22 +00:00
Shayan Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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