diff --git a/.claude/settings.json b/.claude/settings.json index 5ea3f30..baeba8c 100644 --- a/.claude/settings.json +++ b/.claude/settings.json @@ -12,12 +12,20 @@ "mcp__chrome-devtools__*", "mcp__claude-in-chrome__*", "mcp__playwright__*", + "mcp__reddit-mcp-server__search_reddit", + "mcp__reddit-mcp-server__get_post_details", "mcp__tavily-web-search__tavily_search", "mcp__tavily-web-search__tavily_extract", "WebFetch(domain:api.open-meteo.com)", "WebFetch(domain:raw.githubusercontent.com)", "WebFetch(domain:docs.anthropic.com)", - "WebFetch(domain:support.claude.com)" + "WebFetch(domain:support.claude.com)", + "WebFetch(domain:github.com)", + "WebFetch(domain:api.github.com)", + "WebFetch(domain:json.schemastore.org)", + "WebFetch(domain:claudelog.com)", + "WebFetch(domain:www.eesel.ai)", + "WebFetch(domain:shipyard.build)" ], "deny": [], "ask": [ diff --git a/best-practice/claude-commands.md b/best-practice/claude-commands.md index 6f457b2..cb6a6a6 100644 --- a/best-practice/claude-commands.md +++ b/best-practice/claude-commands.md @@ -1,6 +1,6 @@ # Commands Best Practice -![Last Updated](https://img.shields.io/badge/Last_Updated-Mar%2025%2C%202026%208%3A07%20PM%20PKT-white?style=flat&labelColor=555)
+![Last Updated](https://img.shields.io/badge/Last_Updated-Mar%2026%2C%202026%201%3A01%20PM%20PKT-white?style=flat&labelColor=555)
[![Implemented](https://img.shields.io/badge/Implemented-2ea44f?style=flat)](../implementation/claude-commands-implementation.md) Claude Code commands — frontmatter fields and official built-in slash commands. @@ -14,7 +14,7 @@ Claude Code commands — frontmatter fields and official built-in slash commands --- -## Frontmatter Fields (11) +## Frontmatter Fields (12) | Field | Type | Required | Description | |-------|------|----------|-------------| @@ -28,6 +28,7 @@ Claude Code commands — frontmatter fields and official built-in slash commands | `effort` | string | No | Override the model effort level when invoked (`low`, `medium`, `high`, `max`) | | `context` | string | No | Set to `fork` to run the command in an isolated subagent context | | `agent` | string | No | Subagent type when `context: fork` is set (default: `general-purpose`) | +| `shell` | string | No | Shell for `` !`command` `` blocks — accepts `bash` (default) or `powershell`. Requires `CLAUDE_CODE_USE_POWERSHELL_TOOL=1` | | `hooks` | object | No | Lifecycle hooks scoped to this command | --- @@ -75,7 +76,7 @@ Claude Code commands — frontmatter fields and official built-in slash commands | 37 | `/skills` | ![Extensions](https://img.shields.io/badge/Extensions-16A085?style=flat) | List available skills | | 38 | `/memory` | ![Memory](https://img.shields.io/badge/Memory-3498DB?style=flat) | Edit CLAUDE.md memory files, enable or disable auto-memory, and view auto-memory entries | | 39 | `/effort [low\|medium\|high\|max\|auto]` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | Set the model effort level | -| 40 | `/fast` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | Toggle fast mode — same Opus 4.6 model with faster output | +| 40 | `/fast [on\|off]` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | Toggle fast mode — same Opus 4.6 model with faster output | | 41 | `/model` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | Switch models (haiku, sonnet, opus) and adjust effort level | | 42 | `/passes [number]` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | Share a free week of Claude Code with friends. Only visible if your account is eligible | | 43 | `/plan` | ![Model](https://img.shields.io/badge/Model-E67E22?style=flat) | Enter read-only planning mode — suggests approaches without making changes | diff --git a/best-practice/claude-skills.md b/best-practice/claude-skills.md index c6b8336..98f5bcc 100644 --- a/best-practice/claude-skills.md +++ b/best-practice/claude-skills.md @@ -1,6 +1,6 @@ # Skills Best Practice -![Last Updated](https://img.shields.io/badge/Last_Updated-Mar%2025%2C%202026%208%3A06%20PM%20PKT-white?style=flat&labelColor=555)
+![Last Updated](https://img.shields.io/badge/Last_Updated-Mar%2026%2C%202026%2012%3A59%20PM%20PKT-white?style=flat&labelColor=555)
[![Implemented](https://img.shields.io/badge/Implemented-2ea44f?style=flat)](../implementation/claude-skills-implementation.md) Claude Code skills — frontmatter fields and official bundled skills. @@ -14,7 +14,7 @@ Claude Code skills — frontmatter fields and official bundled skills. --- -## Frontmatter Fields (11) +## Frontmatter Fields (12) | Field | Type | Required | Description | |-------|------|----------|-------------| @@ -29,6 +29,7 @@ Claude Code skills — frontmatter fields and official bundled skills. | `context` | string | No | Set to `fork` to run the skill in an isolated subagent context | | `agent` | string | No | Subagent type when `context: fork` is set (default: `general-purpose`) | | `hooks` | object | No | Lifecycle hooks scoped to this skill | +| `shell` | string | No | Shell for `` !`command` `` blocks — `bash` (default) or `powershell`. Requires `CLAUDE_CODE_USE_POWERSHELL_TOOL=1` | --- diff --git a/best-practice/claude-subagents.md b/best-practice/claude-subagents.md index 42ff065..336a3ab 100644 --- a/best-practice/claude-subagents.md +++ b/best-practice/claude-subagents.md @@ -1,6 +1,6 @@ # Sub-agents Best Practice -![Last Updated](https://img.shields.io/badge/Last_Updated-Mar%2025%2C%202026%208%3A07%20PM%20PKT-white?style=flat&labelColor=555)
+![Last Updated](https://img.shields.io/badge/Last_Updated-Mar%2026%2C%202026%201%3A01%20PM%20PKT-white?style=flat&labelColor=555)
[![Implemented](https://img.shields.io/badge/Implemented-2ea44f?style=flat)](../implementation/claude-subagents-implementation.md) Claude Code subagents — frontmatter fields and official built-in agent types. @@ -14,7 +14,7 @@ Claude Code subagents — frontmatter fields and official built-in agent types. --- -## Frontmatter Fields (15) +## Frontmatter Fields (16) | Field | Type | Required | Description | |-------|------|----------|-------------| @@ -32,6 +32,7 @@ Claude Code subagents — frontmatter fields and official built-in agent types. | `background` | boolean | No | Set to `true` to always run as a background task (default: `false`) | | `effort` | string | No | Effort level override when this subagent is active: `low`, `medium`, `high`, `max`. Default: inherits from session | | `isolation` | string | No | Set to `"worktree"` to run in a temporary git worktree (auto-cleaned if no changes) | +| `initialPrompt` | string | No | Auto-submitted as the first user turn when this agent runs as the main session agent (via `--agent` or the `agent` setting). Commands and skills are processed. Prepended to any user-provided prompt | | `color` | string | No | CLI output color for visual distinction (e.g., `green`, `magenta`). Functional but absent from official frontmatter table — documented in interactive quickstart only | --- diff --git a/changelog/best-practice/claude-commands/changelog.md b/changelog/best-practice/claude-commands/changelog.md index d805293..65ef5fb 100644 --- a/changelog/best-practice/claude-commands/changelog.md +++ b/changelog/best-practice/claude-commands/changelog.md @@ -108,3 +108,12 @@ No priority action items — report is fully in sync with official documentation | # | Priority | Type | Action | Status | |---|----------|------|--------|--------| | 1 | HIGH | New Command | Add `/schedule [description]` to Remote tag — Create, update, list, or run Cloud scheduled tasks | ✅ COMPLETE (added as #56 in Remote tag, count updated 63 → 64) | + +--- + +## [2026-03-26 01:01 PM PKT] Claude Code v2.1.84 + +| # | Priority | Type | Action | Status | +|---|----------|------|--------|--------| +| 1 | HIGH | New Field | Add `shell` to frontmatter table — shell for `!command` blocks (`bash` or `powershell`) | ✅ COMPLETE (added as 12th field before `hooks`, count updated 11 → 12) | +| 2 | LOW | Changed Argument | Add `[on\|off]` argument hint to `/fast` command | ✅ COMPLETE (updated `/fast` to `/fast [on\|off]` at #40 in Model tag) | diff --git a/changelog/best-practice/claude-skills/changelog.md b/changelog/best-practice/claude-skills/changelog.md index b560c57..2969d19 100644 --- a/changelog/best-practice/claude-skills/changelog.md +++ b/changelog/best-practice/claude-skills/changelog.md @@ -65,3 +65,11 @@ No drift detected — frontmatter fields (11) and bundled skills (5) are fully s ## [2026-03-25 08:06 PM PKT] Claude Code v2.1.83 No drift detected — frontmatter fields (11) and bundled skills (5) are fully synchronized with official docs. + +--- + +## [2026-03-26 12:59 PM PKT] Claude Code v2.1.84 + +| # | Priority | Type | Action | Status | +|---|----------|------|--------|--------| +| 1 | HIGH | New Field | Add `shell` field to frontmatter table — accepts `bash` (default) or `powershell`, controls shell for `!command` blocks in skill content | ✅ COMPLETE (added to frontmatter table, count updated 11→12) | diff --git a/changelog/best-practice/claude-subagents/changelog.md b/changelog/best-practice/claude-subagents/changelog.md index 9b384a4..4ccd463 100644 --- a/changelog/best-practice/claude-subagents/changelog.md +++ b/changelog/best-practice/claude-subagents/changelog.md @@ -102,3 +102,11 @@ No drift detected — report is fully in sync with official docs. All 15 frontma No drift detected — report is fully in sync with official docs. All 15 frontmatter fields (14 official + 1 unofficial `color`) and 6 built-in agents match. **Watch item:** `initialPrompt` was added in v2.1.83 changelog but has not yet appeared in the official docs' supported frontmatter fields table. When it does, the report will need updating. + +--- + +## [2026-03-26 01:01 PM PKT] Claude Code v2.1.84 + +| # | Priority | Type | Action | Status | +|---|----------|------|--------|--------| +| 1 | HIGH | New Field | Add `initialPrompt` to Frontmatter Fields table (string, optional — auto-submitted as first user turn when agent runs as main session agent via `--agent` or `agent` setting) | ✅ COMPLETE (added between `isolation` and `color`, count updated 15→16) | diff --git a/changelog/best-practice/concepts/changelog.md b/changelog/best-practice/concepts/changelog.md index 7080c25..63611cb 100644 --- a/changelog/best-practice/concepts/changelog.md +++ b/changelog/best-practice/concepts/changelog.md @@ -194,3 +194,20 @@ Tracks drift between the README CONCEPTS table and official Claude Code document | 6 | LOW | Verification | Git Worktrees anchor `#run-parallel-claude-code-sessions-with-git-worktrees` confirmed on /common-workflows page | ✅ COMPLETE (section heading exists) | | 7 | LOW | Verification | All CONCEPTS descriptions checked against official docs — no drift detected | ✅ COMPLETE (all descriptions accurate) | | 8 | HIGH | Missing Concept | Add Auto Mode row to Hot table — background safety classifier replaces permission prompts (research preview, Team/Enterprise) | ✅ COMPLETE (row added as first Hot entry with beta badge, BP badge linking to @claudeai tweet, and blog link) | + +--- + +## [2026-03-26 01:05 PM PKT] Claude Code v2.1.84 + +| # | Priority | Type | Action | Status | +|---|----------|------|--------|--------| +| 1 | HIGH | Stale URL | Commands URL `/slash-commands` serves Skills page — docs say "commands merged into skills" | ❌ INVALID (RECURRING from 2026-03-10; URL still resolves; user chose to keep as-is) | +| 2 | MED | Missing Concept | Add Slack integration to Hot table — mention @Claude in Slack to route coding tasks to Claude Code web sessions | ✅ COMPLETE (row added after Channels with @Claude location and web session description) | +| 3 | MED | Missing Concept | Add GitHub Actions / CI-CD to Hot table — automate PR reviews, issue triage, and code generation in CI/CD pipelines | ✅ COMPLETE (row added after Code Review with .github/workflows/ location and GitLab CI/CD inline link) | +| 4 | LOW | Verification | All 35 external docs URLs validated — no broken links found | ✅ COMPLETE (all URLs return valid pages including /slash-commands redirect) | +| 5 | LOW | Verification | All local badge file paths validated — no missing files | ✅ COMPLETE (all 20+ badge targets exist on filesystem) | +| 6 | LOW | Verification | Memory anchor `#organize-rules-with-clauderules` confirmed on /memory page | ✅ COMPLETE (section heading exists) | +| 7 | LOW | Verification | Git Worktrees anchor `#run-parallel-claude-code-sessions-with-git-worktrees` confirmed on /common-workflows page | ✅ COMPLETE (section heading exists) | +| 8 | LOW | Verification | Auto Mode anchor `#eliminate-prompts-with-auto-mode` confirmed on /permission-modes page | ✅ COMPLETE (section heading exists) | +| 9 | LOW | Verification | Bundled Skills anchor `#bundled-skills` confirmed on /skills page | ✅ COMPLETE (section heading exists) | +| 10 | LOW | Verification | All CONCEPTS descriptions checked against official docs — no drift detected | ✅ COMPLETE (all descriptions accurate) | diff --git a/changelog/development-workflows/changelog.md b/changelog/development-workflows/changelog.md index 01ad358..034cadf 100644 --- a/changelog/development-workflows/changelog.md +++ b/changelog/development-workflows/changelog.md @@ -119,3 +119,15 @@ | 4 | HIGH | Star Update | Update gstack ★ from 44k to 47k (46,703 actual — infrastructure hardening, test coverage gates) | COMPLETE (updated README table) | | 5 | MED | Count Update | Update BMAD skills from 44 to 42 (recount: 30 bmm-skills + 12 core-skills; v6.2.1 consolidated 2 sub-skills) | COMPLETE (updated README table) | | 6 | LOW | Count Update | Update gstack skills from 28 to 27 (27 root-level dirs confirmed; 28th may be root SKILL.md template) | COMPLETE (updated README table) | + +--- + +## [2026-03-26 01:05 PM PKT] Development Workflows Update + +| # | Priority | Type | Action | Status | +|---|----------|------|--------|--------| +| 1 | HIGH | Star Update | Update Superpowers ★ from 112k to 114k (114,107 actual) | COMPLETE (updated README table) | +| 2 | HIGH | Star Update | Update ECC ★ from 107k to 109k (108,839 actual) | COMPLETE (updated README table) | +| 3 | HIGH | Star Update | Update gstack ★ from 47k to 48k (48,303 actual) | COMPLETE (updated README table) | +| 4 | HIGH | Star Update | Update GSD ★ from 41k to 42k (42,092 actual) | COMPLETE (updated README table) | +| 5 | MED | Count Update | Update OpenSpec commands from 10 to 11 (v1.2.0 added /opsx:explore) | COMPLETE (updated README table) |