Skip to content

Fix outdated docs and add tasks/worktrees game tracking#46

Merged
OriNachum merged 3 commits into
mainfrom
fix/docs-freshness-and-new-tracking
Apr 11, 2026
Merged

Fix outdated docs and add tasks/worktrees game tracking#46
OriNachum merged 3 commits into
mainfrom
fix/docs-freshness-and-new-tracking

Conversation

@OriNachum

@OriNachum OriNachum commented Apr 11, 2026

Copy link
Copy Markdown
Owner

Summary

Closes #45

  • Docs freshness: Fix 5 outdated reference docs identified by the weekly docs-freshness check
    • Add auto permission mode (research preview) to starting-to-work.md
    • Add max effort level (Opus 4.6 only) to choosing-your-model.md
    • Add 9 missing hook events to built-ins.md (17→26 total)
    • Add 8 missing hook events to hooks.md (18→26 total)
    • Fix 3-day→7-day auto-expiry in loop.md (critical factual error)
  • New game tracking: Expand from 13→15 tracked feature categories
    • tasks (Intermediate, x10): tracks TaskCreate/Get/List/Update/Stop/Output
    • worktrees (Expert, x100): tracks EnterWorktree/ExitWorktree, depends on agents
    • Cron tools (CronCreate/Delete/List) now tracked under existing loop category
  • Updated: game-mode SKILL.md, level-up SKILL.md, migrate-data.sh, all hook scripts
  • Version: 2.15.0 → 2.16.0

Test plan

  • All 93 bats tests pass (including 8 new tests for task/worktree/cron tool mappings)
  • Verify auto mode section reads correctly in starting-to-work.md
  • Verify max effort level section reads correctly in choosing-your-model.md
  • Verify hook event tables have 26 entries in both built-ins.md and hooks.md
  • Verify loop.md references 7-day expiry consistently
  • Verify game-mode stats dashboard shows 15 features
  • Verify level-up roadmap includes tasks and worktrees

🤖 Generated with Claude Code

  • Claude

Docs freshness fixes:
- Add auto permission mode to starting-to-work.md
- Add max effort level to choosing-your-model.md
- Add 9 missing hook events to built-ins.md (17→26)
- Add 8 missing hook events to hooks.md (18→26)
- Fix 3-day→7-day auto-expiry in loop.md

New game tracking features (13→15 categories):
- tasks (Intermediate, x10): TaskCreate/Get/List/Update/Stop/Output
- worktrees (Expert, x100): EnterWorktree/ExitWorktree
- Cron tools (CronCreate/Delete/List) now tracked under loop

Bump version 2.15.0→2.16.0.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Copilot AI review requested due to automatic review settings April 11, 2026 17:33
@qodo-code-review

Copy link
Copy Markdown

Review Summary by Qodo

Expand game tracking to tasks/worktrees, fix docs freshness, and add auto mode documentation

✨ Enhancement 🐞 Bug fix

Grey Divider

Walkthroughs

Description
• Expand game tracking from 13→15 feature categories: tasks (Intermediate, x10) and worktrees
  (Expert, x100)
• Cron tools (CronCreate/Delete/List) now tracked under existing loop category
• Fix critical factual error: 3-day→7-day auto-expiry in loop scheduling
• Add 9 missing hook events to built-ins.md and 8 to hooks.md (17→26 total each)
• Add auto permission mode (research preview) and max effort level documentation
• Bump version 2.15.0→2.16.0 with 8 new test cases for task/worktree/cron tracking
Diagram
flowchart LR
  A["Game Tracking<br/>13→15 categories"] --> B["Tasks<br/>Intermediate x10"]
  A --> C["Worktrees<br/>Expert x100"]
  A --> D["Cron tools<br/>→ loop category"]
  E["Documentation<br/>Updates"] --> F["Hook events<br/>17→26 each"]
  E --> G["Auto mode<br/>research preview"]
  E --> H["Max effort level<br/>Opus 4.6 only"]
  I["Bug Fixes"] --> J["7-day auto-expiry<br/>loop.md"]
  K["Version"] --> L["2.15.0→2.16.0"]
Loading

Grey Divider

File Changes

1. hooks/scripts/migrate-data.sh ✨ Enhancement +1/-1

Add tasks and worktrees to feature categories

hooks/scripts/migrate-data.sh


2. hooks/scripts/track-stop.sh ✨ Enhancement +8/-5

Add worktrees multiplier and level gating logic

hooks/scripts/track-stop.sh


3. hooks/scripts/track-usage.sh ✨ Enhancement +5/-0

Map task and worktree tools to categories

hooks/scripts/track-usage.sh


View more (13)
4. tests/helpers/setup.sh 🧪 Tests +3/-1

Add tasks and worktrees to test template

tests/helpers/setup.sh


5. tests/migrate-data.bats 🧪 Tests +5/-5

Update tests for 15 feature categories

tests/migrate-data.bats


6. tests/track-stop.bats 🧪 Tests +1/-1

Update suggested features count to 15

tests/track-stop.bats


7. tests/track-usage.bats 🧪 Tests +46/-0

Add 8 new tests for task/worktree/cron tracking

tests/track-usage.bats


8. .claude-plugin/marketplace.json ⚙️ Configuration changes +1/-1

