litclaude-ai 0.3.20 → 0.3.22

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # Changelog
 
+## 0.3.22 - 2026-07-07 — full lit-family bare invocation release prep
+
+- Prepare `litclaude-ai@0.3.22` for npm publication after extending bare lit-family prompt-hook routes to inject the installed `SKILL.md` body.
+- Keep the safe natural-language `lit start work` BLOCKED handoff while explicit bare skill routes carry full prompt context.
+
+## 0.3.21 - 2026-07-07 — full bare skill-body routing
+
+- Inject bundled `SKILL.md` bodies for bare `hyperplan`, `litresearch`, `lit research`, `init-deep`, and explicit `$start-work` prompt-hook routes so activation carries the same substantive skill contract as the installed payload.
+- Add `/litclaude:init-deep` command coverage while preserving slash-command, code-span, fenced-code, near-miss, and natural-language `lit start work` BLOCKED handoff guards.
+
+## 0.3.20 - 2026-07-07 — bare hyperplan prompt routing
+
+- Route bare `hyperplan` prompts into the planning-only Hyperplan surface while preserving slash-command, code-span, fenced-code, and near-miss trigger guards.
+- Align README release badges, install examples, and release wording with the published `litclaude-ai@0.3.20` package.
+
 ## 0.3.19 - 2026-07-05 — hyperplan adversarial planning skill
 
 - Add the `hyperplan` skill for planning-only adversarial critique before implementation: independent read-only lanes, cross-review, defense/refinement, surviving insight bundle, and `lit-plan` handoff.

package/README.md

@@ -9,7 +9,7 @@
 </p>
 <p align="center">
   <img src="https://img.shields.io/badge/npm-litclaude--ai-cb3837" />
-  <img src="https://img.shields.io/badge/version-0.3.19-2ea44f" />
+  <img src="https://img.shields.io/badge/version-0.3.22-2ea44f" />
   <img src="https://img.shields.io/badge/Claude%20Code-plugin-blueviolet" />
   <img src="https://img.shields.io/badge/license-MIT-blue" />
 </p>
@@ -22,12 +22,13 @@
 > `litclaude@litclaude-ai`, so normal `claude` launches can load the
 > LitClaude skills and hooks without a long `--plugin-dir` command.
 
-This checkout is prepared as `litclaude-ai@0.3.19` for personal install
+This checkout is prepared as `litclaude-ai@0.3.22` for personal install
 convenience. The repo can remain quiet; preparing npm package metadata here does
 not imply public repo promotion, marketplace publication, or advertisement.
-Future package releases still require explicit user approval. The v0.3.19
-release materials add the planning-only `hyperplan` adversarial planning skill while
-preserving the v0.3.18 read-only `lit-recap` session recap surface, the v0.3.17 separate-worker native `/goal` launcher, the v0.3.16
+Future package releases still require explicit user approval. The v0.3.22
+release materials inject the bundled skill bodies for bare `hyperplan`,
+`litresearch`, `lit research`, `init-deep`, and explicit `$start-work` prompt-hook routes while
+preserving the v0.3.19 adversarial planning skill, the v0.3.18 read-only `lit-recap` session recap surface, the v0.3.17 separate-worker native `/goal` launcher, the v0.3.16
 WSL2/Windows Terminal truecolor HUD gradient fix, the v0.3.15 Korean AI slop
 remover workflow, the v0.3.13 public-source reader runtime, litresearch
 activation/read-only polish, and installer permission-preference discipline.
@@ -112,7 +113,7 @@ directory, the normal install command works:
 
 ```bash
 cd /tmp
-npx --yes litclaude-ai@0.3.19 install
+npx --yes litclaude-ai@0.3.22 install
 ```
 
 Validate the installed plugin:
@@ -125,7 +126,7 @@ The installer also sets Claude Code's `statusLine` command to the packaged
 LitClaude HUD. A typical no-color render starts like:
 
 ```text
-[🔥LITCLAUDE v0.3.19] | O4.8 │ ctx [▎░░] 9%/1000k │ 5h [▏░] 4% ↻2h15m │ 1w [▊░] 35% ↻3d6h │ git main +3 ✓
+[🔥LITCLAUDE v0.3.22] | O4.8 │ ctx [▎░░] 9%/1000k │ 5h [▏░] 4% ↻2h15m │ 1w [▊░] 35% ↻3d6h │ git main +3 ✓
 ```
 
 The `↻` suffix is a compact rate-limit reset countdown. It is separated from

