oh-my-customcodex 0.4.17 → 0.5.1

package/templates/.claude/skills/memory-save/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: memory-save
-description: Save current session context to claude-mem
+description: Save current session context to native memory plus omx-memory or AgentMemory-compatible backends
 scope: core
 argument-hint: "[--tags <tags>] [--include-code]"
 disable-model-invocation: true
@@ -9,7 +9,7 @@ user-invocable: true
 
 # Memory Save Skill
 
-Save current session context to claude-mem for persistence across context compaction.
+Save current session context to native memory and the configured searchable MCP backend for persistence across context compaction. Prefer AgentMemory-compatible or `omx-memory` tools (`memory_add`, `observation_add`); fall back to legacy `claude-mem` only when that is the configured backend.
 
 ## Options
 
@@ -35,8 +35,10 @@ Save current session context to claude-mem for persistence across context compac
    ├── tags: [session, ...user_tags]
    └── created_at: {timestamp}
 
-3. Store in claude-mem
-   └── chroma_add_documents
+3. Store in configured backend
+   ├── Prefer memory_add for summaries
+   ├── Prefer observation_add for atomic learnings
+   └── Legacy fallback: chroma_add_documents
 
 4. Report result
 ```
@@ -112,7 +114,7 @@ Open Items:
   1. Refresh token implementation
      Status: In progress
 
-Saving to claude-mem...
+Saving to configured memory backend...
 
 Document content:
   ## Session Summary
@@ -126,3 +128,4 @@ Memory ID: mem_abc123
 ## Related
 
 - memory-recall - Search and recall memories
+- memory-management - Backend selection and migration safeguards

package/templates/.claude/skills/npm-version/SKILL.md

@@ -97,6 +97,12 @@ When working with `auto-tag.yml` (automatic tag creation on release PR merge):
 
 ### Troubleshooting
 
+If `release/vX.Y.Z` cannot be created because `refs/heads/release` exists:
+```bash
+git branch --list release --format='%(refname:short)'
+git branch -m release releases-tracking  # only after proving it is merged/backed up
+```
+
 If a tag already exists on remote (from a previous failed attempt):
 ```bash
 git push origin :refs/tags/vX.Y.Z   # delete remote tag

package/templates/.claude/skills/pipeline/labels.md

@@ -0,0 +1,55 @@
+# Pipeline Label Standards
+
+Canonical reference for GitHub issue label semantics in the auto-dev pipeline.
+Used by `scope-selection` to include or exclude issues and by `implement` for lifecycle management.
+
+## Label Definitions
+
+| Label | Meaning | scope-selection handling |
+|-------|---------|--------------------------|
+| `verify-ready` | Triage complete, ready for verification or automation | INCLUDE (preferred) |
+| `verify-done` | Triage complete but deferred, already handled, or excluded from this cycle | EXCLUDE |
+| `in-progress` | Work is claimed by another session | EXCLUDE |
+| `needs-review` | Human review is required before automation | EXCLUDE |
+| `decision-needed` | Security, policy, or product decision required | EXCLUDE |
+| `automated` | Auto-generated issue from release-monitor tooling | INCLUDE if other criteria match |
+| `codex-release` | Codex release monitor trigger | INCLUDE (preferred) |
+| `oh-my-codex-release` | oh-my-codex release monitor trigger | INCLUDE (preferred) |
+| `claude-code-release` | Claude compatibility release trigger | INCLUDE (preferred) |
+| `documentation` | Documentation-only scope | INCLUDE (preferred for docs-only release) |
+| `enhancement-yaml-only` | YAML/config-only scope change | INCLUDE (eligible for docs-only compression) |
+
+## Selection Rule
+
+```text
+EXCLUDE if:
+  - blocked_by_decision == true
+  - labels intersect {decision-needed, needs-review, verify-done, manual-action, in-progress}
+
+INCLUDE (preferred tier):
+  - labels intersect {verify-ready, codex-release, oh-my-codex-release, claude-code-release, documentation}
+
+INCLUDE (standard tier):
+  - P1/P2/P3 issues not in excluded set
+
+Tie-break priority: P1 > P2 > P3 > unclassified
+```
+
+## Compression Eligibility
+
+An issue is eligible for `docs-only` compression mode if its labels include at least one of:
+`documentation`, `automated`, `codex-release`, `oh-my-codex-release`, `claude-code-release`, `enhancement-yaml-only`.
+
+If all scoped issues are compression-eligible and scope size is 3 or fewer, the pipeline may use
+`compression_mode=docs-only` and replace heavyweight triage, planning, and verification spawns with
+direct manifest summaries plus a local self-review checklist.
+
+## Lifecycle Labels
+
+| Transition | Action |
+|------------|--------|
+| Work started | Add `in-progress`, assign the current operator |
+| Work succeeded | Remove `in-progress`, add `verify-ready` |
+| Work failed | Remove `in-progress`, add `needs-review` |
+| Released | Remove `verify-ready`, close with `Fixed in v{version}` |
+| Deferred | Add `verify-done`, label `Deferred from v{version}` |