Bump version to 2.16.0

.claude-plugin/marketplace.json


9. .claude-plugin/plugin.json ⚙️ Configuration changes +1/-1

Bump version to 2.16.0

.claude-plugin/plugin.json


10. skills/ask/references/beginner/built-ins.md 📝 Documentation +9/-0

Add 9 missing hook events to documentation

skills/ask/references/beginner/built-ins.md


11. skills/ask/references/beginner/choosing-your-model.md 📝 Documentation +6/-1

Add max effort level and slash command documentation

skills/ask/references/beginner/choosing-your-model.md


12. skills/ask/references/beginner/starting-to-work.md 📝 Documentation +29/-6

Add auto mode research preview documentation

skills/ask/references/beginner/starting-to-work.md


13. skills/ask/references/intermediate/hooks.md 📝 Documentation +10/-2

Add 8 missing hook events to documentation

skills/ask/references/intermediate/hooks.md


14. skills/ask/references/intermediate/loop.md 🐞 Bug fix +3/-3

Fix 3-day→7-day auto-expiry critical factual error

skills/ask/references/intermediate/loop.md


15. skills/game-mode/SKILL.md ✨ Enhancement +9/-5

Update feature count and tier multipliers

skills/game-mode/SKILL.md


16. skills/level-up/SKILL.md ✨ Enhancement +8/-0

Add tasks and worktrees to roadmap with examples

skills/level-up/SKILL.md


Grey Divider

Qodo Logo

@qodo-code-review

qodo-code-review Bot commented Apr 11, 2026

Copy link
Copy Markdown

Code Review by Qodo

🐞 Bugs (0) 📘 Rule violations (0) 📎 Requirement gaps (0)

Grey Divider

Great, no issues found!

Qodo reviewed your code and found no material issues that require review

Grey Divider

ⓘ The new review experience is currently in Beta. Learn more

Grey Divider

Qodo Logo

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

This PR updates the guide’s reference docs for recent Claude Code changes and expands “game mode” tracking to include the new tasks and worktrees feature categories (plus cron tools mapped under loop), along with the necessary migrations, hooks, and tests.

Changes:

  • Refreshes several reference docs (permissions auto mode, model effort level max, hook event lists, /loop 7-day expiry correction).
  • Adds game tracking categories tasks and worktrees, and tracks Cron* tools under loop.
  • Updates migration logic, hook scripts, bats tests, and bumps plugin version to 2.16.0.

Reviewed changes

Copilot reviewed 16 out of 16 changed files in this pull request and generated 3 comments.

Show a summary per file
File Description
tests/track-usage.bats Adds bats coverage for new Task/Worktree/Cron tool-to-category mappings.
tests/track-stop.bats Updates “already suggested” feature list to include tasks.
tests/migrate-data.bats Updates migration expectations from 13 → 15 categories and validates tasks/worktrees.
tests/helpers/setup.sh Extends the test game-data.json template with tasks/worktrees.
hooks/scripts/track-usage.sh Maps Task* tools to tasks, Worktree enter/exit to worktrees, and Cron* to loop.
hooks/scripts/track-stop.sh Updates scoring multiplier + suggestions list to include tasks and worktrees, and updates unlocked count to /15.
hooks/scripts/migrate-data.sh Extends the expected schema categories array to include tasks/worktrees.
skills/game-mode/SKILL.md Updates game mode schema/docs and tier table for 15 categories including tasks/worktrees.
skills/level-up/SKILL.md Adds tasks/worktrees to the roadmap dependency graph and examples.
skills/ask/references/intermediate/loop.md Corrects /loop auto-expiry from 3 days → 7 days and related examples.
skills/ask/references/intermediate/hooks.md Expands documented hook events list to 26 entries.
skills/ask/references/beginner/built-ins.md Expands documented hook events list to 26 entries.
skills/ask/references/beginner/starting-to-work.md Adds auto permission mode and updates flowchart/Shift+Tab cycle description.
skills/ask/references/beginner/choosing-your-model.md Documents max effort level and how to set it.
.claude-plugin/plugin.json Bumps plugin version to 2.16.0.
.claude-plugin/marketplace.json Bumps marketplace version to 2.16.0.

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread skills/ask/references/beginner/starting-to-work.md
Comment thread tests/track-usage.bats
Comment thread skills/ask/references/beginner/starting-to-work.md
OriNachum and others added 2 commits April 11, 2026 21:12
…ests

- Rename "Beyond the Three Modes" → "Beyond the Permission Modes"
- Fix "Shift+Tab twice" → "Shift+Tab to cycle through modes" for Plan Mode
- Add tests for TaskGet, TaskStop, TaskOutput tool mappings

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Auto mode is experimental and requires understanding its safety
classifier — not a natural upgrade path from Accept Edits. Fix the
decision flowchart to separate it from the normal flow and mark the
section with an expert tier badge.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
@sonarqubecloud

Copy link
Copy Markdown

@OriNachum OriNachum merged commit 6c45bf2 into main Apr 11, 2026
2 checks passed
@OriNachum OriNachum deleted the fix/docs-freshness-and-new-tracking branch April 11, 2026 19:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs-freshness: weekly check (2026-04-11)

2 participants