package/README_ko-KR.md

@@ -9,7 +9,7 @@
 </p>
 <p align="center">
   <img src="https://img.shields.io/badge/npm-litclaude--ai-cb3837" />
-  <img src="https://img.shields.io/badge/version-0.3.19-2ea44f" />
+  <img src="https://img.shields.io/badge/version-0.3.22-2ea44f" />
   <img src="https://img.shields.io/badge/Claude%20Code-plugin-blueviolet" />
   <img src="https://img.shields.io/badge/license-MIT-blue" />
 </p>
@@ -26,13 +26,14 @@
 > 설치되므로, 매번 긴 `--plugin-dir` 없이 일반 `claude` 실행에서
 > LitClaude skill과 hook을 불러올 수 있습니다.
 
-현재 checkout은 `litclaude-ai@0.3.19` 배포 준비용으로 정리되어 있습니다. 목적은
+현재 checkout은 `litclaude-ai@0.3.22` 배포 준비용으로 정리되어 있습니다. 목적은
 다른 PC에서도 빠르게 설치하기 위한 개인용 package metadata를 갖추는 것입니다.
 npm package metadata를 준비했다고 해서 홍보, 공개 저장소 운영, Claude
 marketplace 등록을 의미하지는 않습니다. 새 버전 배포는 항상 별도의 명시적
-승인 후에 진행합니다. v0.3.19 release material은 planning-only `hyperplan`
-adversarial planning skill을 추가하면서, v0.3.18 read-only `lit-recap`
-session recap surface와 v0.3.17 별도 worker 기반 native `/goal`
+승인 후에 진행합니다. v0.3.22 release material은 bare `hyperplan`,
+`litresearch`, `lit research`, `init-deep`, explicit `$start-work` prompt-hook route에
+bundled skill body를 주입하면서, v0.3.19 adversarial planning
+skill, v0.3.18 read-only `lit-recap` session recap surface, v0.3.17 별도 worker 기반 native `/goal`
 launcher와 v0.3.16 WSL2/Windows Terminal truecolor HUD gradient fix, v0.3.15
 Korean AI slop remover workflow, v0.3.13 public-source reader runtime,
 litresearch activation/read-only polish를 유지합니다.
@@ -116,7 +117,7 @@ checkout을 먼저 해석해서 `sh: litclaude-ai: command not found`로 실패
 
 ```bash
 cd /tmp
-npx --yes litclaude-ai@0.3.19 install
+npx --yes litclaude-ai@0.3.22 install
 ```
 
 설치 상태를 확인합니다.
@@ -129,7 +130,7 @@ installer는 Claude Code의 `statusLine` command도 packaged LitClaude HUD로
 설정합니다. 색상을 제거한 예시는 다음처럼 시작합니다.
 
 ```text
-[🔥LITCLAUDE v0.3.19] | O4.8 │ ctx [▎░░] 9%/1000k │ 5h [▏░] 4% ↻2h15m │ 1w [▊░] 35% ↻3d6h │ git main +3 ✓
+[🔥LITCLAUDE v0.3.22] | O4.8 │ ctx [▎░░] 9%/1000k │ 5h [▏░] 4% ↻2h15m │ 1w [▊░] 35% ↻3d6h │ git main +3 ✓
 ```
 
 `↻` 표시는 rate-limit reset까지 남은 시간을 짧게 보여주는 countdown입니다.

package/RELEASE_CHECKLIST.md

@@ -1,7 +1,7 @@
 # LitClaude Release Checklist
 
-Status: `litclaude-ai@0.3.19` is the current release candidate — a planning-only
-`hyperplan` adversarial planning skill on top of the read-only `lit-recap`
+Status: `litclaude-ai@0.3.22` is the current release candidate — a full bare
+skill-body prompt-hook routing release on top of the planning-only Hyperplan skill and read-only `lit-recap`
 session recap surface (command, skill, and bounded hook routing
 including the Korean `리캡` trigger), the dry-run-first native `/goal`
 worker launcher, WSL2 HUD gradient hotfix, Korean AI-slop removal workflow