package/templates/.claude/skills/sec-agentshield-wrapper/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: sec-agentshield-wrapper
+description: Pre-flight AgentShield-style security suite wrapper for agent harness changes
+scope: harness
+version: 1.0.0
+user-invocable: true
+argument-hint: "<path> [--strict] [--report <file>]"
+---
+
+# AgentShield Wrapper
+
+Run an AgentShield-style pre-flight review before risky agent, skill, hook, or MCP changes. This skill is a wrapper contract: use a connected AgentShield tool when available, otherwise run the local static checks that approximate the same boundary.
+
+## Checks
+
+| Area | What to Inspect |
+|------|-----------------|
+| Tool authority | Agent frontmatter tools, disallowed tools, and permission mode |
+| Prompt injection | Untrusted text flowing into tool instructions or shell commands |
+| Secret exposure | Tokens, private keys, bearer headers, and credential-like literals |
+| Path boundaries | Writes to `.git`, runtime state, templates, and compatibility mirrors |
+| MCP risk | New servers, remote URLs, timeout behavior, and tool naming collisions |
+
+## Workflow
+
+1. Identify changed files with `git diff --name-only` unless a path is supplied.
+2. Prefer an installed AgentShield scanner if one is configured.
+3. Fall back to existing repo checks:
+   - `secret-filter`
+   - schema validator guidance
+   - `adversarial-review`
+   - `cve-triage` for dependency advisories
+4. Report findings as `blocker`, `warn`, or `info`.
+5. In `--strict` mode, halt on any blocker or unreviewed MCP/tool expansion.
+
+## Output
+
+```text
+sec-agentshield-wrapper target=.codex/skills/new-skill
+blocker: 0
+warn: 1
+info: 2
+decision: proceed-with-review
+```
+
+## Notes
+
+- This wrapper complements `sec-codeql-expert`; it does not replace CodeQL or dependency audit.
+- Missing AgentShield tooling is not a failure if local fallback checks run and are reported.

package/templates/AGENTS.md.en

@@ -134,8 +134,8 @@ project/
 |   +-- hooks/                   # Hook scripts (security, validation, HUD)
 |   +-- contexts/                # Context files (ecomode)
 +-- .agents/
-|   +-- skills/                  # Installed skills (118 directories)
-+-- guides/                      # Reference docs (26 topics)
+|   +-- skills/                  # Installed skills (123 directories)
++-- guides/                      # Reference docs (48 topics)
 ```
 
 ## Orchestration
@@ -226,6 +226,7 @@ Task tool + routing skills remain the fallback for simple/cost-sensitive tasks.
 | Server | Purpose |
 |--------|---------|
 | omx-memory | Session memory persistence (Chroma-based) |
+| semble | Semantic code search MCP for high-recall repository exploration |
 | context7 | Library documentation lookup MCP server when a project needs it |
 
 ### Setup Commands
@@ -234,6 +235,9 @@ Task tool + routing skills remain the fallback for simple/cost-sensitive tasks.
 # MCP setup (omx-memory)
 npm install -g omx-memory
 omx-memory setup
+
+# Optional semantic code search
+uv tool install semble
 ```
 
 ### Claude Code Compatibility Note

package/templates/AGENTS.md.ko

@@ -134,8 +134,8 @@ project/
 |   +-- hooks/                   # 훅 스크립트 (보안, 검증, HUD)
 |   +-- contexts/                # 컨텍스트 파일 (ecomode)
 +-- .agents/
