Commit Graph
100 Commits
Author SHA1 Message Date
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
Shayan RaisandClaude 484490711c sync subagents report badge to Claude Code v2.1.126
No schema drift on tracked dimensions (16 frontmatter fields, 5 built-in
agents). Routine version-bump from v2.1.121.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-01 15:58:26 +05:00
Shayan RaisandClaude 2c18c5d3be record etymology mirror and cross-deck consistency rule in GDG agent learnings
Adds a Learnings entry to the GDG presentation agent capturing
(1) the etymology line just added to slide 13, (2) the actual
data-slide value of the horse-harness analogy slide in this deck so
future cross-deck syncs can reference it, and (3) a forward-looking
rule for cross-deck mirroring: when an edit lands on the sister
best-practices deck and the same slide exists here (i.e. inherited
from the original fork), evaluate whether to mirror — generic content
mirrors cleanly, event-specific content does not. Also notes that
slides should be located by content, not by trusting "slide N", since
post-fork drift can shift numbering between the two decks.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-30 23:31:42 +05:00
Shayan RaisandClaude 796b99f2a2 mirror "harness" etymology footnote onto GDG deck slide 13
Adds the same Old French etymology line ("The origin is Old French
harneis — gear, equipment, armor.") that was added to the canonical
best-practice deck, so the horse-harness analogy slide reads
identically across both decks. The line sits below the existing red
subtitle as a muted footnote (0.95rem, #666), with `text-align:
center` added for this deck because the GDG caption block relies on
flex centering rather than inherited text alignment.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-30 23:31:32 +05:00
Shayan Rais 76599cbee4 updated presentation 2026-04-30 23:25:04 +05:00
Shayan RaisandClaude 4fff87c29c record Models-are-stateless insert and sentinel double-increment fix in agent learnings
Adds a Learnings entry for the 2026-04-30 slide-10 insert: documents
the styled-HTML approach chosen (no PNG asset existed for this dialog),
the slide-12 caption-strip pattern reuse, and a postmortem for the
sentinel-replacement collision where pre-resolving ##S10## to "11" before
running the n=11..48 loop double-incremented old-slide-10 to "12". Adds
two forward-looking rules: (1) use distinct sentinel prefixes or
single-pass resolution when mixing pre-resolved and loop-resolved slides,
and (2) check raw file content for literal apostrophes vs HTML entities
when pattern-matching comment strings.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-30 22:25:46 +05:00
Shayan RaisandClaude 9d54f16c84 insert "Models are stateless" slide at position 10 in best-practice deck
Adds a styled-HTML dialog diagram (User vs Model bubbles, dashed amber
divider labeled "new session — context wiped", and a two-line caption
strip) to make the stateless behavior of LLMs visible. Drawn rather than
imported as PNG, mirroring slide-12's inline-diagram conventions. Old
slides 10..48 shifted to 11..49 via sentinel-replacement; banner
comments updated in the same pass to keep the deck's zero-drift state.
No new CSS classes — all layout via inline styles consistent with
surrounding slides.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-30 22:25:39 +05:00
Shayan RaisandClaude 83d5583d33 record GDG slide-14 removal and cross-deck divergence in agent learnings
Appends a Learnings entry to the presentation-claude-gemini agent capturing
the 2026-04-30 removal of "How the Harness Reaches the World" from the GDG
deck and the deliberate-divergence framing — the slide lives on in the
forked claude-code-best-practice deck but is gone from the GDG historical
record because it was added post-event.

Future runs by this agent will know why the two decks differ on this slide
and won't try to "reconcile" them.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-30 18:54:46 +05:00
Shayan RaisandClaude 71d0b51657 remove "How the Harness Reaches the World" slide from GDG event deck
The slide titled "Tool Calling" / "How the Harness Reaches the World" was
added to the deck after the GDG Kolachi event on Apr 25, 2026, so it doesn't
belong in the historical record of what was actually presented. Reverting
the GDG deck to as-presented state.

The slide is preserved in the new claude-code-best-practice fork (which is
the canonical living reference owned by presentation-claude-code), so no
content is lost overall — this is a deliberate divergence between the two
decks.

Slide had no data-level, so the journey bar is structurally unaffected.
Renumbered slides 15..53 → 14..52 via sentinel-replacement. Final count: 52.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-30 18:54:39 +05:00
Shayan RaisandClaude e5d3329412 add presentation-claude-code agent to delegation routing table
Updates the per-presentation delegation rule to route requests on the new
"Claude Code Best Practice" deck to the new presentation-claude-code agent.
Previously the table had only two decks (vibe-coding, claude-gemini); now
all three are listed with explicit path → agent mapping and an invocation
example.

Adds clarification that "the main presentation" or "the best-practice deck"
generally refers to the new claude-code agent.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-30 18:54:29 +05:00
Shayan RaisandClaude bb6d1083a8 add presentation-claude-code agent for the canonical best-practice deck
New per-deck agent owns presentation/claude-code-best-practice/index.html.
Mirrors the per-presentation pattern of presentation-claude-gemini and
presentation-vibe-coding — each deck has its own focused knowledge base
that self-evolves without cross-contaminating the others.

Seeded with structural facts about this deck specifically (no journey bar,
no hardcoded goToSlide(N) calls, simpler than the GDG fork) and a fresh
Learnings section starting at the 2026-04-30 fork date — GDG agent's 25+
historical entries deliberately not copied since most are tied to features
this deck doesn't have.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-30 18:54:23 +05:00
Shayan RaisandClaude eb74fba922 add claude-code-best-practice deck — canonical reusable fork from GDG event deck
Forked from presentation/2026-04-25-gdg-kolachi-cli-claude-code-gemini/index.html
on 2026-04-30 to serve as the ongoing main reference deck. Renamed and decoupled
from GDG/Gemini-specific branding:

- title tag, slide-1 H1, subtitle, and HTML banner all read "Claude Code Best Practice"
- favicon swapped from gemini-jumping.svg to claude-jumping.svg
- right-corner global Gemini mascot removed (left Claude mascot kept)
- GDG event badge replaced with neutral GitHub repo badge
- four trailing Gemini-comparison slides removed (49, 50, 51, 52)
- co-presenter intro slide removed
- inline <!-- SLIDE N: ... --> banners fully repaired (1:1 with data-slide values)

Final deck: 48 slides ending with "Thank you" closing slide.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-30 18:54:15 +05:00
Shayan RaisandClaude 6f45aa5b8c log 2026-04-29 skill-collections update — star/count refresh and rank swap
Records mattpocock/skills bumps (★ 33k→36k, skills 17→18) overtaking
wshobson/agents (★ 35k→34k), plus VoltAgent curated count correction
(1,100+ → 930+ per actual README parse). anthropics/skills and
K-Dense-AI/scientific-agent-skills unchanged.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-29 01:24:12 +05:00
Shayan RaisandClaude 5168274ffc log 2026-04-29 concepts run for v2.1.121 — 13 actions completed, 1 INVALID
Records README CONCEPTS table updates for Subagents (CLAUDE_CODE_FORK_SUBAGENT),
Hooks (updatedToolOutput), MCP Servers (alwaysLoad), Settings (Auto Mode Config
inline link), and Ultrareview (claude ultrareview subcommand). The recurring
/slash-commands stale URL claim remains INVALID per long-standing user decision.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-29 01:24:09 +05:00
Shayan RaisandClaude 24e09ca3c0 log 2026-04-29 claude-subagents run for v2.1.121 — out-of-scope xhigh enum update
No drift on the two tracked dimensions (16 frontmatter fields, 5 built-in
agents). Records the user-requested enum value addition (xhigh) to the effort
field description.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-29 01:24:00 +05:00
Shayan RaisandClaude 91679e2a21 log 2026-04-29 claude-skills run for v2.1.121 — fewer-permission-prompts added
Records promotion of fewer-permission-prompts from changelog-only to bundled
skills table, with /en/commands as the authoritative source over /en/skills.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-29 01:23:58 +05:00
Shayan RaisandClaude 2c40369f4d log 2026-04-29 claude-settings run for v2.1.121 — 13 actions completed, 2 ON HOLD
Records the v2.1.121 settings update: alwaysLoad, sshConfigs, status line
fields, ~/.claude.json → settings.json file-scope migration, AI_AGENT and
OTEL_LOG_USER_PROMPTS env vars, bypassPermissions exemption, /effort xhigh,
\${CLAUDE_EFFORT}, and broken auto-mode anchor links. OTEL_LOG_TOOL_DETAILS
and OTEL_LOG_TOOL_CONTENT remain ON HOLD per Rule 8A/10B.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-29 01:23:52 +05:00
Shayan RaisandClaude a43dcd783a log 2026-04-29 claude-commands run for v2.1.121 — no drift
15 frontmatter fields and 75 built-in commands fully synchronized.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-29 01:23:48 +05:00
Shayan RaisandClaude 7188f7d5c3 update README CONCEPTS and SKILL COLLECTIONS for v2.1.121 + late-April research
CONCEPTS table:
- Subagents: forked subagents on external builds via CLAUDE_CODE_FORK_SUBAGENT=1 (v2.1.117)
- Hooks: PostToolUse can replace tool output via hookSpecificOutput.updatedToolOutput (v2.1.121)
- MCP Servers: alwaysLoad bypasses tool-search deferral (v2.1.121)
- Settings: add Auto Mode Config inline link
- Ultrareview: claude ultrareview [target] non-interactive subcommand with --json/--timeout (v2.1.120)

SKILL COLLECTIONS table:
- mattpocock/skills star bump 33k → 36k, skill count 17 → 18
- wshobson/agents star drop 35k → 34k
- rank swap: mattpocock/skills now ranks above wshobson/agents
- VoltAgent/awesome-agent-skills curated count corrected 1,100+ → 930+ (badge overstates)

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-29 01:23:42 +05:00
Shayan RaisandClaude d603374adc add xhigh to effort field enum in claude-subagents report (v2.1.121)
Mirrors the v2.1.91 pattern when auto was added to permissionMode — the field
description now lists low / medium / high / xhigh / max to match official docs.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-29 01:23:29 +05:00
Shayan RaisandClaude 707c390927 add fewer-permission-prompts to bundled skills table and bump to v2.1.121
Promoted from /en/commands canonical reference (the Skills Reference prose at
/en/skills still undercounts at 5). Count updated 5 → 6.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-29 01:23:27 +05:00
Shayan RaisandClaude 358192b4c7 update claude-settings report for v2.1.121 — alwaysLoad, sshConfigs, status line fields, file scope migration
- new MCP Per-Server Tool Loading subsection (alwaysLoad + per-tool _meta variant)
- new Workspace & Teams subsection covering sshConfigs
- Display Settings table: 5 keys migrated from ~/.claude.json to settings.json (autoScrollEnabled, editorMode, showTurnDuration, teammateMode, terminalProgressBarEnabled) with v2.1.119 historical note
- Status Line Input Fields table: add effort.level and thinking.enabled (v2.1.121)
- bypassPermissions row notes new .claude/* write exemption (v2.1.121)
- language description now mentions terminal tab title (v2.1.121)
- /effort row updated to list xhigh and max
- Effort Level Note adds \${CLAUDE_EFFORT} skill template variable (v2.1.120)
- env vars: AI_AGENT (v2.1.120) and OTEL_LOG_USER_PROMPTS (v2.1.121)
- fix two relative auto-mode anchor links to absolute URLs
- Quick Reference example showcases mcpServers.alwaysLoad and sshConfigs

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-29 01:23:17 +05:00
Shayan RaisandClaude 5995266a66 bump claude-commands report version badge to v2.1.121
Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-29 01:23:04 +05:00
Shayan Rais fce29a943c log 2026-04-29 development-workflows update — 15 actions completed, 3 ON HOLD
18-row entry covering 7 star updates, 3 skill counts, 5 workflow reworks. ON HOLD: ECC counts (6th run), GSD commands 122→86 (5th run), oh-my-claudecode skills 46→38 (2nd run) — all keeping baseline pending manual verification.
2026-04-29 01:09:53 +05:00
Shayan Rais 3b24a43aa8 update DEVELOPMENT WORKFLOWS table — 7 star bumps, 3 skill counts, 5 workflow reworks
- Star: Superpowers 168k→171k, ECC 167k→169k, Spec Kit 91k→92k, gstack 84k→86k, GSD 57k→58k, OpenSpec 43k→44k, oh-my-claudecode 31k→32k
- Skills: gstack 41→42, BMAD 39→40, Matt Pocock 16→22
- Workflow: Spec Kit +/speckit.clarify; Superpowers +using-git-worktrees; Matt Pocock rework (+/triage, +/diagnose, +/zoom-out, -ralph-loop, -feedback-loops, -review); Compound Engineering +/ce-debug +/ce-optimize +/ce-compound-refresh sub-loops; HumanLayer replace stale /rpi:* with real .claude/commands
- Bump badge timestamp to v2.1.121 Apr 29, 2026 1:06 AM PKT
2026-04-29 01:09:35 +05:00
Shayan RaisandClaude 7fe7140e00 encode two-color sub-loop convention in /workflows:development-workflows command
Adds the fff3b0/ddf4ff color split to the Workflow column spec, asks
research agents to mark each step as (top) or (sub) in the structured
report, updates the Phase 3 execute step to map those markers to badge
colors, and makes the post-table legend mandatory via new Rule 11.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-29 00:27:01 +05:00
Shayan RaisandClaude fb1dc84700 recolor sub-loop steps yellow in DEVELOPMENT WORKFLOWS table and add legend
Restores the sub-loop semantic that was lost when parenthetical
qualifiers were flattened. Steps that repeat inside a parent step
(e.g. test-driven-development inside subagent-driven-development,
bmad-create-story per story, team-fix until verified) now use
fff3b0 (soft yellow) instead of ddf4ff (light blue). A blockquote
legend below the table explains the convention.

Affected rows: Superpowers, Get Shit Done, BMAD-METHOD, Matt Pocock
Skills, oh-my-claudecode. The other 6 workflows are flat with no
sub-loops.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-29 00:27:01 +05:00
Shayan RaisandClaude 7f69a3e02f mandate HTML img with align="middle" and flat chains for Workflow column
Updates the /workflows:development-workflows command to require
HTML <img align="middle"> badges (so arrows align with badge
centers) and to forbid parenthetical sub-loops or English
qualifiers in the Workflow chain. Inner loop steps must be
listed as flat siblings.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-29 00:23:15 +05:00
Shayan RaisandClaude c4a1a4eeee align workflow arrows to badge centers and flatten parenthetical sub-loops in DEVELOPMENT WORKFLOWS
Switches each Workflow cell from markdown image syntax to HTML
<img align="middle"> so the → arrow sits at badge vertical center
instead of dropping to the text baseline below the badges. Also
removes the parenthetical sub-loops and English qualifiers (e.g.
"parallel waves + ... loop", "per story", "+ feedback-loops") that
were unparseable without upstream context — inner loop steps are
now just listed as siblings in the flat chain.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-29 00:23:15 +05:00
Shayan RaisandClaude d0e72b910e drop Plan column from /workflows:development-workflows command
Removes the Plan-implementation research item from both agent prompts,
strips the PLAN line from the structured report format, and prunes the
Plan-link rules from Phase 0/2/3 and the Rules section. Column order
in the spec now matches the README: Name | ★ | Workflow | a | c | s.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-29 00:19:03 +05:00
Shayan RaisandClaude c4efa18411 remove Plan column and move Workflow column to position 3 in DEVELOPMENT WORKFLOWS table
The Plan column duplicated information already legible in the Workflow
pipeline (the entry skill is always the first badge in the row) and the
Workflow column carries more signal. New column order:
Name | ★ | Workflow | a | c | s.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-29 00:18:56 +05:00
Shayan RaisandClaude 2f21c03d87 update /workflows:development-workflows to populate new Workflow column and research 11 repos
Bumps repo count from 10 to 11 (adds mattpocock/skills to Agent 1's
batch), replaces "Uniqueness tags" research item with "Workflow"
canonical pipeline, and documents the shields.io badge encoding rules
(/ → %2F, - → --, _ → __, dots/colons verbatim) so the orchestrator
encodes plain-text agent output into ddf4ff badges consistently. Adds
mandatory Rule 11 forbidding synthesized pipelines — agents must trace
each repo's documented happy path.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-29 00:13:38 +05:00
Shayan RaisandClaude 36642eb9c0 swap Uniqueness column for Workflow column in DEVELOPMENT WORKFLOWS table; add Matt Pocock Skills row
Each row's Workflow cell now renders the canonical end-to-end pipeline
as a sequence of ddf4ff shields.io badges joined by →, replacing the
former 2-3 adjective tags. Matt Pocock Skills inserted at rank 8 (36k ★)
in star-descending order.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-29 00:13:29 +05:00
Shayan RaisandClaude 690dc74d41 seed changelog for skill-collections workflow with first-run entry
Records the initial seeding of the SKILL COLLECTIONS table from the
development-workflows-research-agent findings on 2026-04-28. Establishes
status legend so future /workflows:skill-collections runs can append
entries in the same format as changelog/development-workflows/.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-28 18:17:15 +05:00
Shayan RaisandClaude e4140e0b42 add SKILL COLLECTIONS section to README; bump badge timestamp to Apr 28 4:39 PM PKT
New section between DEVELOPMENT WORKFLOWS and TIPS AND TRICKS, listing 5
curated SKILL.md collection repos (anthropics/skills, wshobson/agents,
mattpocock/skills, scientific-agent-skills, awesome-agent-skills) sorted
by stars. Badge timestamp refreshed via /workflows:skill-collections
first-run; CLI version unchanged at v2.1.119.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-28 18:17:05 +05:00
Shayan RaisandClaude bb7d81c585 add /workflows:skill-collections command — research 5 skill-collection repos and refresh README table
Mirrors /workflows:development-workflows: 5 phases (read → launch → compare
→ changelog → execute), reuses development-workflows-research-agent, writes
to changelog/skill-collections/changelog.md. Single-agent batch (5 repos).

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-28 18:16:56 +05:00
Shayan RaisandClaude 2aade9ae76 link spinner verbs & tips report from README — Tips section and REPORTS badges
Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-28 15:11:11 +05:00
Shayan Rais aea50ef2a1 Create claude-spinner-verbs-and-tips.md 2026-04-28 14:35:55 +05:00
Shayan RaisandClaude 26efc6324e bump README badge timestamp to Apr 27, 2026 8:39 PM PKT
CLI version unchanged at v2.1.119; only the date/time fragment of the
shields.io badge is refreshed to reflect the latest README touch.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-27 20:39:57 +05:00
Shayan RaisandClaude 63090c68ac update gdg-kolachi presentation: clickable disrupt logo, new tool-calling slide, slide reorder
- Swap intro-slide logos from disrupt-logo.png to disrupt.svg (lines 190 and 260)
- Wrap each disrupt logo in <a href="https://disrupt.com" target="_blank" rel="noopener noreferrer"> so the logo opens disrupt.com in a new tab
- Update model-limitation.jpg path from assets/model/ to assets/harness/ to match the asset move
- Insert new "Tool Calling" slide using assets/harness/tool-calling.png; cascading data-slide renumber for all 40 slides at index >= 13 (totals: 52 -> 53)
- Reorder slides 12-14 so the narrative reads Limitations -> Horse+Harness metaphor -> Tool Calling mechanism

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-27 20:37:38 +05:00
Shayan RaisandClaude 395e80f67d add tool-calling.png diagram for harness section
Visual aid showing how the model issues tool calls and the harness executes
them against the outside world. Used by the new Tool Calling slide.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-27 20:37:09 +05:00
Shayan RaisandClaude 2246512e4d add disrupt.svg vector logo for presentation intro slides
Vector replacement for the previous disrupt-logo.png raster, keeping crisp
rendering at any projection scale.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-27 20:36:55 +05:00
Shayan RaisandClaude 2a0bcfa214 move model-limitation.jpg from assets/model/ to assets/harness/
Reorganize the screenshot under harness/ alongside other harness-limitation
assets. File contents unchanged (rename detected as 100% similarity).

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-27 20:36:39 +05:00
Shayan Rais f734255f60 rename presentation agent 2026-04-26 17:19:49 +05:00
Shayan Rais 9437efe323 updated 2026-04-26 17:13:50 +05:00
Shayan Rais eabba864a9 updated weather workflow 2026-04-26 16:55:11 +05:00
Shayan RaisandClaude f400ba83d4 Log Apr 26 development-workflows update
Append entry recording 9 applied actions (5 star bumps, 1 BMAD tag rewrite
22+ platforms→42 platforms, 3 count updates for Compound Engineering and
BMAD) plus 4 ON HOLD verify items for recurring API-vs-baseline drops
(ECC commands/skills, GSD commands, oh-my-claudecode skills, Superpowers
agents). The held items follow the established conservative pattern of
keeping the higher prior count when API enumeration drops aren't backed
by a release note.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-04-26 15:43:47 +05:00