@@ -12,9 +12,9 @@ side-effect-free, the launcher starts only a separate Claude Code
 print/background worker, and the release preserves the Korean polishing
 command, strict multi-agent review pipeline, fidelity guardrails, package
 hygiene checks, native route gates, and safe start-work handoff behavior.
-`package.json` is aligned to `0.3.19`,
-`plugins/litclaude/.claude-plugin/plugin.json` is aligned to `0.3.19`, and the
-plugin-local MCP server reports `0.3.19`.
+`package.json` is aligned to `0.3.22`,
+`plugins/litclaude/.claude-plugin/plugin.json` is aligned to `0.3.22`, and the
+plugin-local MCP server reports `0.3.22`.
 
 This release carries the v0.2.2 Dynamic workflow hardening surfaces:
 `/dynamic-workflow`, `workflow-check --json`, native `/goal` fallback guidance,
@@ -63,9 +63,10 @@ No npm publication is required for this track.
 Before requesting publication approval, confirm these artifacts from the current
 checkout:
 
-- `package.json` version is `0.3.19`.
-- `plugins/litclaude/.claude-plugin/plugin.json` version is `0.3.19`.
-- `plugins/litclaude/bin/litclaude-mcp.js` reports server version `0.3.19`.
+- `package.json` version is `0.3.22`.
+- `plugins/litclaude/.claude-plugin/plugin.json` version is `0.3.22`.
+- `plugins/litclaude/bin/litclaude-mcp.js` reports server version `0.3.22`.
+- Prompt-hook tests cover bundled `SKILL.md` body injection for bare `hyperplan`, `litresearch`, `lit research`, `init-deep`, and explicit `$start-work`, while natural-language `lit start work` stays BLOCKED.
 - `lit search` and `lit query` route to `/litclaude:litresearch` without activating on slash mentions, code spans, or non-lit prompts.
 - Litresearch web lanes require public API/feed preference, validator-first checks, route traces, prompt-injection quarantine, and honest auth/paywall/private-data stop reasons.
 - `node bin/litclaude-ai.js public-read <public-url> --json` exposes the guarded JS runtime reader.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "litclaude-ai",