-|   +-- skills/                  # 설치된 스킬 (118 디렉토리)
-+-- guides/                      # 레퍼런스 문서 (26 토픽)
+|   +-- skills/                  # 설치된 스킬 (123 디렉토리)
++-- guides/                      # 레퍼런스 문서 (48 토픽)
 ```
 
 ## 오케스트레이션
@@ -226,6 +226,7 @@ Codex CLI의 Agent Teams 기능이 활성화되어 있으면 (`OMCODEX_AGENT_TEA
 | 서버 | 용도 |
 |------|------|
 | omx-memory | 세션 메모리 영속성 (Chroma 기반) |
+| semble | 대규모 저장소 탐색용 semantic code search MCP |
 | context7 | 라이브러리 문서 조회용 MCP 서버 (프로젝트 필요 시 설정) |
 
 ### 설치 명령어
@@ -234,6 +235,9 @@ Codex CLI의 Agent Teams 기능이 활성화되어 있으면 (`OMCODEX_AGENT_TEA
 # MCP 설정 (omx-memory)
 npm install -g omx-memory
 omx-memory setup
+
+# 선택: semantic code search
+uv tool install semble
 ```
 
 ### Claude Code 호환 참고

package/templates/CLAUDE.md

@@ -119,8 +119,8 @@ project/
 |   +-- hooks/                   # 훅 스크립트 (보안, 검증, HUD)
 |   +-- contexts/                # 컨텍스트 파일 (ecomode)
 +-- .agents/
-|   +-- skills/                  # 스킬 (118 디렉토리)
-+-- guides/                      # 레퍼런스 문서 (39 토픽)
+|   +-- skills/                  # 스킬 (123 디렉토리)
++-- guides/                      # 레퍼런스 문서 (48 토픽)
 ```
 
 ## 오케스트레이션
@@ -244,6 +244,7 @@ Codex CLI의 Agent Teams 기능이 활성화되어 있으면 (`OMCODEX_AGENT_TEA
 | 서버 | 용도 |
 |------|------|
 | omx-memory | 세션 메모리 영속성 |
+| semble | 대규모 저장소 탐색용 semantic code search MCP |
 
 ### 설치 명령어
 
@@ -267,6 +268,9 @@ claude agents
 
 # MCP 설정 (omx-memory)
 omx memory doctor
+
+# 선택: semantic code search
+uv tool install semble
 ```
 
 <!-- omcodex:git-workflow -->

package/templates/CLAUDE.md.en

@@ -133,11 +133,11 @@ project/
 +-- AGENTS.md                    # Entry point
 +-- .codex/
 |   +-- agents/                  # Subagent definitions (49 files)
-|   +-- skills/                  # Skills (118 directories)
+|   +-- skills/                  # Skills (123 directories)
 |   +-- rules/                   # Global rules (22 files)
 |   +-- hooks/                   # Hook scripts (security, validation, HUD)
 |   +-- contexts/                # Context files (4 files)
-+-- guides/                      # Reference docs (39 topics)
++-- guides/                      # Reference docs (48 topics)
 ```
 
 ## Orchestration
@@ -240,6 +240,7 @@ Install in Claude Code via `/plugin install <name>`:
 | Server | Purpose |
 |--------|---------|
 | omx-memory | Session memory persistence |
+| semble | Semantic code search MCP for high-recall repository exploration |
 
 ### Claude Code Setup Commands
 
@@ -263,6 +264,9 @@ claude agents
 
 # MCP setup (omx-memory)
 omx memory doctor
+
+# Optional semantic code search
+uv tool install semble
 ```
 
 <!-- omcodex:git-workflow -->

package/templates/CLAUDE.md.ko

@@ -133,11 +133,11 @@ project/
 +-- AGENTS.md                    # 진입점
 +-- .codex/
 |   +-- agents/                  # 서브에이전트 정의 (49 파일)
-|   +-- skills/                  # 스킬 (118 디렉토리)
+|   +-- skills/                  # 스킬 (123 디렉토리)
 |   +-- rules/                   # 전역 규칙 (22 파일)
 |   +-- hooks/                   # 훅 스크립트 (보안, 검증, HUD)
 |   +-- contexts/                # 컨텍스트 파일 (4 파일)
-+-- guides/                      # 레퍼런스 문서 (39 토픽)
++-- guides/                      # 레퍼런스 문서 (48 토픽)
 ```
 
 ## 오케스트레이션
@@ -240,6 +240,7 @@ Claude Code 환경에서 `/plugin install <이름>`으로 설치:
 | 서버 | 용도 |
 |------|------|
 | omx-memory | 세션 메모리 영속성 |
+| semble | 대규모 저장소 탐색용 semantic code search MCP |
 
 ### Claude Code 설치 명령어
 
@@ -263,6 +264,9 @@ claude agents
 
 # MCP 설정 (omx-memory)
 omx memory doctor
+
+# 선택: semantic code search
+uv tool install semble
 ```
 
 <!-- omcodex:git-workflow -->

package/templates/README.md

@@ -0,0 +1,110 @@
+# templates/
+
+> **oh-my-customcodex distribution directory**
+>
+> Source files copied or transformed when `omcustomcodex init` installs the harness into a project.
+
+## Purpose
+
+`templates/` is the packaged distribution snapshot for oh-my-customcodex.
+
+The installer maps the Claude-compatible template tree into the Codex-native runtime layout:
+
+```text
+oh-my-customcodex source repo
+  templates/
+    .claude/                  # compatibility template source
+    guides/                   # reference documentation
+    AGENTS.md.en              # Codex entry template
+    AGENTS.md.ko
+
+installed project
+  .codex/                     # Codex-native agents, rules, hooks, contexts, ontology
+  .agents/skills/             # installed runtime skills
+  guides/                     # reference documentation
+  AGENTS.md                   # project entrypoint
+```
+
+The repository keeps `.codex/**` as the authoring surface. `templates/.claude/**` remains a compatibility source that the installer maps into the target Codex layout.
+
+## Main README Relationship
+
+| Document | Audience | Purpose |
+|----------|----------|---------|
+| [`/README.md`](../README.md) | Users of the npm package | Project overview, install command, philosophy |
+| `templates/README.md` | Maintainers | Distribution layout, component counts, sync checks |
+
+## Directory Structure
+
+```text
+templates/
++-- README.md                         # this file
++-- AGENTS.md.en                      # Codex entry template, English
++-- AGENTS.md.ko                      # Codex entry template, Korean
++-- CLAUDE.md*                        # Claude compatibility entry templates
++-- manifest.json                     # packaged component metadata
++-- workflows/                        # project-level pipeline definitions
++-- .claude/
+|   +-- agents/                       # agent definitions (49 files)
+|   +-- skills/                       # skill modules (123 SKILL.md files)
+|   +-- rules/                        # global rules (22 files)
+|   +-- hooks/                        # hook registry and scripts (38 scripts)
+|   +-- contexts/                     # context files
+|   +-- ontology/                     # ontology and routing metadata
+|   +-- schemas/                      # tool input schemas
++-- guides/                           # reference docs (48 topics)
+```
+
+## Components
+
+The counts below should stay aligned with `templates/manifest.json`, README component headings, and CI template validation.
+
+### Agents (49)
+
+`templates/.claude/agents/*.md`
+
+Flat agent definition files. During Codex installation these land under `.codex/agents/`.
+
+### Skills (123)
+
+`templates/.claude/skills/*/SKILL.md`
+
+Reusable workflow and reference skill modules. During Codex installation these land under `.agents/skills/`.
+
+### Rules (22)
+
+`templates/.claude/rules/*.md`
+
+Global agent behavior rules. During Codex installation these land under `.codex/rules/`.
+
+### Guides (48)
+
+`templates/guides/*/`
+
+Reference documentation directories copied to installed projects as `guides/`.
+
+### Hooks (38)
+
+`templates/.claude/hooks/scripts/*.sh`
+
+Lifecycle hook scripts copied into `.codex/hooks/scripts/`.
+
+## Local Verification
+
+Run the checks below before publishing a template-affecting change:
+
+```bash
+bash .github/scripts/verify-version-sync.sh
+bun test tests/unit/core/template-validation.test.ts
+```
+
+The CI template-sync job also verifies source/template counts for agents, skills, rules, guides, hook scripts, hook matchers, schemas, and skill scripts.
+
+## Maintainer Notes
+
+When adding or removing an agent, skill, rule, guide, hook, or workflow:
+
+1. Update the source surface under `.codex/**`, `.agents/skills/**`, `guides/**`, or `workflows/**`.
+2. Mirror packaged content under `templates/**` according to the provider mapping.
+3. Update `templates/manifest.json` and visible documentation counts.
+4. Add or update a regression test when the drift could recur.

package/templates/guides/claude-code/14-token-efficiency.md

@@ -22,12 +22,16 @@ Use R013 ecomode and existing runtime guards when you want to compress active-se
 
 This layer changes how the session behaves while work is running.
 
-## Layer 3: Tool-Specific Compression
+## Layer 3: Retrieval and Tool-Specific Compression
+
+Use semantic code search or graph retrieval before broad file reads when the problem is repository exploration. Prefer Semble when an indexed semantic MCP is connected, and prefer CRG/code-review-graph when the task needs impact radius or dependency context. Fall back to `rg` and targeted reads when those tools are unavailable.
 
 Use `playwright-compress` when the problem is not the whole session, but one extremely verbose browser tool result.
 
 This layer is intentionally narrow:
 
+- use Semble for high-recall code search over large repositories
+- use CRG for `get_minimal_context`, `get_impact_radius`, and trust-boundary graph queries
 - compress verbose Playwright MCP output after the tool succeeds
 - preserve `ref=` tokens and URLs for follow-up interaction
 - keep browser evidence actionable without keeping the full raw payload in context
@@ -64,6 +68,7 @@ Typical settings-level levers:
 |------|------------|
 | Protect cache value across pauses | Layer 1 |
 | Compress runtime behavior in large sessions | Layer 2 |
+| Reduce broad code-search reads | Layer 3 |
 | Compress one noisy browser interaction | Layer 3 |
 | Reduce baseline token spend from configuration | Layer 4 |
 

package/templates/guides/claude-code/15-version-compatibility.md

@@ -2,6 +2,24 @@
 
 This guide records Claude Code release-note impact that affects the Claude compatibility template. The Codex-native runtime still uses `.codex/**` and OMX as the primary surface.
 
+## v2.1.142
+
+Published: 2026-05-14.
+
+Source: upstream oh-my-customcode #1158, Codex port #1329.
+
+| Change | Impact on oh-my-customcodex | Action |
+|--------|------------------------------|--------|
+| `claude agents` added `--add-dir`, `--settings`, `--mcp-config`, `--plugin-dir`, `--permission-mode`, `--model`, `--effort`, and `--dangerously-skip-permissions` | Useful for Claude compatibility sessions that need CLI-level overrides for background agents. Codex-native child agents still use the Codex tool surface and repo model contract. | No Codex runtime change. Keep unattended Claude-template prompts explicit about permission mode. |
+| Fast Mode now defaults to Opus 4.7 | Only affects Claude compatibility users running Fast Mode with `model: opus` agents. | Pin with `CLAUDE_CODE_OPUS_4_6_FAST_MODE_OVERRIDE=1` only when a compatibility session needs old behavior. |
+| Root-level plugin `SKILL.md` is surfaced as a skill | Does not change this repo's packaged `.claude/skills/<name>/SKILL.md` layout. | No template migration. |
+| `/plugin details` shows plugin LSP servers | Improves plugin inventory visibility for compatibility users. | No package change. |
+| `/web-setup` warns before replacing an existing GitHub App connection | UX safety improvement outside this harness. | No action. |
+| `MCP_TOOL_TIMEOUT` now raises remote HTTP/SSE MCP request timeout as intended | Helpful for slow remote memory or ontology MCP servers. | Set `MCP_TOOL_TIMEOUT` in affected environments only. |
+| Background sessions can edit existing git worktrees | Stabilizes Claude compatibility workflows that use git worktrees for parallel branches. | No Codex-side change. |
+| Background sessions survive macOS sleep/wake more reliably | Improves long-running Claude compatibility sessions. | No action. |
+| `--dangerously-skip-permissions` persists across retire/wake cycles | Reduces unattended permission-mode drops for Claude compatibility sessions. | Keep explicit permission guidance in workflow prompts. |
+
 ## v2.1.141
 
 Published: 2026-05-13.
@@ -50,6 +68,23 @@ Published: 2026-05-11.
 | Native `/goal` | The packaged workflow uses `/omcustomcodex:goal`; native `/goal` stays available for Claude Code completion tracking. |
 | `claude agents`, `/scroll-speed`, `claude plugin details <name>`, `/mcp` reconnect | Documented in the CLI, MCP, AGENTS, and CLAUDE template guidance. |
 
+## Known Limitations
+
+### Parent `.gitignore` nested plan pattern
+
+Source: upstream oh-my-customcode #1147, Codex port #1326.
+
+The parent package documented a future-proofing limitation for this pattern:
+
+```gitignore
+docs/superpowers/plans/*
+!docs/superpowers/plans/*.md
+```
+
+That pattern only tracks direct-child Markdown files. Git cannot re-include a file inside a directory that was already excluded by a broader parent pattern unless the directory path is also re-included.
+
+Current Codex-port status: not applicable. This repository does not ignore `docs/superpowers/plans/`, and existing nested plan documents are trackable. If a future ignore rule reintroduces that parent pattern, add explicit subdirectory re-includes before relying on nested plan files.
+
 ## Compatibility Rules
 
 1. Keep `.codex/**` as the source of truth for the Codex package.

package/templates/guides/git-safety/README.md

@@ -0,0 +1,44 @@
+# Git Safety Guide
+
+Use this guide when an agent or workflow needs to clean, reset, delete, or rewrite git state. The goal is to preserve user work first, then make the smallest safe git change with clear recovery evidence.
+
+## Destructive Command Reference
+
+| Command | Primary risk | Safer first step |
+|---------|--------------|------------------|
+| `git reset --hard` | Drops tracked worktree changes | Save `git diff` output or commit/stash intentionally |
+| `git clean -fd` / `git clean -fdx` | Deletes untracked files and generated artifacts | Run `git clean -ndx` and inspect the target list |
+| `git restore .` | Reverts tracked files broadly | Limit to explicit files after reviewing `git diff` |
+| `git checkout -- .` | Legacy broad revert of tracked files | Prefer explicit `git restore -- <file>` with approval |
+| `git branch -D <branch>` | Deletes an unmerged branch ref | Check merge state and remote backup first |
+| `git push --force` / `git push -f` | Rewrites remote history | Use only with explicit approval and protected-branch checks |
+
+## Preflight Checklist
+
+1. Run `git status --short` and identify tracked, untracked, and ignored files separately.
+2. Preserve useful changes with a commit, patch, stash, or copied artifact before cleanup.
+3. For branch deletion, run `git branch --merged` and check whether the branch exists on a remote.
+4. For release branches, check that a local `release` branch does not block the `release/v*` namespace.
+5. State the exact target and recovery path before running the command.
+
+## Recovery Checklist
+
+1. Stop further destructive git commands.
+2. Inspect `git reflog` for the prior `HEAD`.
+3. Use `git status --short` and `git diff` to identify current loss scope.
+4. Recover tracked changes from the reflog or saved patch.
+5. Recover untracked files only from backups, editor history, or generated artifacts.
+
+## Agent Workflow Rules
+
+- Verification agents must not clean the worktree to create a baseline.
+- Git specialists should commit or otherwise preserve implemented changes before deep verification.
+- Release workflows must prefer branch rename over forced deletion when a local `release` branch blocks `release/v*`.
+- Advisory hooks are evidence, not permission. A warning still requires the R001 approval path before continuing.
+
+## See Also
+
+- `.codex/rules/MUST-safety.md`
+- `.codex/hooks/scripts/destructive-git-guard.sh`
+- `.codex/agents/mgr-gitnerd.md`
+- `guides/git-worktree-workflow/README.md`

package/templates/guides/index.yaml

@@ -278,6 +278,12 @@ guides:
     source:
       type: internal
 
+  - name: git-safety
+    description: Destructive git command preflight, recovery, and release branch namespace guardrails
+    path: ./git-safety/
+    source:
+      type: internal
+
   # Architecture
   - name: skill-bundle-design
     description: Domain skill bundle design patterns for Author/Test/Troubleshoot tri-pattern

package/templates/manifest.json

@@ -1,11 +1,11 @@
 {
-  "version": "0.4.17",
+  "version": "0.5.1",
   "requiresCC": ">=2.1.121",
   "claudeCode": {
     "minimumVersion": "2.1.121",
     "protectedPathBypassVersion": "2.1.126"
   },
-  "lastUpdated": "2026-04-28T00:01:33.302Z",
+  "lastUpdated": "2026-05-19T00:00:00.000Z",
   "components": [
     {
       "name": "rules",
@@ -23,13 +23,13 @@
       "name": "skills",
       "path": ".agents/skills",
       "description": "Reusable skill modules (project-scoped repo skills)",
-      "files": 118
+      "files": 123
     },
     {
       "name": "guides",
       "path": "guides",
       "description": "Reference documentation",
-      "files": 47
+      "files": 48
     },
     {
       "name": "hooks",