Commit Graph

735 Commits

Author SHA1 Message Date
Shayan Rais b5b56f65e5 docs(implementation): add /goal implementation doc with community tweet tips
Embeds two X.com screenshots (Alex Finn, Meta Alchemist) with verbatim
tweet text and source URLs. Covers two patterns: asking the agent to
propose its own /goals, and asking it to draft a /goal prompt from
session + repo context.

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-13 01:18:57 +05:00
Shayan Rais 18eb64845f docs(implementation): add Meta Alchemist /goal Codex tweet screenshot asset
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-13 01:18:50 +05:00
Shayan Rais c88752840f docs(implementation): add Alex Finn /goal tweet screenshot asset
Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-13 01:18:44 +05:00
Shayan Rais 98b4097395 chore(cross-model-workflows): seed changelog for new section
Establish changelog/cross-model-workflows/changelog.md mirroring the
structure of skill-collections and development-workflows changelogs.
Initial entry documents section creation, the 4 included repos, the
10k+ stars threshold policy, EveryInc/compound-engineering-plugin
exclusion (verified Claude-only), and a sub-threshold watchlist
(decolua/9_router 9.3k, 1rgs/claude-code-proxy 4k, jamubc/gemini-mcp-tool 2k,
LLM-Red-Team/kimi-cc 2k, jarrodwatts/claude-delegator 1k).

Co-Authored-By: Claude <noreply@anthropic.com>
2026-05-13 00:51:59 +05:00
Shayan Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 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
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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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 Rais 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
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