gilles/claude-code-best-practice
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
199 Commits 7 Branches 0 Tags
65146aac13daa5a15868bf522c6edfc895097dfd
Commit Graph
100 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
Shayan Rais 65146aac13 added new workflow 2026-03-19 19:26:41 +05:00
Shayan Rais 20a4e72145 added video transcripts 2026-03-19 18:17:32 +05:00
Shayan Rais 6de173c410 added more tips 2026-03-19 16:19:40 +05:00
Shayan Rais fe3e72c635 added more tips 2026-03-19 15:40:52 +05:00
Shayan RaisandClaude d07e4bb3f5 added Thariq skills tips (17 Mar 26): 9 skill types, 9 authoring tips, distribution and marketplace guidance 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-19 14:52:58 +05:00
Shayan RaisandClaude 2cddc281d6 redesigned README header: inline badges, Boris badge, GitHub Trending badge, and social preview banner 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-19 13:23:37 +05:00
Shayan RaisandClaude 84fd8a73dd renamed claude-code-voice-hooks to claude-code-hooks across repo 
GitHub repo slug changed from shanraisshan/claude-code-voice-hooks to
shanraisshan/claude-code-hooks. Updated all URLs, display names, and
references across 8 files.

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-19 12:57:11 +05:00
Shayan RaisandClaude 914c1b5e2f workflow changelog runs for settings, commands, skills, subagents, and concepts — v2.1.79 
Settings: added 3 ANTHROPIC_CUSTOM_MODEL_OPTION env vars, fixed sandbox path
prefix convention (/ = absolute, ./ = project-relative, // = legacy), updated
CLAUDE_CODE_PLUGIN_SEED_DIR for multi-directory support, expanded
CLAUDE_CODE_AUTO_COMPACT_WINDOW description. Commands, skills, subagents,
concepts: no drift detected. All badges updated to v2.1.79.

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-19 12:50:01 +05:00
Shayan RaisandClaude 85e245d6d1 workflow changelog runs for settings, commands, skills, subagents, and concepts reports 
Settings (v2.1.78): added voiceEnabled, filesystem.allowManagedReadPathsOnly; moved showTurnDuration/terminalProgressBarEnabled to ~/.claude.json section; fixed MAX_MCP_OUTPUT_TOKENS default (25000); added 3 missing env vars; corrected 4 env var descriptions; added verification Rule 1H (file scope check)

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-19 00:33:54 +05:00
Shayan RaisandClaude 50887db4f2 updated badge to v2.1.78, Mar 18 2026 8:19 PM PKT 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-18 20:25:34 +05:00
Shayan RaisandClaude ac7085f9cc added Dex Horthy (HumanLayer) tip: <important if> tags for CLAUDE.md 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-18 20:18:32 +05:00
Shayan Rais 005c779e2a added tips 2026-03-17 22:16:16 +05:00
Shayan Rais 28f8e202c6 added codex hooks 2026-03-17 20:11:49 +05:00
Shayan RaisandClaude 0fe13e160c renamed Other Best Practices to Other Repos, added claude-code-voice-hooks and codex-cli-voice-hooks with mascots 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-17 19:36:05 +05:00
Shayan Rais fe0bfd40b2 added other best practice section 2026-03-17 16:13:37 +05:00
Shayan Rais bf7eaa90ef updated workflow diagram 2026-03-17 15:54:07 +05:00
Shayan Rais 1ac2b97df6 v2.1.77 2026-03-17 13:05:20 +05:00
Shayan RaisandClaude 7908d502d0 updated last updated badge to Mar 16, 2026 7:36 PM PKT and reverted stars to dynamic badge 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-16 19:36:46 +05:00
Shayan RaisandClaude 6aa894a07c update README: refresh star counts, move gstack to hot, show exact star badge 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-16 14:11:47 +05:00
Shayan Rais a774bb3546 added hyperlinks 2026-03-16 13:19:08 +05:00
Shayan RaisandClaude d69a621f86 settings report v2.1.76: add 4 settings, 23 env vars, permission syntax, and 14 verification rules 
Settings report changes:
- Add effortLevel, worktree.sparsePaths, worktree.symlinkDirectories, feedbackSurveyRate
- Add 23 missing env vars (Vertex regions, proxy, MCP OAuth, model overrides)
- Add Read/Edit gitignore-style path patterns and word-boundary wildcard detail
- Mark 7 unverified env vars not in official docs
- Update cleanupPeriodDays with hooks transcript_path detail
- Add /effort command, update effort level how-to
- Add env-vars and permissions official doc sources
- Update Quick Reference example with effortLevel and worktree

Verification checklist (16 → 30 rules):
- 1E scope column, 1F inverse completeness, 1G edge-case semantics
- 2C merge semantics, 2D managed internals
- 3C bidirectional mode check, 3D evaluation semantics
- 5C env var descriptions, 5D inverse env var check
- 6B example URL validation
- 10A version metadata, 10B suspect key escalation, 10C bidirectional completeness

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-15 13:43:49 +05:00
Shayan Rais 306888ac0d updated to 2.1.76 2026-03-15 13:01:44 +05:00
Shayan Rais 0399ff6824 updated hooks 2026-03-15 12:45:48 +05:00
Shayan RaisandClaude 67a5d2333e updated last updated badge to Mar 15, 2026 12:43 PM PKT 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-15 12:45:03 +05:00
Shayan RaisandClaude 843f90cb4a updated tag colors, added Thariq badge, and linked tweet screenshots 
- Swapped Boris tags to Claude orange (#CC7C5E) and orchestration workflow tags to blue (#3b82f6)
- Added Claude splash logo to boris-cherny.svg and boris-team.svg
- Created thariq.svg badge with matching style
- Changed community tag to pumpkin orange (#e67e22)
- Changed Command box in orchestration diagram to dark slate (#2C3E50)
- Replaced all shields.io Boris/Thariq badges in README with local SVGs
- Linked tweet screenshots in claude-memory.md and llm-day-to-day-degradation.md to source tweets

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-14 10:02:04 +05:00
Shayan Rais f0e72695eb added developed by section 2026-03-14 08:11:01 +05:00
Shayan Rais 11c58305fc added boris code-review tips 2026-03-14 07:18:30 +05:00
Shayan Rais 1ad55dceb1 added certification 2026-03-14 06:41:23 +05:00
Shayan Rais 55204a597d added trending section 2026-03-13 17:12:58 +05:00
Shayan Rais d30ec3b8c7 added workflows for claude commands and skills 2026-03-13 16:18:06 +05:00
Shayan Rais d93c1229f7 added boris 1/feb workflow with screenshots 2026-03-13 15:38:52 +05:00
Shayan Rais a06b8abfc5 added boris workflows with screenshots 2026-03-13 13:27:58 +05:00
Shayan RaisandClaude 5f16eb60b4 add Boris 13-tips (Jan 3) doc, rename tips files for consistency, and clean up README tips section 
- Create tips/claude-boris-13-tips-03-jan-26.md from Boris's Jan 3 tweet thread (13 tips)
- Rename claude-boris-tips-feb-26.md → claude-boris-12-tips-12-feb-26.md for consistent naming
- Remove description hyperlinks for external-only URLs in Boris + Team section
- Add (Boris) attribution to Boris's tweets matching existing (Thariq) pattern
- Update all references in README.md and presentation/index.html

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-12 20:22:45 +05:00
Shayan RaisandClaude 304eab6e52 replace Oishii example with time orchestrator built by agent teams 
Agent teams now bootstrap a self-contained time orchestration workflow
inside agent-teams/.claude/ (command, agent, skill). The prompt, diagram,
and How to Use section all reference the new time-orchestrator pattern
with cd agent-teams && claude → /time-orchestrator.

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-12 18:30:02 +05:00
Shayan RaisandClaude 7bb20f3d9e add agent teams implementation with tmux setup and Oishii prompt example 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-12 17:52:45 +05:00
Shayan RaisandClaude e0508e3362 refactor weather-svg-creator skill to use reference files per official best practice 
Split monolithic SKILL.md into three files: concise SKILL.md with overview
and navigation, reference.md with SVG template and design specs, and
examples.md with Celsius/Fahrenheit input/output pairs. Follows the
progressive disclosure pattern from Claude Code docs.

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-12 16:07:35 +05:00
Shayan RaisandClaude 798c2aac2b add agents-vs-commands-vs-skills report to README reports table 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-12 15:57:10 +05:00
Shayan RaisandClaude e6bfcf2217 add time agent/command/skill and agents-vs-commands-vs-skills comparison report 
Adds the time trio (agent, command, skill) demonstrating all three extension
mechanisms for the same task, plus a comprehensive report comparing when to
use each pattern with worked examples and screenshots.

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-12 15:55:08 +05:00
Shayan Rais 74d58d1343 updated commands, skills, agents description 2026-03-12 13:19:13 +05:00
Shayan RaisandClaude 518ae09325 Update settings report to v2.1.74 — fix critical dontAsk description, add new settings and env vars 
Key changes:
- Fix dontAsk permission mode description (was incorrectly described as auto-accept,
  actually auto-denies unless pre-approved)
- Add modelOverrides, allow_remote_sessions, autoMemoryDirectory settings
- Fix $schema URL (www.schemastore.org → json.schemastore.org)
- Fix ANTHROPIC_CUSTOM_HEADERS format description
- Add 6 missing environment variables
- Mark askEdits/viewOnly as unverified permission modes
- Update badges and changelog entries for settings, subagents, and concepts workflows

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-12 13:09:15 +05:00
Shayan Rais ab1b5ac0ad updated tool use sounds 2026-03-11 17:05:48 +05:00
Shayan RaisandClaude 8ab9f5a71b add /btw side chain conversations (Thariq tweet) to hot table and team list 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-11 16:53:37 +05:00
Shayan RaisandClaude 1db481abc2 replace boris code review tip with fresh context windows tweet 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-10 20:17:18 +05:00
Shayan Rais 14687b5019 updated with new topics 2026-03-10 16:03:44 +05:00
Shayan Rais bb8ddcf3e0 added more anthropic people to follow 2026-03-10 15:58:17 +05:00
Shayan RaisandClaude a851cedd71 hot table badges, simplify & batch, scheduled tasks implementation, karpathy tweet 
- Add Best Practice badges: Voice Mode, Agent Teams, Simplify & Batch
- Add Implemented badge + implementation doc for Scheduled Tasks (/loop)
- Add Simplify & Batch row to Hot table
- Add AskUserQuestion + ASCII Markdowns to Boris section
- Karpathy: link to tweet instead of GitHub, remove stars, re-sort Others

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-10 15:50:41 +05:00
Shayan RaisandClaude 3bfc0f9241 [2.1.72] code review, beta tags, hot table reorder 
- Add Code Review to Hot table, Startups, and Boris tweets
- Create beta.svg tag (yellow, 38x20px) for preview/experimental features
- Add beta tags to Code Review, Voice Mode, and Agent Teams
- Sort Hot table by release date (most recent first)
- Add Interactive Mode inline link to CLI Startup Flags row
- Update Voice Mode and Remote Control locations with slash commands
- Add Claude to X follow list in Daily tips
- Append v2.1.72 changelog entry (8 items)
- Update Last Updated badge to Mar 10, 2026

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-10 15:26:08 +05:00
Shayan Rais e85ec16a01 [workflow] subagents updated 2026-03-07 15:15:09 +05:00
Shayan Rais 4366d29465 [2.1.71] scheduled tasks /loop 2026-03-07 14:42:22 +05:00
Shayan Rais 4338945024 [changelog] 2.1.71 2026-03-07 14:38:08 +05:00
Shayan Rais dd73807ca7 new updates 2026-03-07 08:22:26 +05:00
Shayan Rais ba6cc3e6a0 updated docs 2026-03-06 12:56:26 +05:00
Shayan Rais 588231dd5f updated 2026-03-06 11:13:56 +05:00
Shayan RaisandClaude b06bc14c83 reorganized README tips and moved orchestration SVG 
- moved command-skill-agent-flow.svg to orchestration-workflow/orchestration-workflow.svg
- added orchestration-workflow.gif to README
- updated SVG references in implementation docs
- reorganized tips into Planning, Workflows, Workflows Advanced, Debugging, Utilities, Daily sections
- added tip counts to section headings
- added thinking mode + output style explanatory tip
- moved /rename, /permissions, /sandbox tips to appropriate sections

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-06 11:13:35 +05:00
Shayan Rais e610c76120 adeed claude-oss banner 2026-03-06 09:56:52 +05:00
Shayan Rais 1900a59cba added more personal tips 2026-03-06 08:01:24 +05:00
Shayan Rais a80f370f7f added llm degradation report 2026-03-06 07:35:12 +05:00
Shayan Rais 2efeb27880 updated hyperlinks 2026-03-05 16:36:21 +05:00
Shayan Rais 75723fc420 added billion dollar question section 2026-03-05 16:29:12 +05:00
Shayan Rais 777276845a added billion dollar question section 2026-03-05 16:27:19 +05:00
Shayan Rais 59b9812f69 updated tips + tricks 2026-03-05 15:32:57 +05:00
Shayan Rais 73a75ed62f added cross model workflow 2026-03-05 15:07:58 +05:00
Shayan Rais 26af458c48 updated with new 2.1..69 changes 2026-03-05 13:07:02 +05:00
Shayan Rais 54bf549011 added new hook InstructionsLoaded 2026-03-05 13:05:41 +05:00
Shayan Rais f467c65daa added presentation 2026-03-05 13:00:11 +05:00
Shayan RaisandGitHub 99949d47dd Fix links in README for AskUserQuestion and tips 
Updated links in the README to include proper URLs.
 2026-03-05 06:45:05 +05:00
Shayan Rais 793f51ef45 v2.1.69 settings added 2026-03-05 06:33:51 +05:00
Shayan Rais 296d0e8c8c added personal tips 2026-03-05 00:41:25 +05:00
Shayan Rais e745bb475d added more personal tips 2026-03-04 17:06:39 +05:00
Shayan Rais 5101632881 added more personal tips 2026-03-04 13:24:23 +05:00
Shayan Rais 51fd371171 added more personal tips 2026-03-04 13:17:06 +05:00
Shayan Rais 5ec64c72b0 added more tips 2026-03-04 09:24:12 +05:00
Shayan RaisandGitHub 0453e6be6f Update README with CLAUDE.md guidelines 
Clarified guidelines for CLAUDE.md and workflows.
 2026-03-04 00:00:19 +05:00
Shayan Rais 2c3adf8fb9 added prompt engineering repo 2026-03-03 18:29:55 +05:00
Shayan Rais 90d95c5b2e added how to use in workflow orchestration 2026-03-03 18:26:07 +05:00
Shayan Rais 8e2710074c added voice mode 2026-03-03 11:35:29 +05:00
Shayan Rais 2453ac274f workflow updated 2026-03-02 20:22:05 +05:00
Shayan Rais 13874e6fda done 2026-03-02 20:02:59 +05:00
Shayan Rais db43e42605 updated date 2026-03-02 19:18:25 +05:00
Shayan Rais 4bee7e9c22 updated boris tips section 2026-03-02 18:26:58 +05:00
Shayan Rais ea30eb392c updated boris tweets 2026-03-02 15:52:07 +05:00
Shayan Rais 91c3c149c4 [how to use][how to implement] 2026-03-02 14:25:26 +05:00
Shayan Rais 182ca334f0 added more concepts 2026-03-02 13:15:36 +05:00
Shayan Rais c59026257a readme updated 2026-03-02 12:52:02 +05:00
Shayan Rais 569bc9e5e2 updated concepts 2026-03-02 12:06:47 +05:00
Shayan Rais 3776747e8a major refactor 2026-03-02 10:47:11 +05:00
Shayan Rais d4f6baa98d updated readme 2026-03-01 15:36:08 +05:00
Shayan Rais 105f78ad5b updated readme 2026-03-01 15:07:44 +05:00
Shayan Rais 54064d9e23 [weather orchestration workflow] updated 2026-02-28 20:29:11 +05:00
Shayan Rais 110b639b65 updated readme 2026-02-28 20:15:47 +05:00
Shayan Rais a52e8ade95 [weather orchestration workflow] added 2026-02-28 20:00:34 +05:00
Shayan Rais d474862567 subagents best practice added 2026-02-28 18:16:05 +05:00
Shayan Rais e155fd1e16 introduced badges 2026-02-28 17:28:45 +05:00
Shayan Rais 37e9a62f23 workflow added for subagents 2026-02-28 16:01:06 +05:00
Shayan Rais 8cfb5b66f5 claude-code-voice-hooks added 2026-02-28 15:05:00 +05:00
Shayan RaisandGitHub 027009b766 Merge pull request #5 from neutmute/main 
Fix 404 to sandboxing
 2026-02-27 00:16:29 +05:00
Shayan Rais 17f1faba73 updated 2026-02-26 11:12:07 +05:00
Shayan Rais a4f7f2ec48 updated settings 2026-02-20 18:07:49 +05:00
Shayan RaisandClaude Opus 4.6 fa26ac1d71 stop tracking .mcp.json (already in .gitignore) 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
 2026-02-18 16:27:25 +05:00
Shayan Rais 03c46c213d added git ignore 2026-02-18 16:18:12 +05:00