Commit Graph

77 Commits

Author SHA1 Message Date
Luong NGUYEN 3f55490c38 fix: Add 'overcomplicate' to spell check dictionary 2026-01-15 15:04:22 +01:00
Luong NGUYEN 59a87f10c8 fix: Resolve dead links in documentation files
- 02-memory/README.md: Remove broken example links, keep valid ones
- CONTRIBUTING.md: Fix relative path to SECURITY.md
- 07-plugins/README.md: Update MCP spec URL to working domain
- .github/SECURITY_REPORTING.md: Update OWASP link to valid cheatsheet
- .github/ISSUE_TEMPLATE/*: Replace placeholder links with comments
- .github/markdown-link-check-config.json: Add ignore patterns for
  example URLs in code blocks (docs.example.com, template files)
2026-01-15 15:02:44 +01:00
Luong NGUYEN 9c884f07c0 docs: Remove token estimates from catalog, keep scope only
Remove inaccurate token estimation values and the Token Estimation
Legend section. Retain only the Scope column to guide users on
where to install features (User/Project/Directory/Built-in).
2026-01-15 14:46:44 +01:00
Luong NGUYEN 03bd634f92 docs: Add token estimation legend with methodology explanation
Add comprehensive Token Estimation Legend section explaining:
- Base calculation methodology (~1 token ≈ 4 chars)
- Token ranges by feature type with what's included
- Scope recommendations (User/Project/Directory/Built-in)
- Context budget tips for optimal usage
2026-01-15 14:42:56 +01:00
Luong NGUYEN 9db33359ab docs: Add token estimates and scope recommendations to catalog
Add two new columns to all feature tables in CATALOG.md:
- Tokens: Estimated context consumed when feature is loaded
- Scope: Recommended installation level (User/Project)

Helps users make informed decisions about context budget and
where to install features for optimal team collaboration.
2026-01-15 14:41:26 +01:00
Luong NGUYEN 58c073beec docs: Add refactor skill to skills README and catalog
- Add Example 5 (Code Refactoring Skill) to 03-skills/README.md
  with directory structure, SKILL.md snippet, and usage example
- Add refactor skill entry to CATALOG.md skills table
2026-01-15 14:37:30 +01:00
Luong NGUYEN 728fd1eefc docs: Add comprehensive feature catalog with installation commands
Create CATALOG.md containing quick reference for all Claude Code features:
- Slash commands (built-in and custom)
- Sub-agents with capabilities and tools
- Skills with auto-invocation triggers
- Plugins with component breakdowns
- MCP servers for external integrations
- Hooks for event-driven automation

Each feature includes one-command installation instructions.
Update README.md to link to the new catalog.
2026-01-15 14:34:23 +01:00
Luong NGUYEN 245272f6d4 feat: Add code refactoring skill based on Martin Fowler's methodology
Add comprehensive Agent Skill for systematic code refactoring with:

- Main SKILL.md with 6-phase workflow (research, test coverage, smell
  identification, planning, implementation, review)
- Code smells reference catalog (22+ smells with examples)
- Refactoring techniques catalog (25+ techniques with mechanics)
- Refactoring plan template for tracking progress
- Python scripts for complexity analysis and smell detection
- User consultation points at each decision phase
- Safety guidelines emphasizing tests and small steps
2026-01-15 14:28:09 +01:00
Luong NGUYEN 5c54d753a1 fix: Add 'srcset' to spell check dictionary and fix Bandit config path in CI workflow 2026-01-09 10:39:41 +01:00
Luong NGUYEN 58e586f09b refactor: Add new V2.0 logo with dark/light mode support to all markdown files
- Update all main markdown files (INDEX.md, LEARNING-ROADMAP.md, QUICK_REFERENCE.md, CONTRIBUTING.md, claude_concepts_guide.md, resources.md) with new responsive picture element
- Add logo to all subdirectory README files in feature folders (01-10) and plugins
- Replace old markdown image syntax with HTML picture element for dark/light mode adaptation
- Logo automatically displays dark mode version when system prefers dark mode
- Maintain correct relative paths for all nesting levels (../, ../../, etc.)
- Update README.md with new logo syntax

All markdown files now use the new V2.0 starburst logo design with professional dark/light mode support.
2026-01-09 10:36:58 +01:00
Luong NGUYEN c2130fc769 refactor: Move Python configuration and requirements files to scripts/ directory for better organization 2026-01-09 09:55:03 +01:00
Luong NGUYEN afa94be553 fix: Add pytest-cov to dev dependencies for coverage reporting in CI 2026-01-09 09:50:50 +01:00
Luong NGUYEN 079988c999 fix: Add comprehensive ignore patterns and spell check terms for CI success 2026-01-09 09:49:02 +01:00
Luong NGUYEN e3835151c9 fix: Expand spell check dictionary and link check ignore patterns for CI 2026-01-09 09:44:01 +01:00
Luong NGUYEN 236450485f chore: Add coverage reports and uv.lock to gitignore 2026-01-09 09:39:02 +01:00
Luong NGUYEN 909b4dda7b fix: Update pyproject.toml to fix setuptools package discovery and license format 2026-01-09 09:38:25 +01:00
Luong NGUYEN 9b34a69acd fix: Repair dead links in SECURITY.md and update spell check dictionary 2026-01-09 09:35:25 +01:00
Luong NGUYEN 34e2908d1b docs: Update last updated date and clarify model names 2026-01-09 09:28:31 +01:00
Luong NGUYEN 241baf30bd security: Add comprehensive security policy and vulnerability reporting process 2026-01-09 09:25:00 +01:00
Luong NGUYEN 0101d7da84 docs: Add Testing section to README with link to TESTING.md guide 2026-01-09 09:23:35 +01:00
Luong NGUYEN 728bd50804 ci: Add comprehensive automated testing workflows and documentation 2026-01-09 09:22:49 +01:00
Luong NGUYEN 47601c026c docs: Update learning roadmap to emphasize CLI Reference (lesson 10) with flexible learning paths 2026-01-09 09:18:39 +01:00
Luong NGUYEN c8d60700b5 docs: Add comprehensive Code of Conduct and update documentation 2026-01-09 09:17:29 +01:00
Luong NGUYEN 62e8dd9042 ci: Add GitHub Actions workflow for documentation checks 2026-01-09 09:16:23 +01:00
Luong NGUYEN 5fd984a089 docs: Add GitHub issue and PR templates 2026-01-09 09:15:12 +01:00
Luong NGUYEN c1a1c68be5 docs: Add MIT License and update license references in README and CONTRIBUTING 2026-01-09 09:14:05 +01:00
Luong NGUYEN 44233fc7d1 docs: Add comprehensive CONTRIBUTING.md guidelines and update README contributing section 2026-01-09 09:10:24 +01:00
Luong NGUYEN b477228720 docs: Move star history chart to end of README and update table of contents 2026-01-09 09:08:52 +01:00
Luong NGUYEN 6e699c2f47 design: Redesign logo with green terminal aesthetic 2026-01-09 01:33:53 +01:00
Luong NGUYEN ae58f0bfc0 docs: Add star history badge to README 2026-01-09 01:23:27 +01:00
Luong NGUYEN 00c734fdbf docs: Move Contributors section to bottom of README 2026-01-09 01:21:49 +01:00
Luong NGUYEN 43f7b6c5a6 docs: Add table of contents to README 2026-01-09 01:21:01 +01:00
Luong NGUYEN 3964d26703 docs: Add tagline and "Why This Guide?" section to README
Highlight differences from official Anthropic docs:
- Visual tutorials with diagrams vs reference docs
- Production-ready templates vs basic snippets
- Progressive learning path vs feature-organized
- Guided roadmap with time estimates
2026-01-09 01:18:58 +01:00
Luong NGUYEN 49754ae89d refactor: Condense clean-code-reviewer agent from 345 to 67 lines
- Make agent self-contained by embedding rules (no external file reference)
- Remove redundant sections and verbose examples
- Consolidate evaluation categories into concise checklist
- Simplify output format template
2026-01-09 01:02:22 +01:00
Luong NGUYEN fdbc458ede docs: Add clean-code-reviewer subagent and rules reference
- Add clean-code-reviewer.md subagent for Clean Code principle enforcement
- Add clean-code-rules.md with Robert C. Martin's Clean Code guidelines
2026-01-09 00:32:37 +01:00
Luong NGUYEN 821709b143 Update all lessons 2026-01-08 23:51:46 +01:00
Luong NGUYEN e136b581d9 Add slides/ folder to store some good slides 2026-01-05 22:34:21 +01:00
Luong NGUYEN 15c8ce7f33 docs: Add Boris Cherny's Claude Code workflow to resources
Add link to the creator's X thread sharing his systematized workflow
including parallel agents, Plan mode, and verification hooks.
2026-01-03 00:49:43 +01:00
Luong NGUYEN 3aeffb2f19 docs: Remove star history chart (API not ready) 2025-12-30 22:21:40 +01:00
Luong NGUYEN ad5b1c1b04 docs: Add star history chart to README 2025-12-30 22:16:30 +01:00
Luong NGUYEN 31e779c0e5 chore: Remove openspec from tracking and add to gitignore
- Add openspec/ to .gitignore
- Keep local files but exclude from version control
2025-12-26 13:45:15 +01:00
Luong NGUYEN bb2a0fda42 chore: Remove blog-post from tracking and add to gitignore
- Add blog-post/ to .gitignore
- Keep local files but exclude from version control
2025-12-26 11:04:41 +01:00
Luong NGUYEN 0fcac18357 docs: Add blog post and new slash commands for development workflow
- Add blog post: 4 Essential Slash Commands I Use in Every Project
- Add new slash commands: /doc-refactor, /setup-ci-cd, /unit-test-expand
- Update slash-commands README with comprehensive documentation
- Simplify /push-all command structure
- Archive add-blog-post-slash-commands change
- Add blog-post spec and pending openspec changes
2025-12-26 11:02:19 +01:00
Luong NGUYEN 8ef1e4a0c0 docs: Update hooks lesson with improved context tracker example
- Replace simple Stop-only context-usage hook with hook pair pattern
- Add UserPromptSubmit + Stop hook combination for tracking delta
- Include both char-estimation and tiktoken versions as separate files
- Show how to use session_id for isolated state tracking
2025-12-25 18:10:16 +01:00
Luong NGUYEN fa9603af11 chore: Archive add-cli-lesson change 2025-12-25 00:02:55 +01:00
Luong NGUYEN 513171332e fix: correct token calculation in context-usage hook example
The hook was converting total_chars to string before calculating tokens,
resulting in ~0 tokens reported. Fixed to calculate directly from char count.

- Remove unused estimate_tokens() function
- Calculate tokens as total_chars // 4 directly
- Archive fix-context-usage-hook change
2025-12-24 23:54:35 +01:00
Luong NGUYEN ecd3dba49a chore: Archive update-skills-lesson change 2025-12-24 23:52:39 +01:00
Luong NGUYEN e978c4949d docs: Update skills lesson with managing, debugging, and best practices
- Add Managing Skills section (viewing, testing, updating, removing)
- Expand Troubleshooting with debugging tips for skipped skills, YAML errors, permissions
- Add Version History best practice section with example
- Enhance allowed-tools documentation with security use cases
- Add Multi-File Skill Example showing complex skill structure
- Add version history to code-review SKILL.md example

Based on: https://code.claude.com/docs/en/skills
2025-12-24 23:30:50 +01:00
Luong NGUYEN b44d9d6a77 chore: Archive update-subagents-lesson change 2025-12-24 23:28:19 +01:00
Luong NGUYEN 2177035e51 docs: Update subagents lesson based on official documentation
- Update README with all official features:
  - Built-in subagents (General-Purpose, Plan, Explore)
  - /agents command for interactive management
  - CLI-based configuration with --agents flag
  - Resumable agents with agentId
  - File locations and priority order
  - Configuration fields (name, description, tools, model, permissionMode, skills)
  - Chaining subagents for multi-agent workflows

- Update existing subagent examples to new format:
  - Add model field
  - Update YAML frontmatter format
  - Add proactive usage hints in descriptions

- Add new example subagents:
  - debugger.md - Root cause analysis specialist
  - data-scientist.md - SQL/BigQuery data analysis expert

Based on: https://code.claude.com/docs/en/sub-agents
2025-12-24 23:27:19 +01:00