gilles/claude-code-best-practice
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
212 Commits 7 Branches 0 Tags
eac714db653a7b02bda1b46e1f16d3d7c849d977
Commit Graph
100 Commits
This Branch
This Branch
All Branches
Author SHA1 Message Date
Shayan Rais eac714db65 Merge branch 'main' of https://github.com/shanraisshan/claude-code-best-practice 2026-03-23 22:59:59 +05:00
Shayan RaisandClaude d913b37cca sync all reports to v2.1.81 — add editorMode, /schedule, fix settings scope 
Settings report: add editorMode to ~/.claude.json table, move
showClearContextOnPlanAccept to settings.json (confirmed on official page),
fix terminalProgressBarEnabled terminals, add Config tool to availableModels.

README: add /schedule cloud-based scheduled tasks alongside /loop, update
development workflow stars (Superpowers 107k, ECC 101k, gstack 41k, GSD 40k),
update counts for ECC, gstack, GSD, OpenSpec.

All other reports (commands, skills, subagents, concepts) synced with no drift.

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-23 22:58:21 +05:00
Shayan RaisandGitHub 25934da774 Update README.md 2026-03-22 23:01:44 +05:00
Shayan Rais 378f927567 Merge branch 'main' of https://github.com/shanraisshan/claude-code-best-practice 2026-03-21 21:34:22 +05:00
Shayan RaisandClaude be2ad50e32 sync all reports to Claude Code v2.1.81 — add IDE settings, fix allow_remote_sessions, update stars 
Settings report (claude-settings.md):
- Add autoConnectIde, autoInstallIdeExtension, showClearContextOnPlanAccept to ~/.claude.json table
- Re-add unverified annotation on allow_remote_sessions (official docs say not a settings key)
- Add source:'settings' marketplace type to Plugin Settings with inline example
- Add rate_limits fields to Status Line Input Fields table
- Bump version badge and header to v2.1.81

Other reports: bump badges to v2.1.81, update development workflow stars and counts

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-21 21:27:43 +05:00
Shayan RaisandGitHub fc1c74e789 Update badge version in README.md 2026-03-21 21:02:38 +05:00
Shayan RaisandClaude a20f645a03 convert Tips and Tricks, Boris + Team, and Videos sections to two-column tables (84 total) 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-20 09:07:57 +05:00
Shayan RaisandClaude 15775544ef sort development workflows table by stars descending, update workflow to enforce star-based ordering 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-20 08:56:25 +05:00
Shayan RaisandClaude 53db5de218 sync all reports to Claude Code v2.1.80 — fix frontmatter field coverage across commands, skills, and subagents 
- Commands: 4→11 frontmatter fields (QA correction — official docs confirm commands support same frontmatter as skills, reversing 5 runs of incorrect "skill-only" INVALID status)
- Skills: 10→11 fields (added effort)
- Subagents: 14→15 fields (added effort)
- Settings: added channelsEnabled managed setting
- Concepts: added Channels row, Git Worktrees deep link, Plugins marketplace link
- Development workflows: star/count updates, table reorder
- CLAUDE.md: added effort to subagent definition
- README: v2.1.80 badge, added Kenneth to follows

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-20 08:50:28 +05:00
Shayan RaisandClaude da6cebacab add BMAD-METHOD to development workflows, add tips nav anchors 
- Added BMAD-METHOD (41k stars) as 8th development workflow in README table
- Added anchor IDs (tips-prompting, tips-hooks, etc.) to all 12 TIPS AND TRICKS subsections
- Added navigation bar at top of TIPS AND TRICKS for quick jumping
- Updated development-workflows command to include BMAD-METHOD as repo #8

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-20 08:10:35 +05:00
Shayan RaisandClaude f3f7251800 added Agents, Commands, and Hooks subsections to TIPS AND TRICKS 
Reorganized tips into dedicated extension-point sections (Agents 4, Commands 3, Hooks 5) by moving scattered tips from Prompting, Skills, Workflows, and Workflows Advanced. Added 8 new tips sourced from Boris and Thariq. Reordered as CLAUDE.md → Agents → Commands → Skills → Hooks → Workflows.

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-20 01:40:22 +05:00
Shayan Rais 60eafc8663 updated readme 2026-03-19 20:07:46 +05:00
Shayan RaisandClaude 81432bfad8 README layout: reorder tables, add section dividers, remove /btw 
- Move Subagents to 1st row and Commands to 2nd in Concepts table
- Sort Development Workflows table by stars descending
- Add jumping Claude SVG (60x50) as section dividers
- Remove dividers above Other Repos and Developed by to group footer
- Remove /btw row from Hot section
- Move How to Use section above Trending

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-19 19:36:40 +05:00
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