gilles/claude-code-best-practice
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
496 Commits 7 Branches 0 Tags
dec5fa80a06ccebc96975a29efe2c332ee45fc99
Commit Graph

103 Commits

Author SHA1 Message Date
Shayan Rais fe3434b42b presentation updated 2026-04-22 15:31:13 +05:00
Shayan Rais 41f50d781d added shayan introduction 2026-04-22 15:01:23 +05:00
Shayan Rais 08cf087a16 .claude/rules/presentation: switch Glob heading to paths: YAML frontmatter 
The '# Glob: presentation/**' markdown heading was not parsed as scoping
metadata — Claude Code only reads YAML frontmatter with paths: for
path-specific rule loading. Without proper frontmatter, the file loaded
into every session instead of only presentation/** work. Now correctly
scoped via paths: ["presentation/**"] with H1 'Presentation Delegation'.

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-20 00:07:52 +05:00
Shayan Rais 29e19dfbe0 .claude/rules/markdown-docs: switch Glob heading to paths: YAML frontmatter 
The '# Glob: **/*.md' markdown heading was a cargo-cult label — Claude Code
only parses YAML frontmatter with paths: for path-scoping. Without it, the
file loaded unconditionally on every session. Now correctly scoped via
paths: ["**/*.md"] and H1 retitled to 'Markdown Docs' for human readers.

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-20 00:07:46 +05:00
Shayan Rais d3b61467c4 .claude/agents/presentation-learning-journey: record scoped per-slide scroll override pattern 
Documents the below-fold legend technique: min-height expansion, scroll affordance,
window.scrollTo(0,0) in showSlide(), and why no CSS ancestor changes are needed.

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-19 12:58:00 +05:00
Shayan Rais 6b8d32a0f1 .claude/agents/presentation-learning-journey: record legend-footer pattern 
Documents the color-coded definition table technique: shrink chip-cloud
container to free vertical space, add 2-col grid below with matching hex
term colors, 0.82rem rows, 9 items per column balancing color tiers.

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-19 12:48:46 +05:00
Shayan Rais 82ac7fc9f3 .claude/agents/presentation-learning-journey: record hero-tier chip hierarchy pattern 
Document inline styling approach for dominant/supporting chip tiers on word-cloud
slides: hero chips use 1.5-1.6rem / weight 800 / glow box-shadow; supporting chips
use 0.9-1.0rem / weight 600 / plain shadow. No new CSS classes needed.

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-19 12:28:22 +05:00
Shayan Rais 017994b5e5 .claude/agents/presentation-learning-journey: record chip-splitting and color-rebalancing patterns 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-19 11:58:34 +05:00
Shayan Rais 27df25fb04 .claude/agents/presentation-learning-journey: record word-cloud slide insertion methodology 
Documents the absolute-position % chip pattern, 5-row layout strategy,
overflow:hidden container, white-space:nowrap requirement, and updated
section-divider positions after the slide-2 insertion (total 39 slides).

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-19 11:30:54 +05:00
Shayan Rais c86880a227 .claude/agents/presentation-learning-journey: record slide-3 insertion methodology and sed/Edit sequencing rule 
Self-evolve log entries from the Apr 18 "What is Claude Code?" slide
insertion: descending-sed renumber method, three-column inline-grid layout
choice, post-insertion section-divider positions (Agents=8 ... Workflow=34),
and the sequencing rule that Edit must run after sed completes — parallel
execution causes "file modified since read" errors.

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-18 22:07:54 +05:00
Shayan Rais bbfa6b8894 settings.json: hoist disableAllHooks to top of file 
Move disableAllHooks next to the opening brace so the master toggle
is visible at the top instead of buried below env and
enableAllProjectMcpServers. Behavior unchanged (remains false).

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-18 20:24:10 +05:00
Shayan Rais b6ff4fdb25 agents/development-workflows-research-agent: expand allowedTools 
Add Write, Edit, Agent, NotebookEdit, and mcp__* to the allowlist so
the research agent can author reports and delegate to subagents
without per-tool permission prompts.

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-18 20:24:05 +05:00
Shayan Rais 5b062383a8 agents/presentation-learning-journey: record rebuild protocol and data-loss prevention rule 
Added mandatory learning: never run destructive git ops (checkout --, restore,
reset --hard) on uncommitted work. Added commit-per-milestone protocol, Write-tool
vs sed preference for large restructures, and full rebuild summary for the
2026-04-18 weather-reporter 37-slide deck.

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-18 16:26:56 +05:00
Shayan Rais db0efc8142 updated 2026-04-17 21:39:53 +05:00
Shayan Rais 9c1597c009 fix indentation in settings.json permissions block 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-16 23:45:24 +05:00
Shayan Rais 65fe4f0cf8 disable PreToolUse, Notification, and InstructionsLoaded hooks in config 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-16 23:45:24 +05:00
Shayan Rais 37fa0bac05 update hook property names and add PreCompact blocking output to hooks README 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-16 23:45:23 +05:00
Shayan Rais 724b02356b add weather data entries for 2026-04-16 (23.8°C Dubai) 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-16 23:45:20 +05:00
Shayan Rais e569d3e3c5 fix Bash permission — change Bash to Bash(*) to auto-allow all bash commands for subagents 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-10 00:31:15 +05:00
Shayan Rais d0c1149087 add permissiondenied wav sound for new PermissionDenied hook 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-04 18:34:43 +05:00
Shayan Rais 7ca1b7cfd3 add permissiondenied mp3 sound for new PermissionDenied hook 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-04 18:34:42 +05:00
Shayan Rais 49184dfbe3 add filechanged wav sound for new FileChanged hook 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-04 18:34:41 +05:00
Shayan Rais 4063b0ecaa add filechanged mp3 sound for new FileChanged hook 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-04 18:34:40 +05:00
Shayan Rais 8cd1f00a4d add cwdchanged wav sound for new CwdChanged hook 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-04 18:34:37 +05:00
Shayan Rais b5a0c59fda add cwdchanged mp3 sound for new CwdChanged hook 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-04 18:34:37 +05:00
Shayan Rais 0e5166fdd8 add stopfailure wav sound for new StopFailure hook 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-04 18:34:37 +05:00
Shayan Rais 25e7c81045 add stopfailure mp3 sound for new StopFailure hook 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-04 18:34:36 +05:00
Shayan Rais 27c1a893aa add taskcreated wav sound for new TaskCreated hook 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-04 18:34:36 +05:00
Shayan Rais fbf57bf5bd add taskcreated mp3 sound for new TaskCreated hook 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-04 18:34:36 +05:00
Shayan Rais 3868c1b3ff update userpromptsubmit wav sound 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-04 18:34:27 +05:00
Shayan Rais bacd23b9e0 update userpromptsubmit mp3 sound 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-04 18:34:27 +05:00
Shayan Rais c991d7dcd9 update subagentstop wav sound 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-04 18:34:26 +05:00
Shayan Rais 5058ce20dc update subagentstop mp3 sound 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-04 18:34:25 +05:00
Shayan Rais 981a2a37a6 update subagentstart wav sound 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-04 18:34:21 +05:00
Shayan Rais 884d64a89b update subagentstart mp3 sound 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-04 18:34:20 +05:00
Shayan Rais 42c211ff12 update stop wav sound 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-04 18:34:20 +05:00
Shayan Rais 5e6f3f5138 update stop mp3 sound 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-04 18:34:19 +05:00
Shayan Rais 2f2c6e0ed3 update posttoolusefailure wav sound 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-04 18:34:18 +05:00
Shayan Rais 4daaf346e4 update posttoolusefailure mp3 sound 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-04 18:34:17 +05:00
Shayan Rais ec967be1de add 5 new hook sound mappings — TaskCreated, StopFailure, CwdChanged, FileChanged, PermissionDenied 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-04 18:34:13 +05:00
Shayan Rais cbd0cc37f2 add disable flags for 5 new hooks — StopFailure, CwdChanged, FileChanged, TaskCreated, PermissionDenied 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-04 18:34:12 +05:00
Shayan Rais da292b8fcc update hooks reference 22→27 — add TaskCreated, StopFailure, CwdChanged, FileChanged, PermissionDenied hooks 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-04 18:34:11 +05:00
Shayan Rais cfb2ac7c55 add 5 new hook handlers — TaskCreated, StopFailure, CwdChanged, FileChanged, PermissionDenied; fix indentation 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-04-04 18:34:07 +05:00
Shayan Rais e2c5778c38 follow section added 2026-04-03 16:32:07 +05:00
Shayan Rais d742fd25f5 update development workflows — star bumps, ECC/BMAD/gstack/CE count changes, remove gh allow 
Stars: Superpowers 120→122k, ECC 114→116k, gstack 54→55k, Compound Eng 11→12k
Counts: ECC agents 28→30 skills 125→135, gstack skills 29→28, BMAD skills 43→40, CE agents 47→48 skills 43→42
Settings: remove Bash(gh *) from allowed tools

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-29 20:03:36 +05:00
Shayan Rais 6e3dfaaefc update reports to v2.1.84 — shell field, initialPrompt, /fast syntax + workflow changelogs 
Commands: add `shell` frontmatter field (bash/powershell), update /fast to /fast [on|off], bump to 12 fields.
Skills: add `shell` frontmatter field, bump to 12 fields.
Subagents: add `initialPrompt` frontmatter field, bump to 16 fields.
Settings: add WebFetch and MCP permission rules for workflow domains.
Changelogs: append v2.1.84 entries for commands, skills, subagents, concepts, and development workflows.

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-26 13:50:43 +05:00
Shayan Rais fdec218385 update settings report to v2.1.84, add Compound Engineering to development workflows 
Settings report (v2.1.84): add defaultShell, allowedChannelPlugins, useAutoModeDuringPlan settings + 11 new env vars (9 model customization, NONSTREAMING_FALLBACK, POWERSHELL_TOOL). Fix managed-tier merge semantics, broken claudelog.com link, disableDeepLinkRegistration annotation.

Development workflows: add EveryInc/compound-engineering-plugin (11k★, 43 agents, 44 skills) as 9th tracked repo with counting hints in workflow command.

Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-26 13:47:55 +05:00
Shayan Rais f297cfe613 move a.svg, c.svg, s.svg to !/tags/ and update all references 
Co-Authored-By: Claude <noreply@anthropic.com>
 2026-03-23 23:08:34 +05:00
Shayan Rais 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 Rais 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