luongnv89/claude-howto holds a health index of 74 out of 100, placing it in the Good band. It scores highest on Community & Adoption (95/100) and lowest on Security (37/100). It was last updated 6 days ago. A single contributor accounts for most of its recent work.
74
overall / 100
Good
Software health index
Metrics are grouped into weighted categories on one standardized 1–100 scale. Overall starts as their weighted mean; when public evidence triggers the High-Risk Jurisdiction Policy, the rating is adjusted and receives an At risk ceiling of 49. AI Readiness sits outside the overall score.
74
Excellent85-100Exemplary; meets essentially all checked criteria
Good70-84Healthy; minor gaps
Moderate50-69Acceptable with notable gaps; review recommended
At risk30-49Significant weaknesses; adoption warrants caution
Critical1-29Severe problems (abandoned, single-maintainer, no hygiene)
Score profile
Each axis is a category. The shape matters more than the average — a healthy subject fills the whole shape, while a spike-and-crater profile means strength in one dimension is masking risk in another.
How well is the repo equipped to be developed and maintained with AI coding agents? An independent, experimental badge — weight 0.0, so it is surfaced on its own and does not affect the overall health score.
Type-checkable code — Python without a type-check config
55/55
Manageable file sizes — 0/43 source files over 60KB
Inputs used
primary_language
Python
largest_source_bytes
37,875
source_files_sampled
43
oversized_source_files
0
Key facts
40,627GitHub stars
23contributors
236commits, last 12 months
6days since last push
10releases
1bus factor
11open issues
PyPIpackage ecosystems
Data collection warnings
Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token
Could not fetch pypi package 'claude-howto' from its registry
GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository
More detail
Star and fork history 0 ★ / 4,937 ⇿
0Stars
4,937Forks
1Releases
When each star and fork was added, collected from GitHub and bucketed by day. Cumulative growth sits directly above the daily additions it is made of, so the two read against each other: steady organic accretion looks nothing like an abrupt, short-lived burst. Where that difference is measurable, it is reported as growth authenticity.
Only the most recent history is shown — this repository exceeds the collection window, so the earliest history is not captured.
Major 0Minor 0Patch 1
OpenSSF Scorecard 3.7 / 10
3.7aggregate
Independent, tool-agnostic security assessment from the open-source OpenSSF Scorecard. Each check rewards a security practice, not a specific vendor's tool. Checks Scorecard could not determine are marked n/a and excluded from the security score (never counted as zero).Scorecard v5.5.0 · 2026-07-29 00:07 UTC
The resolved dependency set could not be collected for this report: GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository
Raw JSON report machine-readable
{
"data": {
"repo": {
"topics": [
"claude-code",
"guide",
"tutorial"
],
"is_fork": false,
"size_kb": 14495,
"has_wiki": true,
"homepage": "http://luongnv.com/claude-howto/",
"languages": {
"CSS": 2989,
"HTML": 20005,
"Jinja": 12443,
"Shell": 82523,
"Python": 315555,
"JavaScript": 8543
},
"pushed_at": "2026-07-22T15:18:16Z",
"created_at": "2025-11-07T22:59:34Z",
"owner_type": "User",
"updated_at": "2026-07-28T23:12:51Z",
"description": "A visual, example-driven guide to Claude Code — from basic concepts to advanced agents, with copy-paste templates that bring immediate value.",
"is_archived": false,
"is_disabled": false,
"license_spdx": "MIT",
"default_branch": "main",
"license_spdx_raw": "MIT",
"primary_language": "Python",
"significant_languages": [
"Python",
"Shell"
]
},
"owner": {
"blog": "https://luongnv.com",
"name": "Luong NGUYEN",
"type": "User",
"login": "luongnv89",
"company": "https://montimage.com",
"location": "Paris, France",
"followers": 926,
"avatar_url": "https://avatars.githubusercontent.com/u/3288457?v=4",
"created_at": "2013-01-16T18:42:20Z",
"is_verified": null,
"public_repos": 137,
"account_age_days": 4941
},
"license": {
"state": "standard",
"spdx_id": "MIT",
"raw_spdx": "MIT",
"file_present": true,
"scorecard_found": true,
"profile_has_license": true
},
"activity": {
"releases": [
{
"tag": "v2.1.160",
"kind": "patch",
"published_at": "2026-06-02T06:38:08Z"
},
{
"tag": "v2.1.138",
"kind": "patch",
"published_at": "2026-05-09T16:30:29Z"
},
{
"tag": "v2.1.131",
"kind": "patch",
"published_at": "2026-05-09T16:30:23Z"
},
{
"tag": "v2.1.126",
"kind": "patch",
"published_at": "2026-05-02T22:18:45Z"
},
{
"tag": "v2.1.112",
"kind": "patch",
"published_at": "2026-04-16T21:21:22Z"
},
{
"tag": "v2.3.0",
"kind": "minor",
"published_at": "2026-04-07T08:37:53Z"
},
{
"tag": "v2.2.0",
"kind": "minor",
"published_at": "2026-03-26T14:06:27Z"
},
{
"tag": "v2.1.1",
"kind": "patch",
"published_at": "2026-03-13T09:51:01Z"
},
{
"tag": "v2.1.0",
"kind": "minor",
"published_at": "2026-03-13T08:08:10Z"
},
{
"tag": "v2.0.0",
"kind": "major",
"published_at": "2026-02-25T22:21:28Z"
}
],
"recent_commits": [
{
"oid": "97fc961a8cc68ade7e74f2dbd5c9dc5491ce55bb",
"body": "Fixed a configuration error in the hooks Chinese guide",
"is_bot": false,
"headline": "Merge pull request #77 from ytche/main",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-07-22T15:18:15Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f27b57dfc2e865014461382fc3dfcff5331b4c45",
"body": "The JSON example in the installation section had a trailing comma after\nthe hooks object, making it invalid JSON. This prevents users from\ncopy-pasting the configuration successfully.",
"is_bot": false,
"headline": "fix(zh/hooks): remove trailing comma in JSON config example",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-07-22T15:14:32Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c10d54c0d75b8ce2c32f7d5e5b7ae33889592565",
"body": "Bumps tutorial coverage from the v2.1.212 baseline (2026-07-18 sync) to\nv2.1.217 (v2.1.213 was skipped upstream), plus a repo-internal accuracy\naudit.\n\nFixed:\n- Nested-subagent-spawning claim reversed (v2.1.217): 04-subagents/README.md\n and CATALOG.md stated nesting up to 5 levels as current behavi\n[…]\nning notes, /context and /compact notes\n- /verify and /code-review explicit-invocation-only note (v2.1.215)\n\nMirrored applicable P0/P1 fixes into vi/ja/zh/uk translations where the\nsame claim existed.",
"is_bot": false,
"headline": "docs: sync to Claude Code v2.1.217",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-07-22T14:47:38Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "e9489e645d6e5bfbf3fffe0bf7c7962d15635bd8",
"body": "Add Vexilo field guide to Additional Resources",
"is_bot": false,
"headline": "Merge pull request #149 from lilhawk7077/main",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-07-22T14:43:03Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8f045173d1b1e876d101eb9a94972585f57c4ed1",
"body": "* docs: sync to Claude Code v2.1.212\n\nBumps tutorial coverage from the v2.1.206 baseline (2026-07-11 sync) to\nv2.1.212, plus a repo-internal accuracy audit that surfaced defects\nindependent of the version delta.\n\nFixed:\n- Dead `#` memory-shortcut removed from 02-memory/README.md (two places\n docume\n[…]\nLOG\n\"Known gaps\" entries this same PR already resolved (memory hierarchy\nrewrite, blog-draft gitignore confirmation) and adds the missing\nFixed-section bullet documenting the memory hierarchy rewrite.",
"is_bot": false,
"headline": "docs: sync to Claude Code v2.1.212 (#154)",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-07-18T15:21:21Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "a645ffe6b027c2dfb56c4efcbba1c8051f0ff006",
"body": "* docs: correct stale content for Claude Code v2.1.206\n\nFix content that no longer matches current Claude Code behavior:\n\n- 04-subagents: remove the /agents creation-wizard instructions\n (wizard removed in v2.1.198); point users to ask Claude or edit\n .claude/agents/ files directly. Explore agent \n[…]\nsing /simplify row to the bundled-skills table (it was already\n referenced as a distinct skill in the /code-review row) and drop the\n hard skill count in favor of pointing at the commands reference.",
"is_bot": false,
"headline": "docs: sync to Claude Code v2.1.206 (#151)",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-07-11T06:00:35Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "0f3fe1d8487b02baf30538f486a6775352020671",
"body": "Cut SKILL.md body ~230 lines by extracting the deep-assessment round\nquestions, output templates, and topic recommendations into references/\n(deep-assessment-rounds.md, output-templates.md, topic-recommendations.md).\nKeep the scoring-map table inline for correctness. Rewrite description,\nadd a worked example and Acceptance Criteria. Normalize frontmatter;\nmetadata.version 2.3.0 -> 2.4.0.",
"is_bot": false,
"headline": "docs(skills): slim self-assessment skill for context efficiency",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-07-10T22:15:00Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "4ebfb80b0afe3eeb88ca04840500553429c5cadd",
"body": "Rewrite description (imperative + negative-trigger clause), add\nPrerequisites, guardrails, Acceptance Criteria, and Edge Cases sections.\nMove the results output template to references/results-template.md for\ncontext efficiency. Normalize frontmatter (metadata.version/author,\neffort). asm-eval overallScore 70 (C) -> 96 (A).",
"is_bot": false,
"headline": "docs(skills): improve lesson-quiz skill to asm-eval grade A",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-07-10T22:11:42Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "92044e5e141f40d53bbfd4f250d6eae2640c03a3",
"body": null,
"is_bot": false,
"headline": "Add Vexilo field guide to Additional Resources",
"author_name": "lilhawk7077",
"author_login": "lilhawk7077",
"committed_at": "2026-07-01T11:10:35Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "ce10c700549d91afd3f22d1597337f9b3f58c6cc",
"body": "astral-sh/setup-uv enable-cache defaults to keying off uv.lock, which\nthis repo intentionally gitignores, so every push to main since\n2026-06-17 failed at the cache step before the build ever ran.",
"is_bot": false,
"headline": "fix(pages): remove uv cache glob that broke on missing uv.lock",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-07-01T05:59:03Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d4243d9c7ba0d1e69ddb27570b18388ac9f4c937",
"body": null,
"is_bot": false,
"headline": "docs: sync to Claude Code v2.1.195",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-06-28T21:50:22Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6b9ce6463f96d5556a0f3c92aaaf80123ec42100",
"body": "* docs: sync to Claude Code v2.1.187\n\nSync the delta from v2.1.179 to v2.1.187 across six modules.\n\n- slash-commands: reclassify `/review <pr>` as a supported PR-review entry\n point (same engine as `/code-review medium`, v2.1.186), no longer deprecated\n- advanced-features: `!` bash output now auto-\n[…]\ninst the\nofficial changelog). The previous 'Since v2.1.187 (changed in v2.1.186)'\nwording was misleading and inconsistent with 10-cli/README.md, which\ncorrectly tags respondToBashCommands as v2.1.186.",
"is_bot": false,
"headline": "docs: sync to Claude Code v2.1.187 (#146)",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-06-24T13:46:07Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "8143e37d1b265e6225b9e28be1a795ee6f00e836",
"body": "Optimize the lesson -> GitHub Pages conversion in build_website.py:\n\n- BS4 single parse: thread one BeautifulSoup tree through heading-id\n normalisation, TOC extraction, and link rewriting instead of\n reparsing the rendered HTML 3x per page. Build drops 2.97s -> 1.77s\n (~40% faster) on the ~222-p\n[…]\ntput is semantically identical to the prior build; the only diff is raw\nhand-written <img/> badges serializing as <img></img> (valid HTML5,\nrenders identically; nothing validates generated site HTML).",
"is_bot": false,
"headline": "perf(scripts): single-parse website build + CI caching (#144)",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-06-17T10:14:59Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "6963f37e5d04311ea0ca7db68a0c0823f3608488",
"body": "Additive sync over v2.1.176 baseline. No breaking changes, removals, or\ndeprecations in the v2.1.177-v2.1.179 window (v2.1.177 is a chore-only\nrelease; v2.1.179 is bugfix-only plus a plugin perf note).\n\nNew in v2.1.178:\n- 10-cli: document generalized Tool(param:value) parameter-matching\n permission\n[…]\nscription before submit (01-slash-commands)\n\nNew in v2.1.179:\n- 07-plugins: improved plugin loading performance in remote sessions\n\nFooters on all five edited files bumped to v2.1.179 / June 17, 2026.",
"is_bot": false,
"headline": "docs: sync to Claude Code v2.1.179 (#143)",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-06-17T08:48:20Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "ae656f6fb82ec683446ae53f3eb77d9e3909febf",
"body": "* docs: sync to Claude Code v2.1.176\n\nFix the subagent-nesting self-contradiction in 04-subagents and document\nadditive features shipped in v2.1.172-v2.1.176:\n\n- 04-subagents: subagents can now spawn subagents (up to 5 levels, v2.1.172),\n replacing the stale \"no nested spawning\" line; footer bumped\n[…]\n to\na single tracked issue) are not hard-blocked on a missing Closes #N — they opt\nin via a 'Type: docs' body line, matching how chore/refactor PRs work. The\nother three traceability checks still run.",
"is_bot": false,
"headline": "docs: sync to Claude Code v2.1.176 (#141)",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-06-15T05:54:49Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "733c0882c3a83db86ce279759659c9c76fafe172",
"body": "* docs: sync to Claude Code v2.1.170\n\nAdditive sync covering features shipped in v2.1.161-2.1.170. No breaking\nchanges in the window.\n\n- 10-cli: add Claude Fable 5 model row (claude-fable-5); --safe-mode flag\n + CLAUDE_CODE_SAFE_MODE / CLAUDE_CODE_DISABLE_BUNDLED_SKILLS env vars;\n note --fallback-\n[…]\nID on --resume (v2.1.161);\n add metadata footer (none existed)\n- refresh footers on all edited files to 2.1.170 / June 10, 2026\n\n* fix(mcp): correct CLAUDE_CODE_SESSION_ID --resume version to 2.1.163",
"is_bot": false,
"headline": "docs: sync to Claude Code v2.1.170 (#140)",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-06-10T06:19:13Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "fcdc0887f127a0da6fd9e6a9d4c55a1dac6d8c17",
"body": null,
"is_bot": false,
"headline": "chore(release): v2.1.160",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-06-02T06:26:15Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d7ab99f224c84d872257db4e108048967887956f",
"body": null,
"is_bot": false,
"headline": "docs: sync to Claude Code v2.1.160",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-06-02T06:14:08Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "1b4115769f02681f25c3c95d82227733d53720ec",
"body": "…lations (#133)\n\nMirror the English fix from #131 into the translated docs. The precedence\ntable in 02-memory and the v2.1.119 /config notes still encoded the old,\nincorrect order (user above project/local).\n\n- vi/02-memory: table rows -> local(3) -> project(4) -> user(5, lowest)\n- ja/02-memory: tab\n[…]\n https://code.claude.com/docs/en/settings:\nManaged -> CLI args -> Local -> Project -> User (lowest).\n\nzh is missing the whole settings section (structural port), tracked\nseparately in #132.\n\nRefs #132",
"is_bot": false,
"headline": "fix(memory): correct settings.json precedence order in vi/ja/uk trans…",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-06-02T04:57:08Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "e30220c70f721a3978efce5f0aa86cbade581d71",
"body": "…0) (#131)\n\n- 10-cli/README.md: policy → local → project → user (was project → local → policy → user)\n- 02-memory/README.md: reorder table levels 3/4/5 to local → project → user\n- 02-memory/README.md: update note text to match corrected order",
"is_bot": false,
"headline": "fix(memory): correct settings.json precedence chain order (Closes #13…",
"author_name": "Real",
"author_login": "Sanford284",
"committed_at": "2026-05-31T21:24:08Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c08c293aa47a2605b370ba7749c2ad1403fa18e8",
"body": "* docs: sync to Claude Code v2.1.156 and Claude Opus 4.8\n\nModel bump Opus 4.7 -> Opus 4.8 and version sync v2.1.150 -> v2.1.156.\n\n- Rewrite effort-ladder claims for Opus 4.8 (default `high`; `xhigh` on\n 4.8/4.7; `max` on 4.8/4.7/4.6 and Sonnet 4.6; Haiku has no effort).\n- Replace soon-removed CLAUD\n[…]\n default-save inversion, lean system prompt, status-line\n COLUMNS/LINES, and the ultracode `/effort` note.\n\n* docs(cli): drop unverified fast-mode dollar pricing, keep verified rate/speed multipliers",
"is_bot": false,
"headline": "docs: sync to Claude Code v2.1.156 and Claude Opus 4.8 (#129)",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-05-29T09:28:55Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "c7261394b0719ae12246e8212768100dbdedecd0",
"body": "* fix(i18n): re-point translations to code-review-specialist rename\n\nThe English code-review skill was renamed to code-review-specialist in #127\nto avoid shadowing the new built-in /code-review command. Mirror that rename\nacross the uk, vi, ja, zh locales: rename each 03-skills/code-review/ director\n[…]\nmd, QUICK_REFERENCE.md, and the vi\nTRANSLATION_QUEUE.md.\n\n* chore: ignore .asm-improver and .gitissue tooling state\n\n* fix(i18n): re-point remaining code-review install paths to code-review-specialist",
"is_bot": false,
"headline": "fix(i18n): re-point translations to code-review-specialist rename (#128)",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-05-26T08:29:51Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "5850da9a14cfbefab4625567dd2316c2bc6be261",
"body": "* docs: sync to Claude Code v2.1.150\n\n* fix(README): bump stale version prose to v2.1.150",
"is_bot": false,
"headline": "docs: sync to Claude Code v2.1.150 (#127)",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-05-26T06:58:44Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "46941a38fc9a6beeca02b755a29110465de87059",
"body": null,
"is_bot": false,
"headline": "docs: sync to Claude Code v2.1.145 (Closes #126) (#125)",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-05-20T11:13:39Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2230a6ef10d88c45d84e597254670035fcdcae60",
"body": "…124)\n\nFollow-up to #123 — that PR fixed module README logo paths but missed\nroot-level translated files (README, INDEX, CATALOG, CONTRIBUTING,\nSTYLE_GUIDE, etc.) which had the same broken-path pattern: they used\n`resources/logos/...` (root-relative) but live one directory deep, so\nthey resolved to \n[…]\n`resources/logos/...` to mirror the English source — it documents\nthe canonical pattern, not the path the file itself uses.\n\nFiles: zh/ (×9), uk/ (×4), vi/ (×2). ja/STYLE_GUIDE.md was already\ncorrect.",
"is_bot": false,
"headline": "fix(i18n): correct logo image paths in translated root-level files (#…",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-05-20T09:15:36Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "7e369eefcb6f3a2bcf24c5ac40cd0c7517851108",
"body": null,
"is_bot": false,
"headline": "fix(i18n): correct logo image paths in translated module READMEs (#123)",
"author_name": "qszhu",
"author_login": "iiitutu",
"committed_at": "2026-05-19T08:45:49Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "30d5ad52bc5d0ecac24a5250ca812213566d47a0",
"body": "Bumps tutorial coverage from v2.1.138 → v2.1.143. Highlights:\n\n- /goal and /scroll-speed slash commands (v2.1.139)\n- claude agents Agent View (Research Preview) with 9 dispatch flags\n- claude plugin details and marketplace context-cost projection\n- Hook exec form (args), continueOnBlock on PostToolU\n[…]\nn; Routines marketing name note\n\nAlso bumps stale \"28 hook events\" counts in CATALOG/README to 29 and\nrefreshes the metadata footer (Last Updated, Claude Code Version,\nSources) on every modified file.",
"is_bot": false,
"headline": "docs: sync to Claude Code v2.1.143 (5 patches since v2.1.138)",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-05-19T05:08:33Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "3557d791f54e916fe30750afb9866b3642a665bd",
"body": "…5) (#121)\n\n* feat(scripts): add static website generator from markdown sources (#85)\n\nGenerate an elegant, mobile-friendly static site from the existing\ntutorial markdown files. The markdown remains the single source of\ntruth — `scripts/build_website.py` reads from the same `.md` files the\nEPUB bui\n[…]\ns browser — no console errors, no failed network calls,\nMermaid diagrams render).\n\n* fix(website): use tree URLs for repo directory links (#85)\n\n* fix(website): include additional top-level docs (#85)",
"is_bot": false,
"headline": "feat(scripts): add static website generator from markdown sources (#8…",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-05-15T06:55:29Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "553a31993417ecbeacccb55a2564d9d54130ba11",
"body": "Catches mechanical rendering bugs that look fine in a diff but render\nwrong on GitHub / in the EPUB build: inner backticks inside inline-code\nspans (PR #114), unescaped pipes in table cells (PR #115), stray\n`$ARGUMENTS` outside code, and unmatched fences.\n\nScope: `**/README.md` across tutorial modul\n[…]\ne masking\n- scripts/tests/test_check_markdown_rendering.py: 20 unit tests,\n positive + negative per rule, currency-false-positive guard\n- .pre-commit-config.yaml: new global `markdown-rendering` hook",
"is_bot": false,
"headline": "feat(scripts): add markdown rendering validator (#119) (#120)",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-05-11T21:49:39Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "6e46b252764cc4abfc47bffa13c42b5a2dd254e6",
"body": "Escape backticks across en/ja/uk/vi/zh slash-commands and skills modules so the literal `!`command`` syntax renders correctly instead of breaking the inline-code span.",
"is_bot": false,
"headline": "fix(docs): escape inline-code backticks in `!`command`` references",
"author_name": "Stephen Guo",
"author_login": "stephenfire",
"committed_at": "2026-05-11T20:58:29Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b3571e8def64149e21f7440efb9ac844bcb44d2a",
"body": "Documents the v2.1.131 → v2.1.138 sync (PR #117) in the same format\nas the v2.1.131 entry. Pattern caught during release-manager review;\nthe original sync PR did not include a CHANGELOG update.",
"is_bot": false,
"headline": "chore(release): add v2.1.138 changelog entry",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-05-09T15:41:18Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6508e42e13b2588ee1dea2ab789903b8885aa36a",
"body": "Bump footers across 23 files to v2.1.138 and document new behavior:\n\n- 29 hook events (was 28); add Setup event row in 06-hooks\n- worktree.baseRef breaking default revert (v2.1.133)\n- parentSettingsBehavior + autoMode.hard_deny admin keys\n- effort.level hook input + CLAUDE_CODE_SESSION_ID/CLAUDE_EFF\n[…]\n hooks bypassed: env-only failures (python vs python3,\nmmdc render timeout). Content checks (cross-references, mermaid\nsyntax, markdown-lint, build-epub on changed files) all passed\nwhen run directly.",
"is_bot": false,
"headline": "docs: sync to Claude Code v2.1.138 (7 patches since v2.1.131) (#117)",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-05-09T10:25:28Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "59475f4ec54d8b373796ed4de5064ddf985ba29d",
"body": "Escape unescaped pipe characters in markdown table cells across\nzh/01-slash-commands, 10-cli, ja/10-cli, and vi/10-cli. Unescaped\npipes inside table cells are interpreted as column delimiters,\nbreaking table rendering.",
"is_bot": false,
"headline": "fix(markdown): escape pipe chars in translation and en tables (#115)",
"author_name": "qszhu",
"author_login": "iiitutu",
"committed_at": "2026-05-09T07:25:42Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d4b5cf56b4ae393971c5168536ba234741682c57",
"body": "Sync covers v2.1.128, v2.1.129, and v2.1.131 (May 2026). Highlights:\ngateway /v1/models discovery is now opt-in (CLAUDE_CODE_ENABLE_GATEWAY_MODEL_DISCOVERY),\nadded --plugin-url flag, disableRemoteControl setting, /mcp tool-count display,\nexpanded skillOverrides values, /context viz no longer leaks into conversation,\nCtrl+R cross-project default. Also reconciles slash-command count to 60+ and\nfixes the skill-count entry in CATALOG.",
"is_bot": false,
"headline": "docs: sync to Claude Code v2.1.131 (3 patches since v2.1.126)",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-05-06T21:55:28Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9701bb74c20b2bd5959f025a7b6f04e5d86aab45",
"body": null,
"is_bot": false,
"headline": "chore(release): v2.1.126",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-05-02T22:09:28Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0f8012c36e36b5fba50b2726d169a87cdf0966ba",
"body": "…(#111)\n\nBumps tutorial coverage from v2.1.119 → v2.1.126 (May 1, 2026 release).\nv2.1.120 was rolled back on its first release day (2026-04-24) but\nre-released 2026-04-28 with regressions fixed; v2.1.124/125 skipped.\n\nNew feature documentation:\n- claude project purge (v2.1.126) — 10-cli\n- claude plu\n[…]\nNGELOG.md v2.4.0 stale \"v2.1.120 was rolled back\" paragraph\n\nFooter refresh: 22 in-scope English files bumped to May 2, 2026 / 2.1.126.\nLocalized vi/zh/uk/ja trees out of scope (community-maintained).",
"is_bot": false,
"headline": "docs: sync to Claude Code v2.1.126 (six new releases since April 27) …",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-05-02T22:07:51Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "c78305971e181c0f5afe789f433c96023bd38cec",
"body": "…#76)\n\nThe lesson-quiz skill had two issues:\n1. Correct answers were always placed as the first option, making quizzes\n trivially solvable\n2. No feedback was given after each round — users had to wait until all\n 5 rounds were complete to see any results\n\nAdd a CRITICAL shuffle instruction requiring randomized option order for\neach question, and update round flow to show immediate per-question\nfeedback after each round.\n\nCo-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix(lesson-quiz): shuffle answer options and add per-round feedback (…",
"author_name": "Sean Xue",
"author_login": "seanxue",
"committed_at": "2026-05-02T07:59:24Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "d23da7f2dcd8d89e763c74cac7cc4d8864b3e8b2",
"body": "…-review SKILL.md (#62)\n\nThe code-review skill had templates/ and scripts/ directories alongside\nSKILL.md, but SKILL.md never referenced them. Since Claude Code only\nloads SKILL.md when a skill is invoked, the supporting files were\neffectively invisible. This adds a Reference Files section that\ninstructs Claude to read and use each supporting file.\n\nCloses #43\n\nCo-authored-by: Paperclip <noreply@paperclip.ing>",
"is_bot": false,
"headline": "fix(skills): add explicit references to templates and scripts in code…",
"author_name": "Murat Çelik",
"author_login": "muratclk",
"committed_at": "2026-05-02T07:59:18Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "5f50791f17770ef249ee81b3d91f9907d0dabcd2",
"body": "* fix(quiz): correct Q4 extended thinking toggle wording\n\n- \"visibility\" → \"on or off\"\n- \"always visible\" → \"always enabled\"\n- Added Ctrl+O verbose mode explanation\n\nCo-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>\n\n* chore: trigger CI re-run\n\n---------\n\nCo-authored-by: Claude Opus 4.7 <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix(quiz): correct Q4 extended thinking toggle wording (#109)",
"author_name": "lzw-git-all",
"author_login": "lzw-git-all",
"committed_at": "2026-05-01T22:54:33Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "f925478d787746578f45dcd679c1b6461f511d52",
"body": null,
"is_bot": false,
"headline": "docs(CLAUDE): condense guidance and add hard rules + token efficiency",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-05-01T22:50:22Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d2ead3ba1655b48cd3dbc553660a7aea021f3724",
"body": "…rathink keyword (#83)\n\n- Replace fictional `/think` example with official `ultrathink` keyword\n- Fix Q4 options: `/think` → `/effort max`, `--thinking` → `ultrathink`\n- Fix Q5: correct the answer that \"ultrathink\" DOES trigger deep reasoning\n- Sync changes across English, Ukrainian, and Vietnamese \n[…]\nttps://code.claude.com/docs/en/commands (no /think command exists)\n- https://code.claude.com/docs/en/model-config (ultrathink is valid keyword)\n\nCo-authored-by: Claude Opus 4.7 <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix(extended-thinking): correct fictional /think command to valid ult…",
"author_name": "lzw-git-all",
"author_login": "lzw-git-all",
"committed_at": "2026-05-01T06:22:15Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "faffbbb359046b5f58f6c175acb3d503c73036b9",
"body": "…mory (#107)\n\nThe lesson quiz Q2 had `#` prefix as the correct answer for adding\nmemory rules, but the lesson README explicitly states this was\ndiscontinued. Update answer to `/memory` or conversational request,\nand fix a residual `#` prefix reference in the README's \"Quick\nupdate workflow\" section.\n\nCloses #106\n\nCo-authored-by: Claude Opus 4.7 <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix(memory): correct quiz Q2 answer from discontinued # prefix to /me…",
"author_name": "Jeffrey Yang",
"author_login": "jeffreyyjp",
"committed_at": "2026-05-01T05:55:06Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "f393805e4a97713cd16be5034a956debd12c07db",
"body": "Remove the specific 21,800+ stars and 2,585+ forks numbers across en/zh/ja\nREADMEs. They go stale within a day of every commit. The Star History chart\nalready conveys current scale, and the trust bullets read fine without exact\ncounts.",
"is_bot": false,
"headline": "docs(README): drop hard-coded star/fork counts from trust section",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-04-29T22:23:15Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "1d1df9235bf552adeb0e22e0f6ee82e901535481",
"body": "- Translate all 101 markdown files: P1 core, all 10 modules, examples,\n auxiliary docs (CONTRIBUTING, CODE_OF_CONDUCT, SECURITY, CLAUDE.md, etc.),\n peripheral docs (.github/, docs/, resources/, scripts/)\n- Translate comments and user-facing messages in 06-hooks/*.sh examples\n- Copy 05-mcp/*.json e\n[…]\nwitcher to include 日本語\n- Add ja/TRANSLATION_NOTES.md (glossary + style guide)\n\nAll translations pass pre-commit quality gates (markdown-lint,\ncross-references, mermaid-syntax, link-check, build-epub).",
"is_bot": false,
"headline": "feat(i18n): Add Japanese (ja/) translation (#105)",
"author_name": "JiangCheng",
"author_login": "Foxsunshine",
"committed_at": "2026-04-29T22:16:46Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "32212292df53fe97db8a9d8e1327962e55055464",
"body": "- Backfill CHANGELOG.md with v2.4.0 entry summarizing the\n v2.1.112 → v2.1.119 sync work\n- Refresh SECURITY.md footer (Last Updated April 27, 2026;\n Next Review April 2027)\n- Fix model ID in 09-advanced-features/config-examples.json:\n claude-opus-4 → claude-opus-4-7 (3 occurrences) for\n consistency with documented model IDs\n- Remove RELEASE_NOTES.md stub that duplicated and contradicted\n CHANGELOG.md",
"is_bot": false,
"headline": "docs: sync to Claude Code v2.1.119 (delta from 2026-04-24 plan) (#102)",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-04-27T05:16:00Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8e2b74574994a47625f52c65c0fcad8b7f51b4a2",
"body": "…ll steps (#101)\n\nCloses #99\n\n- Replace shell-interpolated JSON build with the argv-based Python pattern\n from session-end.sh, so notes containing quotes or backslashes don't\n produce invalid JSON.\n- Add mkdir/cp/chmod install block before the Configuration section so\n the path in settings.json resolves to a real file.",
"is_bot": false,
"headline": "docs(hooks): align README Example 8 with session-end.sh and add insta…",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-04-26T22:01:43Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "e43872e9bdd8f9bf0c770a95f570d714f4f51d65",
"body": "…#100)\n\nLesson 10 stated CLI > User > Project, contradicting Lesson 04 (CLI >\nProject > User) and the official Claude Code docs. Project-level agents\noverride user-level agents when their names collide.\n\n- Fix priority order in 10-cli/README.md (lines 437-439)\n- Add cross-link to Lesson 04 for the full priority table\n- Update matching quiz question Q7 in lesson-quiz question-bank\n\nCloses #98",
"is_bot": false,
"headline": "fix(cli): correct agent priority order to match official docs (#98) (…",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-04-26T20:28:34Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "47b97d1037edf13c2f4fc645a719fe5b0ed16f88",
"body": "…r (#87)\n\n* feat(hooks): add SessionEnd progress logger and local progress tracker\n\nAdds a SessionEnd hook that prompts for modules studied at session end\nand appends a record to ~/.claude-howto-progress.json — outside the repo\nso progress survives git pull without being overwritten.\n\nAlso adds loca\n[…]\n innerHTML to prevent XSS from imported JSON\n Co-Authored-By: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>\n\n---------\n\nCo-authored-by: Claude Sonnet 4.6 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "feat(hooks): add SessionEnd progress logger and local progress tracke…",
"author_name": "dhanya elizabath jose",
"author_login": "DhanyaJose",
"committed_at": "2026-04-26T18:20:22Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "67f4871e6865e319b3ef024dd18501f2b51ff14f",
"body": null,
"is_bot": false,
"headline": "docs(skills): question-bank fixes (#97)",
"author_name": "OleksandrDemidov",
"author_login": "OleksandrDemidov",
"committed_at": "2026-04-26T18:18:29Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "a7a0ea2d9da67c9932087041a07048df7b34adac",
"body": "Per official docs (https://code.claude.com/docs/en/model-config#adjust-effort-level),\nthe `max` effort level is supported on Opus 4.7, Opus 4.6, and Sonnet 4.6 — not\nOpus 4.7 only. Only `xhigh` is Opus 4.7 exclusive.\n\nUpdates 5 occurrences in 09-advanced-features/README.md to reflect the actual\nsupp\n[…]\nus 4.7: low, medium, high, xhigh, max\n- Opus 4.6 / Sonnet 4.6: low, medium, high, max\n\nuk/ and vi/ locales need a separate translation sync (still reference Opus 4.6\nera only and lack xhigh entirely).",
"is_bot": false,
"headline": "fix(advanced-features): correct effort level model support (#96)",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-04-25T06:04:34Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "8e1f60f47eaa0e9fd1a0121c49cf62d8c5584068",
"body": "Split the \"Skill\" participant into two distinct entities to better\nillustrate the three-level loading architecture:\n- Skill Instructions (Level 2): SKILL.md body\n- Skill Resources (Level 3): Bundled files (templates, scripts, etc.)\n\nAlso fixed inaccurate \"bash: read\" notation - Claude uses the Read\ntool, not bash commands.\n\nCo-authored-by: Claude Opus 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs(skills): improve skill loading process diagram clarity (#81)",
"author_name": "lzw-git-all",
"author_login": "lzw-git-all",
"committed_at": "2026-04-25T05:37:59Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "c5f1c75def3ceb74e93a5d4a646b106dfe172b1f",
"body": "…d auto-update mechanism (#84)\n\nBackground:\n- Users were confused about the difference between `marketplace update`\n (refreshes catalog) and `plugin update` (updates installed plugins)\n- Auto-update mechanism was not documented, causing confusion about\n why official marketplaces auto-refresh while\n[…]\nde.claude.com/docs/en/discover-plugins (auto-update documentation)\n- https://code.claude.com/docs/en/plugin-marketplaces (marketplace commands)\n\nCo-authored-by: Claude Opus 4.7 <noreply@anthropic.com>",
"is_bot": false,
"headline": "docs(plugins): add marketplace update vs plugin update distinction an…",
"author_name": "lzw-git-all",
"author_login": "lzw-git-all",
"committed_at": "2026-04-25T05:33:17Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "eff5bd226a4354140a6b568b5414d7968be714bb",
"body": "* test(scripts): cover repo-root boundary in check_cross_references\n\nLocks in the boundary behavior added in #91: links resolving outside\nthe repo root are silently skipped, in-repo broken links still error,\nand valid in-repo links still pass.\n\n* test(scripts): cover missing-README detection in numbered lesson dirs",
"is_bot": false,
"headline": "test(scripts): cover repo-root boundary in check_cross_references (#95)",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-04-24T22:33:21Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "0bf754673a710f5d245e9bbbabbdd8d0fc3f421d",
"body": "`(file_path.parent / link_path).resolve()` could silently follow a\ncrafted `../../outside/path` link that escapes the repository root.\nPaths that resolve outside the repo root are now skipped rather than\nchecked for existence.\n\nCo-authored-by: Claude Code <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix: constrain cross-reference resolution to repo root (#91)",
"author_name": "xiaolai",
"author_login": "xiaolai",
"committed_at": "2026-04-24T22:28:03Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "6740288030a8f566a62bbdbc167040889b9e84dd",
"body": "All 6 packages were fully unpinned, allowing a compromised upstream\nrelease to silently introduce malicious code on `pip install`. Pin to\ncurrent stable versions to ensure reproducible, auditable builds.\n\nCo-authored-by: Claude Code <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix: pin requirements.txt to known-good versions (#90)",
"author_name": "xiaolai",
"author_login": "xiaolai",
"committed_at": "2026-04-24T22:25:30Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "05f02025363994bc9991399be6888b9dcfab6bde",
"body": "…nts (#89)\n\n`diff` is not a valid Claude Code tool name — the agent would silently\nlose its diff capability at runtime. Use `bash` to invoke diff instead.\n\nApplies to all four locales: en (07-plugins), vi, zh, uk.\n\nCo-authored-by: Claude Code <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix: replace invalid `diff` tool with `bash` in security-reviewer age…",
"author_name": "xiaolai",
"author_login": "xiaolai",
"committed_at": "2026-04-24T22:24:35Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "d17d5159e8276cd4dfd55b1686f993f781d580ca",
"body": "…s mcp_tool, native binary) (#94)\n\n- Migrate all docs.anthropic.com/en/docs/claude-code URLs to code.claude.com/docs/en\n- Document /usage as canonical (v2.1.118); annotate /cost and /stats as shortcut aliases\n- Update Opus 4.7: 1M context (v2.1.117 fix), xhigh default effort\n- Note native-binary pac\n[…]\nfaults\", wslInheritsWindowsSettings, Vim visual modes, /doctor improvements, forked subagents, disableSkillShellExecution\n- Refresh footers to Last Updated April 24, 2026 / Claude Code Version 2.1.119",
"is_bot": false,
"headline": "docs: sync to Claude Code v2.1.119 (docs host migration, /usage, hook…",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-04-24T06:20:55Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "cf92e8e2c14dbe78714c51a6813d3c14aeb0dd93",
"body": "Sync all English tutorials with Claude Code v2.1.112 and the new Opus 4.7\nmodel (claude-opus-4-7). Introduces the xhigh effort level (new default on\nOpus 4.7), two new built-in slash commands (/ultrareview,\n/less-permission-prompts), auto mode without --enable-auto-mode for Max\nsubscribers on Opus 4\n[…]\n callouts in README.md, zh/README.md, and uk/README.md updated to\nv2.1.112. Changelog entry prepended.\n\nRepo version now tracks Claude Code version (2.3.0 → 2.1.112 is intentional\nper new convention).",
"is_bot": false,
"headline": "chore(release): v2.1.112",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-04-16T21:13:34Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "15f00855e809246b30f224408186a101b828df67",
"body": "…recap) (#80)\n\n* docs: sync to Claude Code v2.1.110 with TUI, push notifications, session recap, and new commands\n\n- 01-slash-commands: add /tui, /focus, /recap, /undo, /proactive to command table and recent changes\n- 07-plugins: document monitors manifest key for background monitor support (v2.1.10\n[…]\n(catalog): correct version tags for /proactive, /recap, /undo commands\n\n/proactive was added in v2.1.105, /recap and /undo in v2.1.108 — not v2.1.110.\nOnly /tui and /focus were introduced in v2.1.110.",
"is_bot": false,
"headline": "docs: sync to Claude Code v2.1.110 (TUI, push notifications, session …",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-04-16T07:05:49Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "83542f2781ff718034160affad8b9134402a529e",
"body": null,
"is_bot": false,
"headline": "Fixed a configuration error in the hooks Chinese guide",
"author_name": "ytche",
"author_login": "ytche",
"committed_at": "2026-04-15T01:03:06Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9c224ff249ac603d64d099b8001b80d7127690c0",
"body": null,
"is_bot": false,
"headline": "docs(readme): add Ukrainian language link to language switcher",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-04-11T20:51:55Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "039dde2c5c540c5303f0b1863b2f148f564d2efc",
"body": "Merges full Ukrainian (uk) localization — 10 modules, root docs, claude_concepts_guide, plugins, and supporting files. Closes #63.",
"is_bot": false,
"headline": "i18n(uk): Add complete Ukrainian localization",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-04-11T20:50:27Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "bce7cf8cb4a8d657d1575f6e740913a4592fab9e",
"body": "The pre-tool-check.sh example had three bugs rooted in the same\nmisunderstanding of the Claude Code PreToolUse hook protocol\n(stdin/stdout/stderr + exit code contract):\n\n1. Substring matching on `rm -rf /`\n The pattern was unanchored, so grep treated it as a substring and\n falsely blocked any co\n[…]\niteral, and `git push --force` (WARN only). stdout is empty\nin all cases; all reasons correctly routed to stderr or the audit log.\n\nCo-authored-by: Claude Opus 4.6 (1M context) <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix(hooks): correct pre-tool-check.sh hook protocol bugs (#72)",
"author_name": "yarlinghe",
"author_login": "yarlinghe",
"committed_at": "2026-04-11T20:48:05Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "2deba3ac2fccf96dacd076c0abab56d47c9c930e",
"body": "… Monitor tool (#73)\n\n* docs: sync to Claude Code v2.1.101 with new feature coverage\n\nBumps all English docs from v2.1.97 to v2.1.101, adds mandatory Sources\nfooter block (previously missing), and documents three new features\nshipped between v2.1.98 and v2.1.101:\n\n- /team-onboarding (v2.1.101) — new\n[…]\n\n- Fix uninitialized \\$last variable in Monitor poll-and-emit example\n- Update CATALOG.md New Features heading to April 2026 and add Monitor\n Tool, /team-onboarding, and Ultraplan auto-create entries",
"is_bot": false,
"headline": "docs: sync to Claude Code v2.1.101 with /team-onboarding, /ultraplan,…",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-04-11T20:30:46Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "b8a7b1f491fa09e7992b5f08303270d28219e7a1",
"body": null,
"is_bot": false,
"headline": "fix: change bad mermaid example to text block to pass CI",
"author_name": "Evgenij I",
"author_login": "edocltd",
"committed_at": "2026-04-10T10:43:14Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "d970cc6b2dd068ad90e847fab3f700cb627b8409",
"body": null,
"is_bot": false,
"headline": "fix(uk): fix CP1251 encoding in claude_concepts_guide.md ToC",
"author_name": "Evgenij I",
"author_login": "edocltd",
"committed_at": "2026-04-10T05:57:34Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f6d73e2659947b45f7c9994aa23d33c3ecaebe8c",
"body": "- Replace 3KB stub README with full 31KB translation matching original structure\n- Fix apostrophe anchor mismatch in 04-subagents (U+02BC vs U+0027)\n- Fix duplicate heading in 06-hooks (Prompt-хуки → Хуки на основі промптів)\n\nRef: luongnv89/claude-howto#63",
"is_bot": false,
"headline": "fix(uk): replace stub README with full translation, fix broken anchors",
"author_name": "Evgenij I",
"author_login": "edocltd",
"committed_at": "2026-04-10T05:54:06Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "1dcd8d370cd95673bc649a4f0212b9a8caf6f949",
"body": "Full Ukrainian translation of the comprehensive concepts guide (87KB, 3135 lines).\nAll code blocks, Mermaid diagrams, and JSON configs preserved as-is.\n\nRef: luongnv89/claude-howto#63",
"is_bot": false,
"headline": "i18n(uk): complete translation of claude_concepts_guide.md",
"author_name": "Evgenij I",
"author_login": "edocltd",
"committed_at": "2026-04-09T23:18:15Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "09c2fa24b10b279f9b01fff3690bc27643f28171",
"body": "- Translate resources/ (README, QUICK-START, DESIGN-SYSTEM)\n- Translate scripts/README.md (EPUB builder docs)\n- Copy docs/ and prompts/ as-is (internal planning + functional prompts)\n- Copy claude_concepts_guide.md (base for in-place translation)\n\nRef: luongnv89/claude-howto#63",
"is_bot": false,
"headline": "i18n(uk): add resources/, scripts/, docs/, prompts/ translations",
"author_name": "Evgenij I",
"author_login": "edocltd",
"committed_at": "2026-04-09T21:55:04Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "3f11521fcc411002d35bfe23706fac507c9091db",
"body": "…ces, etc.)\n\n- Translate CLAUDE.md, clean-code-rules.md, resources.md\n- Translate pr-review plugin (README, commands, agents)\n- Translate documentation templates (ADR, api-endpoint, function-docs)\n- Copy RELEASE_NOTES.md, LICENSE, claude-howto-logo.png as-is\n- Update TRANSLATION_QUEUE.md to 100%\n\nRef: luongnv89/claude-howto#63",
"is_bot": false,
"headline": "i18n(uk): add missing root files (CLAUDE.md, clean-code-rules, resour…",
"author_name": "Evgenij I",
"author_login": "edocltd",
"committed_at": "2026-04-09T21:34:08Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8438a0378ac22f8e6a9e6ca2720abfebd6132710",
"body": "- Translate 07-plugins: devops-automation, documentation, pr-review\n (READMEs, commands, agents, templates)\n- Update TRANSLATION_QUEUE.md — all priorities complete (100%)\n\nRef: luongnv89/claude-howto#63",
"is_bot": false,
"headline": "i18n(uk): complete P3 examples + P4 root docs translation",
"author_name": "Evgenij I",
"author_login": "edocltd",
"committed_at": "2026-04-09T21:16:09Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "f5659be0476de396246c0027274f7f2f348ec4a0",
"body": "- Translate READMEs, commands, agents for both plugins\n- Code/config/hooks files unchanged (no translation needed)\n\nRef: luongnv89/claude-howto#63",
"is_bot": false,
"headline": "i18n(uk): translate 07-plugins devops-automation & documentation",
"author_name": "Evgenij I",
"author_login": "edocltd",
"committed_at": "2026-04-09T21:13:13Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "1a567be79355f47b855b754dbc9ce87037b1b557",
"body": "- Copy code/image/config files across all modules\n- Translate brand-voice and code-review templates\n- Translate CONTRIBUTING, CODE_OF_CONDUCT, SECURITY, STYLE_GUIDE\n- Copy CHANGELOG as-is (technical log)\n\nRef: luongnv89/claude-howto#63",
"is_bot": false,
"headline": "i18n(uk): add missing files, translate P4 root docs",
"author_name": "Evgenij I",
"author_login": "edocltd",
"committed_at": "2026-04-09T20:59:59Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c0d400b21b901ca1ff41bf4bdb9ffce3ae78f2c6",
"body": "03-skills/refactor/references/code-smells.md (669 lines)\n03-skills/refactor/references/refactoring-catalog.md (1023 lines)\n\nP3 complete. Remaining: P4 root docs (5 files).\n\nRef: luongnv89/claude-howto#63",
"is_bot": false,
"headline": "feat(uk): translate refactor references (code-smells + catalog)",
"author_name": "Evgenij I",
"author_login": "edocltd",
"committed_at": "2026-04-09T20:08:46Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b56f1e111abb6c19f68660b0a3a3aa4e8cbc8f32",
"body": "…points, advanced\n\n03-skills/refactor: SKILL.md + templates/refactoring-plan.md\n04-subagents: 8 agent definitions\n08-checkpoints: checkpoint-examples.md\n09-advanced: planning-mode-examples.md\n\nRemaining: refactor references (1692 lines), P4 root docs\n\nRef: luongnv89/claude-howto#63",
"is_bot": false,
"headline": "feat(uk): translate P3 examples for skills/refactor, subagents, check…",
"author_name": "Evgenij I",
"author_login": "edocltd",
"committed_at": "2026-04-09T19:57:13Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "cea0a7d4ef97d030041d52571acdc134bb7215cf",
"body": "6 SKILL.md files + 3 templates translated.\nRemaining: references/code-smells.md and references/refactoring-catalog.md\n\nRef: luongnv89/claude-howto#63",
"is_bot": false,
"headline": "feat(uk): translate P3 examples for module 03-skills",
"author_name": "Evgenij I",
"author_login": "edocltd",
"committed_at": "2026-04-09T19:46:03Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "6172aacfd52f056befd980071de68dd07b2b775c",
"body": "01-slash-commands: 7 slash command examples\n02-memory: 3 CLAUDE.md examples\n\nProgress: 25/67 files\n\nRef: luongnv89/claude-howto#63",
"is_bot": false,
"headline": "feat(uk): translate P3 examples for modules 01, 02",
"author_name": "Evgenij I",
"author_login": "edocltd",
"committed_at": "2026-04-09T19:31:43Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2a276147706f903af38ba2b4aa878d909aa5bc56",
"body": "Modules 06-hooks, 07-plugins, 09-advanced-features, 10-cli had\ntruncated translations (18-58% content loss). Retranslated from\nscratch using original English sources.\n\nAll files now match expected ~40% size increase for Cyrillic.\n\nRef: luongnv89/claude-howto#63",
"is_bot": false,
"headline": "fix(uk): complete translations for modules 06, 07, 09, 10",
"author_name": "Evgenij I",
"author_login": "edocltd",
"committed_at": "2026-04-09T16:55:57Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8684be223d8acfb2e928889201f78f33ad257535",
"body": "Module 01: Slash Commands (565 lines)\nModule 08: Checkpoints and Rewind (320 lines)\nUpdate TRANSLATION_QUEUE.md with P1 completion.\n\nProgress: 7/67 files (P1: 5/5 DONE, P2: 2/10)\n\nRef: luongnv89/claude-howto#63",
"is_bot": false,
"headline": "feat(uk): translate Module 01 and Module 08 READMEs",
"author_name": "Evgenij I",
"author_login": "edocltd",
"committed_at": "2026-04-09T10:45:06Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "9efa5dd9b8911468e61cf1a1008aaa023ccdbd7a",
"body": "Complete Ukrainian translation of LEARNING-ROADMAP.md - the guided\nlearning path for Claude Code features.\n\n- Self-assessment quiz for level determination\n- Three learning levels: Beginner, Intermediate, Advanced\n- All milestones (1A, 1B, 2A, 2B, 3A, 3B) with exercises\n- Mermaid diagram preserved un\n[…]\nProgress tracking checklists\n- Quick start paths (15 min, 1 hour, weekend)\n- Learning tips and common challenges\n\nProgress: 5/67 files (P1: 5/5 core documents COMPLETE)\n\nRef: luongnv89/claude-howto#63",
"is_bot": false,
"headline": "feat(uk): translate LEARNING-ROADMAP.md to Ukrainian",
"author_name": "Evgenij I",
"author_login": "edocltd",
"committed_at": "2026-04-09T10:34:22Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "118fd4018391c635c5307ebf899140f32703d1b2",
"body": "Complete Ukrainian translation of QUICK_REFERENCE.md - the quick\nreference card for all Claude Code features.\n\n- Installation quick commands for all features\n- Feature cheat sheet with paths and usage\n- Common use cases (code review, docs, DevOps, CI/CD)\n- File locations reference diagram\n- Learning path (Day 1 through Week 3+)\n- New features (March 2026) section\n- Tips, FAQ, and getting started checklist\n\nProgress: 4/67 files (P1: 4/5 core documents)\n\nRef: luongnv89/claude-howto#63",
"is_bot": false,
"headline": "feat(uk): translate QUICK_REFERENCE.md to Ukrainian",
"author_name": "Evgenij I",
"author_login": "edocltd",
"committed_at": "2026-04-09T10:28:06Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "c343be62f5a26981a825979a6bc66b2f3812591c",
"body": "Complete Ukrainian translation of CATALOG.md - the quick reference\nguide to all Claude Code features.\n\n- 55+ built-in commands reference with Ukrainian descriptions\n- Permission modes, subagents, skills, plugins sections\n- MCP servers, hooks (25 events), memory types\n- New features (March 2026) - 20+ features\n- Quick reference matrix and installation priority\n- i18n-source-sha frontmatter for version tracking\n\nProgress: 3/67 files (P1: 3/5 core documents)\n\nRef: luongnv89/claude-howto#63",
"is_bot": false,
"headline": "feat(uk): translate CATALOG.md to Ukrainian",
"author_name": "Evgenij I",
"author_login": "edocltd",
"committed_at": "2026-04-09T10:21:40Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "a80b980bb6a163c94df764ad5b988e63ddaedb22",
"body": "Complete Ukrainian translation of INDEX.md - the comprehensive\nindex of all example files in the repository.\n\nTranslation follows uk/TRANSLATION_NOTES.md guidelines:\n- Technical terms per glossary\n- File paths and code blocks preserved in English\n- Table structure and formatting maintained\n- All 883 lines translated\n- i18n-source-sha frontmatter added for version tracking\n\nProgress: 2/67 files (P1: 2/5 core documents)\n\nRef: luongnv89/claude-howto#63",
"is_bot": false,
"headline": "feat(uk): translate INDEX.md to Ukrainian",
"author_name": "Evgenij I",
"author_login": "edocltd",
"committed_at": "2026-04-09T10:16:35Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "06caeaa8d9436ae32692614f8ea0a7572cd2824d",
"body": "- uk/README.md: Ukrainian landing page with module index\n- uk/TRANSLATION_NOTES.md: glossary and style guide\n- uk/TRANSLATION_QUEUE.md: progress tracker (0/67 files)\n- Directory structure for all 10 modules\n\nRef: luongnv89/claude-howto#63",
"is_bot": false,
"headline": "feat(i18n): add Ukrainian localization infrastructure",
"author_name": "Evgenij I",
"author_login": "edocltd",
"committed_at": "2026-04-09T10:12:52Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "63a141688442182bbe8fbdb228ea136853f8a844",
"body": "The latest Claude Code release is 2.1.97, not 2.3.0 (which is this\nguide's own version). Update all 20 \"Claude Code Version\" footer lines\nto accurately reflect the documented Claude Code version.\n\nGenerated with [Claude Code](https://claude.ai/code)\nvia [Happy](https://happy.engineering)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\nCo-Authored-By: Happy <yesreply@happy.engineering>",
"is_bot": false,
"headline": "fix(docs): correct Claude Code version to 2.1.97 across all footers",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-04-09T04:42:51Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "7f2e77337ed9b67ebcb2a0aaca608b4771023f67",
"body": "Update all documentation footers from generic \"April 2026 / 2.1+\" to\nthe specific sync date (April 9, 2026) and documented version (2.3.0).\nAlso add version/date footers to zh/CATALOG.md and\nzh/01-slash-commands/README.md which were missing them.\n\nGenerated with [Claude Code](https://claude.ai/code)\nvia [Happy](https://happy.engineering)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\nCo-Authored-By: Happy <yesreply@happy.engineering>",
"is_bot": false,
"headline": "docs: update Last Updated date and Claude Code version across all files",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-04-09T04:41:16Z",
"body_truncated": false,
"is_coding_agent": true
},
{
"oid": "e015f39c687b3a1a1d8a9ba186fbea958bb6fe60",
"body": "P0 Critical:\n- Remove /vim (removed in v2.1.92) from CATALOG.md, zh/CATALOG.md active tables\n- Move /vim to deprecated section in zh/01-slash-commands/README.md\n- Fix fake hook events (PreCommit/PrePush/PostPush) in config-examples.json\n- Replace with real PreToolUse hook pattern\n- Update deprecated\n[…]\nRENCE.md\n\nGenerated with [Claude Code](https://claude.ai/code)\nvia [Happy](https://happy.engineering)\n\nCo-Authored-By: Claude <noreply@anthropic.com>\nCo-Authored-By: Happy <yesreply@happy.engineering>",
"is_bot": false,
"headline": "fix: apply 2026-04-09 documentation accuracy updates",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-04-09T04:32:26Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "561c6cbaa3043aa86f530af75f46ab697304f531",
"body": "- Fix untranslated terms in CODE_OF_CONDUCT (witness, criticism, feedback, stalking)\n- Remove Arabic text accidentally left in Retaliation section\n- Add missing Scope content to CODE_OF_CONDUCT\n- Add Vietnamese footers to all module READMEs\n- Translate footers: Last Updated → Cập Nhật Lần Cuối, Comp\n[…]\nUDE.md, LICENSE, RELEASE_NOTES.md, clean-code-rules.md, resources.md\n- Add missing images: pr-slash-command.png, memory-*.png, claude-howto-logo.png\n- Fix CODE_OF_CONDUCT closing message to Vietnamese",
"is_bot": false,
"headline": "docs(vi): sync Vietnamese documentation with English source (#60)",
"author_name": "Thiên Toán",
"author_login": "toanalien",
"committed_at": "2026-04-08T13:58:16Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "f07313d71f51fe41a59315cef823306e626446ac",
"body": null,
"is_bot": false,
"headline": "docs: remove contributors section",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-04-07T09:12:17Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "4f5537430dd3a673a3f21c348ecfb867556b37cf",
"body": null,
"is_bot": false,
"headline": "docs: update GitHub metrics to 21,800+ stars, 2,585+ forks",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-04-07T08:40:05Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "8b42603bb712014316a5ede71d371605592a0140",
"body": null,
"is_bot": false,
"headline": "chore(release): v2.3.0",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-04-07T08:27:21Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "72d3b016e67ba0bfa0a6a1d003b9ba26491f2cad",
"body": "* docs: sync all tutorials with latest Claude Code official docs (April 2026)\n\nUpdate 44 documentation files to reflect the latest Claude Code features\nfrom code.claude.com. Key content changes include new slash commands\n(/ultraplan, /powerup, /sandbox), deprecated command removals (/pr-comments,\n/v\n[…]\n(docs): correct env var values in locale files (vi, zh)\n\nPropagate CLAUDE_CODE_NEW_INIT=true → =1 and\nCLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=true → =1 corrections\nto Vietnamese and Chinese translations.",
"is_bot": false,
"headline": "docs: sync all tutorials with latest Claude Code docs (April 2026) (#56)",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-04-07T08:20:53Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "90e9c30e93e62aad26e9a52dcb9ff3bf2829a365",
"body": "Extend the release workflow to build separate EPUB artifacts for en, vi,\nand zh in parallel via a matrix job, then publish all built files under\na single GitHub Release. Using fail-fast: false so a failure in one\nlanguage does not block releasing the others.\n\nAlso refactor build_epub.py to drive language-specific paths, filenames,\nand titles from a mapping, and add zh support (title/subtitle + choice).",
"is_bot": false,
"headline": "feat(release): build and publish EPUB artifacts per language (#54)",
"author_name": "Thiên Toán",
"author_login": "toanalien",
"committed_at": "2026-04-07T07:14:06Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "2cbb10c959d1693f0c5e04b29bbae2ee16a89c6f",
"body": "* fix(hooks): make hook scripts compatible with Windows Git Bash and use stdin JSON protocol\n\n- Replace `grep -P` (Perl regex) with `sed` for JSON field extraction,\n as Windows Git Bash does not support `grep -P`\n- Replace positional arg (`$1`) with stdin JSON parsing to match the\n actual Claude C\n[…]\nomment: PreToolUse → PostToolUse (matches\n README example and actual hook behavior)\n\n---------\n\nCo-authored-by: Bruce <binyuli1993@foxmail.com>\nCo-authored-by: Claude Opus 4.6 <noreply@anthropic.com>",
"is_bot": false,
"headline": "fix(hooks): Windows Git Bash compatibility + stdin JSON protocol (#55)",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-04-07T06:53:32Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "f53d08098e26a31e926488a6fd7fe3f7ecf5c236",
"body": "* feat: add performance-optimizer subagent and dependency-check hook\n\nAgent-Logs-Url: https://github.com/khanhnkq/claude-howto/sessions/ef3fb01c-a9c0-466e-9ad2-f255f306add2\n\nCo-authored-by: khanhnkq <180888435+khanhnkq@users.noreply.github.com>\n\n* fix(hooks): use basename for manifest matching in de\n[…]\nasename \"$FILE\") and use it for all pattern matching.\n\n---------\n\nCo-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>\nCo-authored-by: Luong NGUYEN <luongnv89@gmail.com>",
"is_bot": false,
"headline": "Add performance-optimizer subagent and dependency-check hook (#36)",
"author_name": "qk",
"author_login": "khanhnkq",
"committed_at": "2026-04-07T06:07:20Z",
"body_truncated": true,
"is_coding_agent": true
},
{
"oid": "749c79f63352e8e85820ae1fb71cb840dccf9df5",
"body": "The autoCheckpoint setting does not exist in Claude Code's settings\nschema. Checkpointing is automatic and built-in — every user prompt\ncreates a checkpoint. Replace the incorrect config example with the\nactual cleanupPeriodDays setting, which controls retention period.\n\nFixes #18",
"is_bot": false,
"headline": "fix: correct autoCheckpoint config documentation in 08-checkpoints (#39)",
"author_name": "JiayuWang(王嘉宇)",
"author_login": "JiayuuWang",
"committed_at": "2026-04-06T23:18:46Z",
"body_truncated": false,
"is_coding_agent": false
},
{
"oid": "b511ed1997bbaa356e76da78ca7152f96370c70d",
"body": "* feat: add missing pre-tool-check.sh hook to 06-hooks\n\nThe LEARNING-ROADMAP.md (Milestone 2A) referenced this file in an\nexercise that copies it to ~/.claude/hooks/, but the file did not exist.\nThis caused confusion for learners following the guide.\n\nThe new pre-tool-check.sh is a PreToolUse hook f\n[…]\ncommand\"[[:space:]]*:[[:space:]]*\"\\([^\"]*\\)\".*/\\1/p'`\n which works on both macOS (BSD) and Linux without GNU grep extensions\n\nCloses #32\n\n---------\n\nCo-authored-by: Luong NGUYEN <luongnv89@gmail.com>",
"is_bot": false,
"headline": "feat: add missing pre-tool-check.sh hook to 06-hooks (#40)",
"author_name": "JiayuWang(王嘉宇)",
"author_login": "JiayuuWang",
"committed_at": "2026-04-06T23:18:12Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "699fb39a46083c1b910c2e608faeb319e46ac806",
"body": "…s (#53)\n\n* ci: shift-left quality gates — add mypy to pre-commit, fix CI failures\n\n- Add mypy pre-commit hook (mirrors-mypy v1.13.0) so type checks run locally\n- Add [tool.mypy] config to scripts/pyproject.toml with overrides for untyped libs (ebooklib, sync_translations)\n- Add mypy>=1.8.0 to requi\n[…]\nGitHub Actions sandboxed environment. Add --puppeteer-config flag\nto build_epub.py that passes a Puppeteer JSON config file to mmdc via -p,\nand use it in the CI workflow to inject the no-sandbox args.",
"is_bot": false,
"headline": "ci: shift-left quality gates — add mypy to pre-commit, fix CI failure…",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-04-06T22:51:44Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "e76bbe40f23f59a1e206f91f792e948aad7ff7c0",
"body": "…ng (#10) (#52)\n\n* refactor(epub): replace Kroki HTTP dependency with local mmdc rendering (#10)\n\nRemove httpx/tenacity dependencies and Kroki.io API calls from the EPUB\nbuild pipeline. MermaidRenderer now invokes mmdc (mermaid-cli) as a local\nsubprocess, eliminating intermittent CI failures caused \n[…]\nronments\n- Fix misleading log that printed unique/total as equal counts;\n now logs \"N unique diagrams (M total blocks)\" explicitly\n- Add test_render_all_timeout and strengthen deduplication assertion",
"is_bot": false,
"headline": "refactor(epub): replace Kroki HTTP dependency with local mmdc renderi…",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-04-06T21:44:59Z",
"body_truncated": true,
"is_coding_agent": false
},
{
"oid": "6cbaa4dd52831b2694240503c299d788f73d9186",
"body": null,
"is_bot": false,
"headline": "docs(readme): add Chinese language link to language switcher",
"author_name": "Luong NGUYEN",
"author_login": "luongnv89",
"committed_at": "2026-04-06T21:17:18Z",
"body_truncated": false,
"is_coding_agent": false
}
],
"releases_count": 10,
"commits_last_year": 236,
"latest_release_at": "2026-06-02T06:38:08Z",
"latest_release_tag": "v2.1.160",
"releases_from_tags": false,
"days_since_last_push": 6,
"active_weeks_last_year": 33,
"days_since_latest_release": 56,
"mean_days_between_releases": 10.7
},
"community": {
"has_readme": true,
"has_license": true,
"has_description": true,
"has_contributing": true,
"health_percentage": 100,
"has_issue_template": false,
"has_code_of_conduct": true,
"has_pull_request_template": true
},
"ecosystem": {
"packages": []
},
"popularity": {
"forks": 4937,
"stars": 40627,
"watchers": 182,
"fork_history": {
"days": [
{
"date": "2026-05-15",
"count": 7
},
{
"date": "2026-05-16",
"count": 26
},
{
"date": "2026-05-17",
"count": 21
},
{
"date": "2026-05-18",
"count": 16
},
{
"date": "2026-05-19",
"count": 18
},
{
"date": "2026-05-20",
"count": 13
},
{
"date": "2026-05-21",
"count": 14
},
{
"date": "2026-05-22",
"count": 19
},
{
"date": "2026-05-23",
"count": 17
},
{
"date": "2026-05-24",
"count": 5
},
{
"date": "2026-05-25",
"count": 7
},
{
"date": "2026-05-26",
"count": 15
},
{
"date": "2026-05-27",
"count": 13
},
{
"date": "2026-05-28",
"count": 10
},
{
"date": "2026-05-29",
"count": 6
},
{
"date": "2026-05-30",
"count": 12
},
{
"date": "2026-05-31",
"count": 8
},
{
"date": "2026-06-01",
"count": 9
},
{
"date": "2026-06-02",
"count": 8
},
{
"date": "2026-06-03",
"count": 7
},
{
"date": "2026-06-04",
"count": 3
},
{
"date": "2026-06-05",
"count": 6
},
{
"date": "2026-06-06",
"count": 17
},
{
"date": "2026-06-07",
"count": 43
},
{
"date": "2026-06-08",
"count": 35
},
{
"date": "2026-06-09",
"count": 36
},
{
"date": "2026-06-10",
"count": 31
},
{
"date": "2026-06-11",
"count": 33
},
{
"date": "2026-06-12",
"count": 20
},
{
"date": "2026-06-13",
"count": 12
},
{
"date": "2026-06-14",
"count": 9
},
{
"date": "2026-06-15",
"count": 18
},
{
"date": "2026-06-16",
"count": 14
},
{
"date": "2026-06-17",
"count": 14
},
{
"date": "2026-06-18",
"count": 6
},
{
"date": "2026-06-19",
"count": 16
},
{
"date": "2026-06-20",
"count": 10
},
{
"date": "2026-06-21",
"count": 7
},
{
"date": "2026-06-22",
"count": 11
},
{
"date": "2026-06-23",
"count": 13
},
{
"date": "2026-06-24",
"count": 16
},
{
"date": "2026-06-25",
"count": 12
},
{
"date": "2026-06-26",
"count": 21
},
{
"date": "2026-06-27",
"count": 22
},
{
"date": "2026-06-28",
"count": 24
},
{
"date": "2026-06-29",
"count": 13
},
{
"date": "2026-06-30",
"count": 16
},
{
"date": "2026-07-01",
"count": 16
},
{
"date": "2026-07-02",
"count": 15
},
{
"date": "2026-07-03",
"count": 10
},
{
"date": "2026-07-04",
"count": 5
},
{
"date": "2026-07-05",
"count": 1
},
{
"date": "2026-07-06",
"count": 6
},
{
"date": "2026-07-07",
"count": 10
},
{
"date": "2026-07-08",
"count": 7
},
{
"date": "2026-07-09",
"count": 14
},
{
"date": "2026-07-10",
"count": 11
},
{
"date": "2026-07-11",
"count": 6
},
{
"date": "2026-07-12",
"count": 11
},
{
"date": "2026-07-13",
"count": 10
},
{
"date": "2026-07-14",
"count": 6
},
{
"date": "2026-07-15",
"count": 5
},
{
"date": "2026-07-16",
"count": 8
},
{
"date": "2026-07-17",
"count": 2
},
{
"date": "2026-07-18",
"count": 4
},
{
"date": "2026-07-19",
"count": 9
},
{
"date": "2026-07-20",
"count": 9
},
{
"date": "2026-07-21",
"count": 25
},
{
"date": "2026-07-22",
"count": 27
},
{
"date": "2026-07-23",
"count": 12
},
{
"date": "2026-07-24",
"count": 15
},
{
"date": "2026-07-25",
"count": 11
},
{
"date": "2026-07-26",
"count": 6
},
{
"date": "2026-07-27",
"count": 5
},
{
"date": "2026-07-28",
"count": 5
}
],
"complete": false,
"collected": 1000,
"total_forks": 4937
},
"star_history": null,
"open_issues_and_prs": 24
},
"ai_readiness": {
"has_nix": false,
"example_dirs": [],
"has_llms_txt": false,
"has_dockerfile": false,
"has_mcp_signal": false,
"bootstrap_files": [],
"api_schema_files": [],
"has_devcontainer": false,
"typecheck_configs": [],
"toolchain_manifests": [],
"largest_source_bytes": 37875,
"source_files_sampled": 43,
"oversized_source_files": 0,
"agent_instruction_files": [
"CLAUDE.md",
"ja/CLAUDE.md",
"uk/CLAUDE.md",
"vi/CLAUDE.md"
],
"agent_instruction_max_bytes": 8618
},
"dependencies": {
"manifests": [
"scripts/pyproject.toml",
"scripts/requirements-dev.txt",
"scripts/requirements.txt"
],
"advisories": {
"error": null,
"scope": null,
"source": null,
"findings": [],
"collected": false,
"malicious": [],
"truncated": false,
"by_severity": {},
"advisory_count": 0,
"affected_count": 0,
"assessed_count": 0,
"malicious_count": 0,
"assessed_package": null,
"unassessed_count": 0,
"direct_affected_count": 0
},
"ecosystems": [
"pypi"
],
"dependencies": [
{
"name": "ebooklib",
"manifest": "scripts/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
},
{
"name": "markdown",
"manifest": "scripts/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
},
{
"name": "beautifulsoup4",
"manifest": "scripts/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
},
{
"name": "httpx",
"manifest": "scripts/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
},
{
"name": "pillow",
"manifest": "scripts/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
},
{
"name": "tenacity",
"manifest": "scripts/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
},
{
"name": "jinja2",
"manifest": "scripts/pyproject.toml",
"ecosystem": "pypi",
"version_constraint": null
}
],
"all_dependencies": {
"error": "GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository",
"source": null,
"packages": [],
"collected": false,
"truncated": false,
"total_count": null,
"direct_count": null,
"indirect_count": null
}
},
"maintainership": {
"issues": {
"open_prs": 13,
"merged_prs": 63,
"open_issues": 11,
"closed_ratio": 0.703,
"closed_issues": 26,
"closed_unmerged_prs": 27
},
"bus_factor": 1,
"bot_contributors": 0,
"top_contributors": [
{
"type": "User",
"login": "luongnv89",
"commits": 183,
"avatar_url": "https://avatars.githubusercontent.com/u/3288457?v=4"
},
{
"type": "User",
"login": "edocltd",
"commits": 20,
"avatar_url": "https://avatars.githubusercontent.com/u/258913972?v=4"
},
{
"type": "User",
"login": "toanalien",
"commits": 4,
"avatar_url": "https://avatars.githubusercontent.com/u/5405744?v=4"
},
{
"type": "User",
"login": "lzw-git-all",
"commits": 4,
"avatar_url": "https://avatars.githubusercontent.com/u/271938013?v=4"
},
{
"type": "User",
"login": "wjhrdy",
"commits": 3,
"avatar_url": "https://avatars.githubusercontent.com/u/1795778?v=4"
},
{
"type": "User",
"login": "xiaolai",
"commits": 3,
"avatar_url": "https://avatars.githubusercontent.com/u/152970?v=4"
},
{
"type": "User",
"login": "JiayuuWang",
"commits": 2,
"avatar_url": "https://avatars.githubusercontent.com/u/151589547?v=4"
},
{
"type": "User",
"login": "iiitutu",
"commits": 2,
"avatar_url": "https://avatars.githubusercontent.com/u/19824087?v=4"
},
{
"type": "User",
"login": "jeffreyyjp",
"commits": 1,
"avatar_url": "https://avatars.githubusercontent.com/u/17985592?v=4"
},
{
"type": "User",
"login": "Foxsunshine",
"commits": 1,
"avatar_url": "https://avatars.githubusercontent.com/u/99238517?v=4"
}
],
"contributors_sampled": 23,
"top_contributor_share": 0.775
},
"quality_signals": {
"has_ci": true,
"has_tests": true,
"ci_workflows": [
"docs-check.yml",
"pages.yml",
"release.yml",
"test.yml"
],
"has_docs_dir": true,
"linter_configs": [],
"has_editorconfig": false,
"has_linter_config": true,
"has_precommit_config": true
},
"security_signals": {
"lockfiles": [],
"scorecard": {
"checks": [
{
"name": "Binary-Artifacts",
"score": 10,
"reason": "no binaries found in the repo",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#binary-artifacts"
},
{
"name": "Branch-Protection",
"score": 0,
"reason": "branch protection not enabled on development/release branches",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#branch-protection"
},
{
"name": "CI-Tests",
"score": 9,
"reason": "18 out of 20 merged PRs checked by a CI test -- score normalized to 9",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#ci-tests"
},
{
"name": "CII-Best-Practices",
"score": 0,
"reason": "no effort to earn an OpenSSF best practices badge detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#cii-best-practices"
},
{
"name": "Code-Review",
"score": 1,
"reason": "Found 5/28 approved changesets -- score normalized to 1",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#code-review"
},
{
"name": "Contributors",
"score": 6,
"reason": "project has 2 contributing companies or organizations -- score normalized to 6",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#contributors"
},
{
"name": "Dangerous-Workflow",
"score": 10,
"reason": "no dangerous workflow patterns detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dangerous-workflow"
},
{
"name": "Dependency-Update-Tool",
"score": 0,
"reason": "no update tool detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#dependency-update-tool"
},
{
"name": "Fuzzing",
"score": 0,
"reason": "project is not fuzzed",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#fuzzing"
},
{
"name": "License",
"score": 10,
"reason": "license file detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#license"
},
{
"name": "Maintained",
"score": 10,
"reason": "30 commit(s) and 7 issue activity found in the last 90 days -- score normalized to 10",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#maintained"
},
{
"name": "Packaging",
"score": null,
"reason": "packaging workflow not detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#packaging"
},
{
"name": "Pinned-Dependencies",
"score": 0,
"reason": "dependency not pinned by hash detected -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#pinned-dependencies"
},
{
"name": "SAST",
"score": 0,
"reason": "SAST tool is not run on all commits -- score normalized to 0",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#sast"
},
{
"name": "Security-Policy",
"score": 10,
"reason": "security policy file detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#security-policy"
},
{
"name": "Signed-Releases",
"score": 0,
"reason": "Project has not signed or included provenance with any releases.",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#signed-releases"
},
{
"name": "Token-Permissions",
"score": 0,
"reason": "detected GitHub workflow tokens with excessive permissions",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#token-permissions"
},
{
"name": "Vulnerabilities",
"score": 0,
"reason": "22 existing vulnerabilities detected",
"documentation_url": "https://github.com/ossf/scorecard/blob/c395761df6afe1a69e476bc60a013a94bcbc153f/docs/checks.md#vulnerabilities"
}
],
"commit": "97fc961a8cc68ade7e74f2dbd5c9dc5491ce55bb",
"ran_at": "2026-07-29T00:07:07Z",
"aggregate_score": 3.7,
"scorecard_version": "v5.5.0"
},
"has_codeql_workflow": false,
"has_security_policy": true,
"has_dependabot_config": false
},
"contribution_flow": {
"collected": true,
"ci_last_run_at": "2026-07-22T15:18:58Z",
"oldest_open_prs": [
{
"number": 23,
"created_at": "2026-03-30T10:11:06Z",
"last_comment_at": null,
"last_comment_author": null
},
{
"number": 25,
"created_at": "2026-03-30T15:14:31Z",
"last_comment_at": null,
"last_comment_author": null
},
{
"number": 33,
"created_at": "2026-04-01T07:07:58Z",
"last_comment_at": null,
"last_comment_author": null
},
{
"number": 38,
"created_at": "2026-04-02T16:24:29Z",
"last_comment_at": null,
"last_comment_author": null
},
{
"number": 61,
"created_at": "2026-04-08T09:42:50Z",
"last_comment_at": null,
"last_comment_author": null
},
{
"number": 75,
"created_at": "2026-04-14T01:27:54Z",
"last_comment_at": null,
"last_comment_author": null
},
{
"number": 78,
"created_at": "2026-04-15T06:38:33Z",
"last_comment_at": null,
"last_comment_author": null
},
{
"number": 108,
"created_at": "2026-04-30T16:46:40Z",
"last_comment_at": null,
"last_comment_author": null
},
{
"number": 112,
"created_at": "2026-05-04T04:56:09Z",
"last_comment_at": null,
"last_comment_author": null
},
{
"number": 113,
"created_at": "2026-05-04T07:47:05Z",
"last_comment_at": null,
"last_comment_author": null
},
{
"number": 145,
"created_at": "2026-06-22T12:28:26Z",
"last_comment_at": "2026-06-22T12:30:18Z",
"last_comment_author": "ronak-701685"
},
{
"number": 147,
"created_at": "2026-06-27T13:31:11Z",
"last_comment_at": null,
"last_comment_author": null
},
{
"number": 150,
"created_at": "2026-07-02T09:25:33Z",
"last_comment_at": "2026-07-17T07:56:16Z",
"last_comment_author": "luongnv89"
}
],
"last_merged_pr_at": "2026-07-22T15:18:16Z",
"ci_last_conclusion": "SUCCESS",
"oldest_open_issues": [
{
"number": 74,
"created_at": "2026-04-14T01:25:38Z",
"last_comment_at": null,
"last_comment_author": null
},
{
"number": 82,
"created_at": "2026-04-16T12:17:40Z",
"last_comment_at": null,
"last_comment_author": null
},
{
"number": 92,
"created_at": "2026-04-22T18:29:02Z",
"last_comment_at": "2026-05-09T06:24:58Z",
"last_comment_author": "luongnv89"
},
{
"number": 93,
"created_at": "2026-04-23T04:15:49Z",
"last_comment_at": null,
"last_comment_author": null
},
{
"number": 103,
"created_at": "2026-04-28T02:36:50Z",
"last_comment_at": "2026-05-18T23:49:56Z",
"last_comment_author": "andyRon"
},
{
"number": 110,
"created_at": "2026-05-01T13:52:34Z",
"last_comment_at": "2026-05-27T15:31:32Z",
"last_comment_author": "StevenCasperson"
},
{
"number": 116,
"created_at": "2026-05-08T05:23:51Z",
"last_comment_at": "2026-05-09T06:21:04Z",
"last_comment_author": "luongnv89"
},
{
"number": 132,
"created_at": "2026-05-31T21:19:56Z",
"last_comment_at": null,
"last_comment_author": null
},
{
"number": 139,
"created_at": "2026-06-09T07:26:08Z",
"last_comment_at": "2026-06-11T07:52:08Z",
"last_comment_author": "tg12"
},
{
"number": 142,
"created_at": "2026-06-16T09:05:19Z",
"last_comment_at": null,
"last_comment_author": null
},
{
"number": 152,
"created_at": "2026-07-11T20:33:31Z",
"last_comment_at": null,
"last_comment_author": null
}
]
}
},
"config": {
"disabled_metrics": [],
"disabled_categories": [],
"disabled_components": {}
},
"source": {
"url": "https://github.com/luongnv89/claude-howto",
"host": "github.com",
"name": "claude-howto",
"owner": "luongnv89"
},
"metrics": {
"overall": {
"key": "overall",
"band": "good",
"name": "Overall health",
"note": null,
"notes": [],
"value": 74,
"inputs": {
"security": 37,
"vitality": 88,
"community": 95,
"governance": 54,
"engineering": 95
},
"components": []
},
"categories": [
{
"key": "vitality",
"band": "excellent",
"name": "Vitality",
"value": 88,
"weight": 0.22,
"metrics": [
{
"key": "development_activity",
"band": "excellent",
"name": "Development activity",
"note": null,
"notes": [],
"value": 87,
"inputs": {
"commits_last_year": 236,
"human_commit_share": 1,
"days_since_last_push": 6,
"active_weeks_last_year": 33
},
"components": [
{
"key": "push_recency",
"name": "Push recency",
"detail": "last push 6 days ago",
"points": 36,
"status": "met",
"details": [
{
"code": "push_recency",
"params": {
"days": 6
}
}
],
"max_points": 36
},
{
"key": "commit_cadence",
"name": "Commit cadence",
"detail": "33/52 weeks with commits",
"points": 22.8,
"status": "partial",
"details": [
{
"code": "commit_cadence_weeks",
"params": {
"weeks": 33
}
}
],
"max_points": 36
},
{
"key": "commit_volume",
"name": "Commit volume",
"detail": "236 commits in the last year",
"points": 18,
"status": "met",
"details": [
{
"code": "commits_last_year",
"params": {
"count": 236
}
}
],
"max_points": 18
},
{
"key": "openssf_scorecard_maintained",
"name": "OpenSSF Scorecard: Maintained",
"detail": "30 commit(s) and 7 issue activity found in the last 90 days -- score normalized to 10",
"points": 10,
"status": "met",
"details": [],
"max_points": 10
}
]
},
{
"key": "release_discipline",
"band": "excellent",
"name": "Release discipline",
"note": null,
"notes": [],
"value": 90,
"inputs": {
"releases_count": 10,
"latest_release_tag": "v2.1.160",
"releases_from_tags": false,
"days_since_latest_release": 56,
"mean_days_between_releases": 10.7
},
"components": [
{
"key": "ships_releases",
"name": "Ships releases",
"detail": "10 releases published",
"points": 27,
"status": "met",
"details": [
{
"code": "releases_published",
"params": {
"count": 10
}
}
],
"max_points": 27
},
{
"key": "release_recency",
"name": "Release recency",
"detail": "latest release 56 days ago",
"points": 36,
"status": "met",
"details": [
{
"code": "release_recency",
"params": {
"days": 56
}
}
],
"max_points": 36
},
{
"key": "release_cadence",
"name": "Release cadence",
"detail": "a release every ~10.7 days",
"points": 27,
"status": "met",
"details": [
{
"code": "release_cadence",
"params": {
"gap": 10.7
}
}
],
"max_points": 27
},
{
"key": "openssf_scorecard_signed_releases",
"name": "OpenSSF Scorecard: Signed-Releases",
"detail": "Project has not signed or included provenance with any releases.",
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
},
{
"key": "abandonment",
"band": "excellent",
"name": "Abandonment",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"cap": null,
"state": "maintained",
"guards": [],
"signals": [],
"red_flag": false,
"multiplier_pct": 100,
"declared_reason": null,
"unverified_reason": null,
"unanswered_open_prs": null,
"unanswered_open_issues": null,
"days_since_last_merged_pr": null,
"days_since_last_human_commit": 6,
"days_since_last_human_commit_is_floor": false
},
"components": [
{
"key": "project_is_still_maintained",
"name": "Project is still maintained",
"detail": "last human commit 6 days ago",
"points": 100,
"status": "met",
"details": [
{
"code": "abandonment_maintained",
"params": {
"days": 6
}
}
],
"max_points": 100
}
]
}
],
"description": "Is the project alive — is code being written and are releases shipping?"
},
{
"key": "community",
"band": "excellent",
"name": "Community & Adoption",
"value": 95,
"weight": 0.18,
"metrics": [
{
"key": "popularity",
"band": "excellent",
"name": "Popularity & adoption",
"note": null,
"notes": [],
"value": 98,
"inputs": {
"forks": 4937,
"stars": 40627,
"watchers": 182,
"growth_state": "unverified",
"growth_factor_pct": 100,
"growth_unverified_reason": "no_history"
},
"components": [
{
"key": "stars",
"name": "Stars",
"detail": "40,627 stars",
"points": 60,
"status": "met",
"details": [
{
"code": "stars",
"params": {
"count": 40627
}
}
],
"max_points": 60
},
{
"key": "forks",
"name": "Forks",
"detail": "4,937 forks",
"points": 25,
"status": "met",
"details": [
{
"code": "forks",
"params": {
"count": 4937
}
}
],
"max_points": 25
},
{
"key": "watchers",
"name": "Watchers",
"detail": "182 watchers",
"points": 12.6,
"status": "partial",
"details": [
{
"code": "watchers",
"params": {
"count": 182
}
}
],
"max_points": 15
}
]
},
{
"key": "community_health",
"band": "excellent",
"name": "Community health",
"note": null,
"notes": [],
"value": 92,
"inputs": {
"has_readme": true,
"has_license": true,
"has_contributing": true,
"has_issue_template": false,
"has_code_of_conduct": true,
"has_pull_request_template": true
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 22.5,
"status": "met",
"details": [],
"max_points": 22.5
},
{
"key": "license",
"name": "License",
"detail": "recognized license (MIT)",
"points": 22.5,
"status": "met",
"details": [
{
"code": "license_standard",
"params": {}
},
{
"code": "license_spdx",
"params": {
"spdx": "MIT"
}
}
],
"max_points": 22.5
},
{
"key": "contributing_guide",
"name": "CONTRIBUTING guide",
"detail": null,
"points": 18,
"status": "met",
"details": [],
"max_points": 18
},
{
"key": "code_of_conduct",
"name": "Code of conduct",
"detail": null,
"points": 13.5,
"status": "met",
"details": [],
"max_points": 13.5
},
{
"key": "issue_template",
"name": "Issue template",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.2
},
{
"key": "pr_template",
"name": "PR template",
"detail": null,
"points": 6.3,
"status": "met",
"details": [],
"max_points": 6.3
}
]
}
],
"description": "Does the project have users, downloads, attention, and a welcoming setup for contributors?"
},
{
"key": "governance",
"band": "moderate",
"name": "Sustainability & Governance",
"value": 54,
"weight": 0.24,
"metrics": [
{
"key": "maintainer_resilience",
"band": "at_risk",
"name": "Maintainer resilience (bus factor)",
"note": null,
"notes": [],
"value": 34,
"inputs": {
"bus_factor": 1,
"contributors_sampled": 23,
"top_contributor_share": 0.775
},
"components": [
{
"key": "bus_factor",
"name": "Bus factor",
"detail": "1 contributor(s) cover half of all commits",
"points": 9,
"status": "partial",
"details": [
{
"code": "bus_factor",
"params": {
"count": 1
}
}
],
"max_points": 54
},
{
"key": "commit_distribution",
"name": "Commit distribution",
"detail": "top contributor authored 78% of commits",
"points": 5.1,
"status": "partial",
"details": [
{
"code": "top_contributor_share",
"params": {
"share": 78
}
}
],
"max_points": 22.5
},
{
"key": "contributor_breadth",
"name": "Contributor breadth",
"detail": "23 contributors",
"points": 13.5,
"status": "met",
"details": [
{
"code": "contributors_sampled",
"params": {
"count": 23
}
}
],
"max_points": 13.5
},
{
"key": "openssf_scorecard_contributors",
"name": "OpenSSF Scorecard: Contributors",
"detail": "project has 2 contributing companies or organizations -- score normalized to 6",
"points": 6,
"status": "partial",
"details": [],
"max_points": 10
}
]
},
{
"key": "responsiveness",
"band": "moderate",
"name": "Issue & PR responsiveness",
"note": null,
"notes": [],
"value": 61,
"inputs": {
"merged_prs": 63,
"open_issues": 11,
"closed_issues": 26,
"issue_closed_ratio": 0.703,
"closed_unmerged_prs": 27
},
"components": [
{
"key": "issue_resolution",
"name": "Issue resolution",
"detail": "70% of issues closed",
"points": 32.9,
"status": "partial",
"details": [
{
"code": "issues_closed_share",
"params": {
"share": 70
}
}
],
"max_points": 46.75
},
{
"key": "pr_acceptance",
"name": "PR acceptance",
"detail": "63/90 decided PRs merged",
"points": 26.8,
"status": "partial",
"details": [
{
"code": "decided_prs_merged",
"params": {
"merged": 63,
"decided": 90
}
}
],
"max_points": 38.25
},
{
"key": "openssf_scorecard_code_review",
"name": "OpenSSF Scorecard: Code-Review",
"detail": "Found 5/28 approved changesets -- score normalized to 1",
"points": 1.5,
"status": "partial",
"details": [],
"max_points": 15
}
]
},
{
"key": "stewardship",
"band": "good",
"name": "Ownership & stewardship",
"note": "Excluded from scoring (no data or not applicable): Verified domain. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"verified_domain"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 70,
"inputs": {
"followers": 926,
"owner_type": "User",
"is_verified": null,
"owner_login": "luongnv89",
"public_repos": 137,
"account_age_days": 4941
},
"components": [
{
"key": "ownership_backing",
"name": "Ownership backing",
"detail": "personal (user) account",
"points": 10,
"status": "partial",
"details": [
{
"code": "owner_personal",
"params": {}
}
],
"max_points": 30
},
{
"key": "verified_domain",
"name": "Verified domain",
"detail": "not applicable to user accounts",
"points": 0,
"status": "excluded",
"details": [
{
"code": "not_applicable_to_user_accounts",
"params": {}
}
],
"max_points": 20
},
{
"key": "owner_reach",
"name": "Owner reach",
"detail": "926 followers of luongnv89",
"points": 21.3,
"status": "partial",
"details": [
{
"code": "owner_followers",
"params": {
"count": 926,
"login": "luongnv89"
}
}
],
"max_points": 25
},
{
"key": "track_record",
"name": "Track record",
"detail": "137 public repos, account ~13 yr old",
"points": 25,
"status": "met",
"details": [
{
"code": "public_repos",
"params": {
"count": 137
}
},
{
"code": "account_age_years",
"params": {
"years": 13
}
}
],
"max_points": 25
}
]
}
],
"description": "Will the project survive its people — bus factor, responsiveness, who backs it, and package upkeep?"
},
{
"key": "engineering",
"band": "excellent",
"name": "Engineering Quality",
"value": 95,
"weight": 0.2,
"metrics": [
{
"key": "engineering_practices",
"band": "excellent",
"name": "Engineering practices",
"note": null,
"notes": [],
"value": 92,
"inputs": {
"has_ci": true,
"has_tests": true,
"has_editorconfig": false,
"has_linter_config": true,
"has_precommit_config": true
},
"components": [
{
"key": "ci_workflows",
"name": "CI workflows",
"detail": "4 workflow(s)",
"points": 24,
"status": "met",
"details": [
{
"code": "ci_workflows",
"params": {
"count": 4
}
}
],
"max_points": 24
},
{
"key": "tests_present",
"name": "Tests present",
"detail": null,
"points": 24,
"status": "met",
"details": [],
"max_points": 24
},
{
"key": "linter_config",
"name": "Linter config",
"detail": null,
"points": 16,
"status": "met",
"details": [],
"max_points": 16
},
{
"key": "pre_commit_hooks",
"name": "Pre-commit hooks",
"detail": null,
"points": 9.6,
"status": "met",
"details": [],
"max_points": 9.6
},
{
"key": "editorconfig",
"name": ".editorconfig",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 6.4
},
{
"key": "openssf_scorecard_ci_tests",
"name": "OpenSSF Scorecard: CI-Tests",
"detail": "18 out of 20 merged PRs checked by a CI test -- score normalized to 9",
"points": 18,
"status": "partial",
"details": [],
"max_points": 20
}
]
},
{
"key": "documentation",
"band": "excellent",
"name": "Documentation",
"note": null,
"notes": [],
"value": 100,
"inputs": {
"topics": [
"claude-code",
"guide",
"tutorial"
],
"has_wiki": true,
"homepage": "http://luongnv.com/claude-howto/",
"has_readme": true,
"has_docs_dir": true,
"has_description": true
},
"components": [
{
"key": "readme",
"name": "README",
"detail": null,
"points": 30,
"status": "met",
"details": [],
"max_points": 30
},
{
"key": "documentation_directory",
"name": "Documentation directory",
"detail": null,
"points": 25,
"status": "met",
"details": [],
"max_points": 25
},
{
"key": "documentation_homepage_site",
"name": "Documentation / homepage site",
"detail": "http://luongnv.com/claude-howto/",
"points": 15,
"status": "met",
"details": [],
"max_points": 15
},
{
"key": "repository_description",
"name": "Repository description",
"detail": null,
"points": 10,
"status": "met",
"details": [],
"max_points": 10
},
{
"key": "topics",
"name": "Topics",
"detail": "3 topics",
"points": 10,
"status": "met",
"details": [
{
"code": "topics_count",
"params": {
"count": 3
}
}
],
"max_points": 10
},
{
"key": "wiki",
"name": "Wiki",
"detail": null,
"points": 10,
"status": "met",
"details": [],
"max_points": 10
}
]
}
],
"description": "Are baseline engineering and documentation practices in place?"
},
{
"key": "security",
"band": "at_risk",
"name": "Security",
"value": 37,
"weight": 0.16,
"metrics": [
{
"key": "security_posture",
"band": "at_risk",
"name": "Security posture",
"note": "Excluded from scoring (no data or not applicable): Packaging. Remaining weights renormalized.",
"notes": [
{
"code": "excluded_no_data",
"params": {
"components": [
"packaging"
]
}
},
{
"code": "weights_renormalized",
"params": {}
}
],
"value": 37,
"inputs": {
"source": "openssf_scorecard",
"checks_evaluated": 17,
"scorecard_version": "v5.5.0",
"checks_inconclusive": 1,
"scorecard_aggregate": 3.7
},
"components": [
{
"key": "binary_artifacts",
"name": "Binary-Artifacts",
"detail": "no binaries found in the repo",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
},
{
"key": "branch_protection",
"name": "Branch-Protection",
"detail": "branch protection not enabled on development/release branches",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "ci_tests",
"name": "CI-Tests",
"detail": "18 out of 20 merged PRs checked by a CI test -- score normalized to 9",
"points": 2.2,
"status": "partial",
"details": [],
"max_points": 2.5
},
{
"key": "cii_best_practices",
"name": "CII-Best-Practices",
"detail": "no effort to earn an OpenSSF best practices badge detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 2.5
},
{
"key": "code_review",
"name": "Code-Review",
"detail": "Found 5/28 approved changesets -- score normalized to 1",
"points": 0.8,
"status": "partial",
"details": [],
"max_points": 7.5
},
{
"key": "contributors",
"name": "Contributors",
"detail": "project has 2 contributing companies or organizations -- score normalized to 6",
"points": 1.5,
"status": "partial",
"details": [],
"max_points": 2.5
},
{
"key": "dangerous_workflow",
"name": "Dangerous-Workflow",
"detail": "no dangerous workflow patterns detected",
"points": 10,
"status": "met",
"details": [],
"max_points": 10
},
{
"key": "dependency_update_tool",
"name": "Dependency-Update-Tool",
"detail": "no update tool detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "fuzzing",
"name": "Fuzzing",
"detail": "project is not fuzzed",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "license",
"name": "License",
"detail": "license file detected",
"points": 2.5,
"status": "met",
"details": [],
"max_points": 2.5
},
{
"key": "maintained",
"name": "Maintained",
"detail": "30 commit(s) and 7 issue activity found in the last 90 days -- score normalized to 10",
"points": 7.5,
"status": "met",
"details": [],
"max_points": 7.5
},
{
"key": "packaging",
"name": "Packaging",
"detail": "packaging workflow not detected",
"points": 0,
"status": "excluded",
"details": [
{
"code": "no_data",
"params": {}
}
],
"max_points": 5
},
{
"key": "pinned_dependencies",
"name": "Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "sast",
"name": "SAST",
"detail": "SAST tool is not run on all commits -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 5
},
{
"key": "security_policy",
"name": "Security-Policy",
"detail": "security policy file detected",
"points": 5,
"status": "met",
"details": [],
"max_points": 5
},
{
"key": "signed_releases",
"name": "Signed-Releases",
"detail": "Project has not signed or included provenance with any releases.",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "token_permissions",
"name": "Token-Permissions",
"detail": "detected GitHub workflow tokens with excessive permissions",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
},
{
"key": "vulnerabilities",
"name": "Vulnerabilities",
"detail": "22 existing vulnerabilities detected",
"points": 0,
"status": "missed",
"details": [],
"max_points": 7.5
}
]
},
{
"key": "high_risk_jurisdiction_exposure",
"band": "excellent",
"name": "High-Risk Jurisdiction Exposure",
"note": "Only high-confidence self-published location evidence affects this multiplier. Ambiguous matches are review-only; country evidence is not proof of nationality, citizenship, legal registration, malicious intent, or sanctions status.",
"notes": [
{
"code": "jurisdiction_evidence_limits",
"params": {}
}
],
"value": 100,
"inputs": {
"meaning": "self-published location evidence; not nationality or citizenship",
"red_flag": false,
"exposures": [],
"policy_countries": [
"Russia",
"Iran",
"North Korea"
],
"review_only_matches": 0,
"assessed_self_published_locations": 6
},
"components": [
{
"key": "policy_exposure_multiplier",
"name": "Policy exposure multiplier",
"detail": "no confirmed policy-scope location match",
"points": 100,
"status": "met",
"details": [
{
"code": "jurisdiction_no_match",
"params": {}
}
],
"max_points": 100
}
]
}
],
"description": "Are visible security and supply-chain practices strong, with no malicious dependency and no unresolved high-risk jurisdiction exposure?"
},
{
"key": "ai_readiness",
"band": "moderate",
"name": "AI Readiness",
"value": 60,
"weight": 0,
"metrics": [
{
"key": "ai_agent_context",
"band": "excellent",
"name": "Agent context & guidance",
"note": null,
"notes": [],
"value": 85,
"inputs": {
"has_llms_txt": false,
"legible_history_share": 0.98,
"agent_instruction_files": [
"CLAUDE.md",
"ja/CLAUDE.md",
"uk/CLAUDE.md",
"vi/CLAUDE.md"
],
"agent_instruction_max_bytes": 8618
},
"components": [
{
"key": "agent_instructions",
"name": "Agent instructions",
"detail": "CLAUDE.md, ja/CLAUDE.md, uk/CLAUDE.md, vi/CLAUDE.md",
"points": 45,
"status": "met",
"details": [
{
"code": "file_list",
"params": {
"files": "CLAUDE.md, ja/CLAUDE.md, uk/CLAUDE.md, vi/CLAUDE.md"
}
}
],
"max_points": 45
},
{
"key": "machine_readable_docs_llms_txt",
"name": "Machine-readable docs (llms.txt)",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 15
},
{
"key": "legible_commit_history",
"name": "Legible commit history",
"detail": "98 of 100 human commits state their intent (structured subject or explanatory body)",
"points": 40,
"status": "met",
"details": [
{
"code": "legible_history",
"params": {
"legible": 98,
"sampled": 100
}
}
],
"max_points": 40
}
]
},
{
"key": "ai_verify_loop",
"band": "at_risk",
"name": "Verify loop (build / test / typecheck)",
"note": null,
"notes": [],
"value": 43,
"inputs": {
"has_nix": false,
"has_tests": true,
"lockfiles": [],
"has_dockerfile": false,
"typed_language": false,
"bootstrap_files": [],
"has_devcontainer": false,
"has_linter_config": true,
"typecheck_configs": [],
"agent_commit_share": 0.16,
"toolchain_manifests": [],
"dependency_bot_commit_share": 0
},
"components": [
{
"key": "one_command_bootstrap",
"name": "One-command bootstrap",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 18
},
{
"key": "automated_tests",
"name": "Automated tests",
"detail": null,
"points": 22,
"status": "met",
"details": [],
"max_points": 22
},
{
"key": "lint_format_config",
"name": "Lint / format config",
"detail": null,
"points": 11,
"status": "met",
"details": [],
"max_points": 11
},
{
"key": "static_type_checking",
"name": "Static type checking",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 11
},
{
"key": "reproducible_environment",
"name": "Reproducible environment",
"detail": null,
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
},
{
"key": "demonstrated_agent_practice",
"name": "Demonstrated agent practice",
"detail": "16 of the last 100 commits agent-authored or agent-credited",
"points": 10,
"status": "met",
"details": [
{
"code": "agent_authored_commits",
"params": {
"count": 16,
"sampled": 100
}
}
],
"max_points": 10
},
{
"key": "automated_maintenance",
"name": "Automated maintenance",
"detail": "no automated dependency updates observed",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_dependency_automation",
"params": {}
}
],
"max_points": 8
},
{
"key": "openssf_scorecard_pinned_dependencies",
"name": "OpenSSF Scorecard: Pinned-Dependencies",
"detail": "dependency not pinned by hash detected -- score normalized to 0",
"points": 0,
"status": "missed",
"details": [],
"max_points": 10
}
]
},
{
"key": "ai_code_legibility",
"band": "moderate",
"name": "Code legibility for models",
"note": null,
"notes": [],
"value": 55,
"inputs": {
"primary_language": "Python",
"largest_source_bytes": 37875,
"source_files_sampled": 43,
"oversized_source_files": 0
},
"components": [
{
"key": "type_checkable_code",
"name": "Type-checkable code",
"detail": "Python without a type-check config",
"points": 0,
"status": "missed",
"details": [
{
"code": "no_typecheck_config_language",
"params": {
"language": "Python"
}
}
],
"max_points": 45
},
{
"key": "manageable_file_sizes",
"name": "Manageable file sizes",
"detail": "0/43 source files over 60KB",
"points": 55,
"status": "met",
"details": [
{
"code": "oversized_source_files",
"params": {
"kb": 60,
"sampled": 43,
"oversized": 0
}
}
],
"max_points": 55
}
]
}
],
"description": "How well is the repo equipped to be developed and maintained with AI coding agents? An independent, experimental badge — weight 0.0, so it is surfaced on its own and does not affect the overall health score."
}
],
"metrics_version": "1.13.0"
},
"warnings": [
"Star history unavailable: GitHub GraphQL error: Resource not accessible by personal access token",
"Could not fetch pypi package 'claude-howto' from its registry",
"GitHub dependency-graph SBOM unavailable (404); the dependency graph may be disabled for this repository"
],
"report_type": "repository",
"generated_at": "2026-07-29T00:07:28.778433Z",
"schema_version": "0.27.0",
"badge_url": "https://raw.githubusercontent.com/inspect-software/badges/main/v1/l/luongnv89/claude-howto.svg",
"full_name": "luongnv89/claude-howto",
"license_state": "standard",
"license_spdx": "MIT"
}
Related records
Inspected repositories sharing catalogue tags or ecosystems with luongnv89/claude-howto. Read them side by side →
Scores are signals, not warranties. They reflect publicly visible practices on GitHub — not a code audit, and not a security guarantee.
Missing data is excluded and weights renormalized, never scored as zero. Methodology is versioned and open: metrics v1.13.0, schema v0.27.0 — full methodology · metrics wiki.