-  "version": "0.3.20",
+  "version": "0.3.22",
   "description": "Claude Code-native workflow distribution.",
   "type": "module",
   "bin": {

package/plugins/litclaude/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "litclaude",
   "description": "Claude Code-native workflow plugin.",
-  "version": "0.3.20",
+  "version": "0.3.22",
   "author": {
     "name": "LitClaude contributors"
   },

package/plugins/litclaude/bin/litclaude-hook.js

@@ -48,17 +48,18 @@ const plainWordBoundary = /^[A-Za-z0-9]$/u;
 const compoundWordBoundary = /^[A-Za-z0-9_-]$/u;
 
 const triggerByToken = {
-  "deep-interview": { command: "/litclaude:deep-interview", skill: "Skill(deep-interview)", discipline: "deep-interview" },
-  "dynamic-workflow": { command: "/litclaude:dynamic-workflow", skill: "Skill(lit-loop)", discipline: "dynamic-workflow" },
-  "agent-team": { command: "/litclaude:lit-loop", skill: "Skill(lit-loop)", discipline: "agent-team" },
-  hyperplan: { command: "/litclaude:lit-plan", skill: "Skill(hyperplan)", discipline: "lit-plan" },
-  "lit-plan": { command: "/litclaude:lit-plan", skill: "Skill(lit-plan)", discipline: "lit-plan" },
-  "lit-recap": { command: "/litclaude:lit-recap", skill: "Skill(lit-recap)", discipline: "lit-recap" },
-  "lit-loop": { command: "/litclaude:lit-loop", skill: "Skill(lit-loop)", discipline: "lit-loop" },
-  "start-work": { command: "/litclaude:start-work", skill: "Skill(start-work)", discipline: "start-work" },
-  "review-work": { command: "/litclaude:review-work", skill: "Skill(review-work)", discipline: "review-work" },
-  litgoal: { command: "/litclaude:litgoal", skill: "Skill(litgoal)", discipline: "litgoal" },
-  litresearch: { command: "/litclaude:litresearch", skill: "Skill(litresearch)", discipline: "litresearch" },
+  "deep-interview": { command: "/litclaude:deep-interview", skill: "Skill(deep-interview)", skillId: "deep-interview", discipline: "deep-interview" },
+  "dynamic-workflow": { command: "/litclaude:dynamic-workflow", skill: "Skill(lit-loop)", skillId: "lit-loop", discipline: "dynamic-workflow" },
+  "agent-team": { command: "/litclaude:lit-loop", skill: "Skill(lit-loop)", skillId: "lit-loop", discipline: "agent-team" },
+  hyperplan: { command: "/litclaude:lit-plan", skill: "Skill(hyperplan)", skillId: "hyperplan", discipline: "lit-plan" },
+  "init-deep": { command: "/litclaude:init-deep", skill: "Skill(init-deep)", skillId: "init-deep", discipline: "init-deep" },
+  "lit-plan": { command: "/litclaude:lit-plan", skill: "Skill(lit-plan)", skillId: "lit-plan", discipline: "lit-plan" },
+  "lit-recap": { command: "/litclaude:lit-recap", skill: "Skill(lit-recap)", skillId: "lit-recap", discipline: "lit-recap" },
+  "lit-loop": { command: "/litclaude:lit-loop", skill: "Skill(lit-loop)", skillId: "lit-loop", discipline: "lit-loop" },
+  "start-work": { command: "/litclaude:start-work", skill: "Skill(start-work)", skillId: "start-work", discipline: "start-work" },
+  "review-work": { command: "/litclaude:review-work", skill: "Skill(review-work)", skillId: "review-work", discipline: "review-work" },
+  litgoal: { command: "/litclaude:litgoal", skill: "Skill(litgoal)", skillId: "litgoal", discipline: "litgoal" },
+  litresearch: { command: "/litclaude:litresearch", skill: "Skill(litresearch)", skillId: "litresearch", discipline: "litresearch" },
 };
 
 const modeContracts = {
@@ -69,11 +70,27 @@ const modeContracts = {
   "review-work": "Mode contract: review-work runs a five-lane review: goal/constraints, real-surface QA, code quality, security, and docs/package/context readiness. PASS requires evidence from every applicable lane.",
   litresearch: "Mode contract: litresearch uses sourced evidence, separates verified facts from hypotheses, keeps a route trace for search/query lanes, cites the search/runtime surface used, and reports residual uncertainty. If the user asks for read-only or no-write research, ask before writing local journal files and use transcript-only tracking unless they approve disk writes.",
   litgoal: "Mode contract: litgoal binds one outcome-shaped objective plus checkable criteria, each with scenario, real surface, and observable evidence.",
+  "init-deep": "Mode contract: init-deep creates or refreshes sparse AGENTS.md guidance after reading existing guidance and real repo structure. Preserve local instructions and user changes; create child files only where directory-specific conventions justify them.",
   "deep-interview": "Mode contract: deep-interview clarifies vague requirements before planning or implementation, without inventing acceptance criteria.",
   "dynamic-workflow": "Mode contract: dynamic-workflow is opt-in orchestration for broad, risky, parallel, or long-running work; propose it first and only call Workflow after user opt-in or existing session permission.",
   "agent-team": "Mode contract: agent-team is setup-gated native Claude Code teammate orchestration. Spawn teammates only when experimental teams are enabled and the user approves roles, scope boundaries, acceptance criteria, wait, and synthesis instructions.",
 };
 
+const staticSkillBodyContext = ({ skillId, safetyBlock }) => {
+  if (!skillId || safetyBlock) return [];
+  try {
+    const body = readFileSync(new URL(`../skills/${skillId}/SKILL.md`, import.meta.url), "utf8").trim();
+    if (!body) return [];
+    return [
+      `<litclaude-skill-body name="${skillId}">
+${body}
+</litclaude-skill-body>`,
+    ];
+  } catch {
+    return [`WARNING: Skill(${skillId}) was requested, but the bundled SKILL.md body could not be loaded from the LitClaude plugin payload.`];
+  }
+};
+
 const withoutCode = (text) => text.replace(/```[\s\S]*?```/gu, " ").replace(/`[^`]*`/gu, " ");
 const rawTriggerText = (text) => withoutCode(text).toLowerCase();
 const normalizedTriggerText = (text) => rawTriggerText(text).replace(/[_-]+/gu, " ");
@@ -106,11 +123,13 @@ const slashCommandMentions = [
   "/dynamic-workflow",
   "/goal",
   "/hyperplan",
+  "/init-deep",
   "/lit-loop",
   "/lit-plan",
   "/lit-recap",
   "/litclaude:deep-interview",
   "/litclaude:dynamic-workflow",
+  "/litclaude:init-deep",
   "/litclaude:lit-loop",
   "/litclaude:lit-plan",
   "/litclaude:lit-recap",
@@ -136,11 +155,17 @@ const slashLitPhrasePattern = /(^|\s)\/lit(?:work)?\s+(?:plan|recap|review|resea
 const containsSlashCommandMention = (text) => slashCommandMentionPattern.test(text) || slashLitPhrasePattern.test(text);
 
 const findDollarCommandTrigger = (raw) => {
-  const match = /(?:^|\s)\$(deep-interview|dynamic-workflow|lit-plan|lit-recap|lit-loop|start-work|review-work|litgoal|litresearch)(?=$|[^\w-])/u.exec(raw);
+  const match = /(?:^|\s)\$(deep-interview|dynamic-workflow|init-deep|lit-plan|lit-recap|lit-loop|start-work|review-work|litgoal|litresearch)(?=$|[^\w-])/u.exec(raw);
   if (!match) return undefined;
   return { ...triggerByToken[match[1]], source: "dollar-command" };
 };
 
+const findLeadingBareCommandTrigger = (raw) => {
+  const match = /^\s*(deep-interview|init-deep|lit-plan|lit-recap|lit-loop|start-work|review-work|litgoal|litresearch)(?=$|[^\w-])/u.exec(raw);
+  if (!match) return undefined;
+  return { ...triggerByToken[match[1]], source: "bare-command" };
+};
+
 const hasLitTrigger = (raw) => containsCompoundBoundedWord(raw, "lit") || containsCompoundBoundedWord(raw, "litwork");
 
 const hangulSyllable = /^[가-힣]$/u;
@@ -192,7 +217,10 @@ const findWorkflowTrigger = (prompt) => {
   const dollarTrigger = findDollarCommandTrigger(raw);
   if (dollarTrigger) return dollarTrigger;
   if (containsSlashCommandMention(raw)) return undefined;
+  const bareCommandTrigger = findLeadingBareCommandTrigger(raw);
+  if (bareCommandTrigger) return bareCommandTrigger;
   if (containsCompoundBoundedWord(raw, "hyperplan")) return { ...triggerByToken.hyperplan, source: "bare-command" };
+  if (containsCompoundBoundedWord(raw, "init-deep")) return { ...triggerByToken["init-deep"], source: "bare-command" };
   const recapTrigger = findRecapTrigger(raw);
   if (recapTrigger) return recapTrigger;
   return findNaturalLitTrigger(prompt);
@@ -230,15 +258,16 @@ const teamGateContext = (discipline) => {
   return ["Native agent team setup gate: CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 is not set, so do not claim a teammate launch. To enable native teams, launch with `CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS=1 claude --teammate-mode auto` or set `env.CLAUDE_CODE_EXPERIMENTAL_AGENT_TEAMS` plus optional `teammateMode: auto`; fallback to subagent delegation or Dynamic workflow meanwhile."];
 };
 
-const recapContext = ({ command, skill, discipline, source }) => [
+const recapContext = ({ command, skill, skillId, discipline, source }) => [
   `Treat this prompt as an explicit request to use LitClaude ${discipline} discipline now; load or follow ${command} / ${skill} semantics before ordinary task execution.`,
   modeContracts[discipline],
   "Read-only recap surfaces: read .litclaude/litgoal/goals.json, .litclaude/litgoal/ledger.jsonl, and .litclaude/litgoal/brief.md when present (plus repo-level evidence/ paths), and combine them with current-session context. The read-only `litclaude-ai litgoal status --json` and `criteria` subcommands are the only litgoal CLI reads allowed.",
   "Output contract: reply in Korean by default using the fixed lit-recap headers from Skill(lit-recap); switch the body to English only when the user asks (--en / in English / 영어); produce the brief `## ⚡ 요약` digest on --brief / 짧게; keep technical tokens (paths, commands, identifiers) verbatim.",
   `Activation source: ${source ?? "legacy"}. Slash commands and slash-command mentions are handled by Claude Code's native command surface and do not activate this prompt hook. Code spans, code fences, substrings, and compound tokens are ignored. Secret-bearing prompt material is never persisted raw; recap output may only reference redacted summaries and evidence paths.`,
+  ...staticSkillBodyContext({ skillId }),
 ].join(" ");
 
-const litworkContext = ({ command, skill, discipline, softConfirm, safetyBlock, source }, input) => [
+const litworkContext = ({ command, skill, skillId, discipline, softConfirm, safetyBlock, source }, input) => [
   ...(safetyBlock
     ? ["BLOCKED: Natural-language start-work activation cannot switch the active Claude Code agent. Run `/start-work` (or `/litclaude:start-work`) with the approved plan so Claude Code can use the correct execution surface; do not continue implementation from this prompt hook."]
     : []),
@@ -258,6 +287,7 @@ const litworkContext = ({ command, skill, discipline, softConfirm, safetyBlock,
   "Dynamic worktree integration: when Claude Code exposes EnterWorktree and isolated edits are needed, use EnterWorktree for the selected lane; otherwise use or recommend claude --worktree <short-name> --tmux. Never mutate unrelated user state.",
   "Subagent delegation: route planning to litclaude:prometheus-planner, implementation to litclaude:boulder-executor, verification to litclaude:oracle-verifier, hands-on QA to litclaude:qa-runner, code/security review to litclaude:quality-reviewer, and local-first research to litclaude:librarian-researcher when Claude Code subagents or Dynamic workflow lanes are available. LitClaude subagents are exposed under the litclaude: namespace, so pass the exact namespaced id (e.g. litclaude:boulder-executor) as the Agent/Task tool subagent_type, not the bare name.",
   "Subagent reliability: each child assignment starts with TASK: and includes DELIVERABLE, SCOPE, and VERIFY; use short wait cycles, treat timeouts as no-update signals, and fallback only after a missing deliverable, acknowledgement-only reply, or BLOCKED: report.",
+  ...staticSkillBodyContext({ skillId, safetyBlock }),
   ...(softConfirm ? ["Soft-confirm: the bare keyword 'lit' activated this hook. Before committing to the full lit-loop, briefly confirm with the user that they intended to start a litwork execution loop (a stray English 'lit' is recoverable)."] : []),
 ].join(" ");
 

package/plugins/litclaude/bin/litclaude-mcp.js

@@ -3,7 +3,7 @@
 import { readPublicSource } from "../lib/public-source-reader/reader.mjs";
 
 const protocolVersion = "2024-11-05";
-const serverVersion = "0.3.20";
+const serverVersion = "0.3.22";
 
 const publicSourceReadTool = {
   name: "public_source_read",

package/plugins/litclaude/commands/init-deep.md

@@ -0,0 +1,19 @@
+---
+description: Create or refresh sparse AGENTS.md guidance with the LitClaude init-deep discipline.
+argument-hint: '[--create-new] [--max-depth=N]'
+---
+
+Use the `init-deep` skill for repository guidance initialization.
+
+Read existing `AGENTS.md`, `CLAUDE.md`, README files, package manifests,
+handoffs, and the real directory structure before proposing edits. Preserve local
+instructions, secrets boundaries, ignored runtime state, and user changes.
+
+Only create child `AGENTS.md` files where a directory has distinct conventions,
+entry points, test/build commands, or ownership rules future agents would
+otherwise rediscover. Keep each file concise: what differs from the parent,
+where to look, what not to touch, and which commands verify changes.
+
+Before editing, state success criteria and choose the minimum-first guidance
+hierarchy that satisfies them. After editing, report files created, files
+updated, directories skipped, evidence used, and verification commands.