afa94be553
fix: Add pytest-cov to dev dependencies for coverage reporting in CI
2026-01-09 09:50:50 +01:00
079988c999
fix: Add comprehensive ignore patterns and spell check terms for CI success
2026-01-09 09:49:02 +01:00
e3835151c9
fix: Expand spell check dictionary and link check ignore patterns for CI
2026-01-09 09:44:01 +01:00
236450485f
chore: Add coverage reports and uv.lock to gitignore
2026-01-09 09:39:02 +01:00
909b4dda7b
fix: Update pyproject.toml to fix setuptools package discovery and license format
2026-01-09 09:38:25 +01:00
9b34a69acd
fix: Repair dead links in SECURITY.md and update spell check dictionary
2026-01-09 09:35:25 +01:00
34e2908d1b
docs: Update last updated date and clarify model names
2026-01-09 09:28:31 +01:00
241baf30bd
security: Add comprehensive security policy and vulnerability reporting process
2026-01-09 09:25:00 +01:00
0101d7da84
docs: Add Testing section to README with link to TESTING.md guide
2026-01-09 09:23:35 +01:00
728bd50804
ci: Add comprehensive automated testing workflows and documentation
2026-01-09 09:22:49 +01:00
47601c026c
docs: Update learning roadmap to emphasize CLI Reference (lesson 10) with flexible learning paths
2026-01-09 09:18:39 +01:00
c8d60700b5
docs: Add comprehensive Code of Conduct and update documentation
2026-01-09 09:17:29 +01:00
62e8dd9042
ci: Add GitHub Actions workflow for documentation checks
2026-01-09 09:16:23 +01:00
5fd984a089
docs: Add GitHub issue and PR templates
2026-01-09 09:15:12 +01:00
c1a1c68be5
docs: Add MIT License and update license references in README and CONTRIBUTING
2026-01-09 09:14:05 +01:00
44233fc7d1
docs: Add comprehensive CONTRIBUTING.md guidelines and update README contributing section
2026-01-09 09:10:24 +01:00
b477228720
docs: Move star history chart to end of README and update table of contents
2026-01-09 09:08:52 +01:00
6e699c2f47
design: Redesign logo with green terminal aesthetic
2026-01-09 01:33:53 +01:00
ae58f0bfc0
docs: Add star history badge to README
2026-01-09 01:23:27 +01:00
00c734fdbf
docs: Move Contributors section to bottom of README
2026-01-09 01:21:49 +01:00
43f7b6c5a6
docs: Add table of contents to README
2026-01-09 01:21:01 +01:00
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
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
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
821709b143
Update all lessons
2026-01-08 23:51:46 +01:00
e136b581d9
Add slides/ folder to store some good slides
2026-01-05 22:34:21 +01:00
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
3aeffb2f19
docs: Remove star history chart (API not ready)
2025-12-30 22:21:40 +01:00
ad5b1c1b04
docs: Add star history chart to README
2025-12-30 22:16:30 +01:00
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
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
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
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
fa9603af11
chore: Archive add-cli-lesson change
2025-12-25 00:02:55 +01:00
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
ecd3dba49a
chore: Archive update-skills-lesson change
2025-12-24 23:52:39 +01:00
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
b44d9d6a77
chore: Archive update-subagents-lesson change
2025-12-24 23:28:19 +01:00
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
d291519452
chore: Archive add-context-usage-hook-example change
2025-12-24 23:22:58 +01:00
9c5c7c5049
docs: Add context usage reporter hook example
...
Add Example 6 showing how to create a hook that reports context/token
usage after each Claude response:
- Python script reads transcript_path to access conversation history
- Estimates tokens using ~4 chars/token heuristic
- Outputs one-line report: "Context: ~45k/200k tokens (77% remaining)"
- Documents both Stop and UserPromptSubmit hook configurations
- Explains limitations (estimate vs exact /context command)
2025-12-24 23:21:38 +01:00
e144e42b20
chore: Archive update-hooks-lesson change
...
Move completed change to archive and create hooks-documentation spec.
2025-12-24 15:48:15 +01:00
eb72f002ef
docs: Add CLI Reference lesson (10-cli)
...
Add comprehensive CLI reference documentation covering:
- All CLI commands and flags with examples
- Model configuration, system prompts, permissions
- Output formats (text, JSON, stream-JSON)
- Session management and MCP configuration
- 7 high-value use cases: CI/CD, piping, batch processing,
multi-session workflows, custom agents, security, JSON API
Update README.md and LEARNING-ROADMAP.md with CLI lesson
navigation and learning path integration.
2025-12-24 15:42:24 +01:00
c1ef277925
docs: Rewrite hooks documentation based on official Claude Code docs
...
- Update configuration format to use array-based matcher/hooks structure
- Document all 9 official hook events (PreToolUse, PermissionRequest,
PostToolUse, Notification, UserPromptSubmit, Stop, SubagentStop,
PreCompact, SessionStart, SessionEnd)
- Add JSON stdin input/output documentation with schemas
- Document exit code semantics (0=success, 2=blocking, other=warning)
- Add prompt-based hooks for Stop/SubagentStop events
- Add environment variables (CLAUDE_PROJECT_DIR, CLAUDE_ENV_FILE, etc.)
- Add security considerations with official disclaimer
- Add MCP tool hook patterns (mcp__<server>__<tool>)
- Update example scripts to use JSON stdin parsing
- Add debugging section with claude --debug flag
- Remove incorrect hook types (PreCommit, PostCommit, PrePush)
Based on official documentation: https://code.claude.com/docs/en/hooks
2025-12-24 15:36:49 +01:00
c807674593
chore: Archive update-slash-commands-session change
...
- Move change to archive/2025-12-24-update-slash-commands-session
- Create specs/slash-commands/spec.md with 10 requirements
2025-12-24 15:32:26 +01:00
ee0f4bd5d9
docs: Update slash commands documentation with official features
...
- Add comprehensive built-in commands reference (40+ commands)
- Document argument handling ($ARGUMENTS, $1, $2, etc.)
- Add bash execution syntax (! prefix) and file references (@ prefix)
- Update frontmatter to official fields (allowed-tools, argument-hint, model, etc.)
- Add Plugin Commands and MCP Slash Commands sections
- Add SlashCommand Tool documentation for programmatic invocation
- Add Skills vs Slash Commands comparison table
- Create commit.md example with bash execution and context
- Update existing examples to use official frontmatter format
- Add OpenSpec proposal for change tracking
2025-12-24 15:30:47 +01:00
b180c4f8e5
Update slide with correct number
2025-12-15 22:01:53 +01:00
438501b0af
add presentation on Coding with AI
2025-12-15 14:59:37 +01:00
3a1f45e5e9
fix(ci): Use virtual environments instead of --system flag
...
The --system flag fails on GitHub Actions runners because Python is
externally managed. Using uv venv + uv pip install instead.
2025-12-10 23:54:08 +01:00
540508f392
ci: Add DevOps quality assurance with pre-commit hooks and GitHub Actions
...
- Add pre-commit hooks: Ruff lint/format, Bandit security scan, YAML/TOML validation
- Add GitHub Actions CI workflow: lint, security, test, and build jobs
- Configure Ruff and Bandit in pyproject.toml
- Add pytest test suite for build_epub.py (25 tests)
- Fix code issues: exception chaining, httpx timeout, formatting
- Add requirements.txt and requirements-dev.txt
2025-12-10 23:49:52 +01:00
Luong NGUYEN