- 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>
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>
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>
- 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>
- 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>
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>
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>
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>
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>
- 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>
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>
- 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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
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>
Shayan Rais