# Workflow Compatibility Audit

Private reference snapshot:
`3fb8802e314dc0a1f23481dd3782cdca26b92dc2`.

This document tracks the private reference surfaces checked during the deeper
LazyClaude compatibility pass. The goal is to keep future updates honest: if the
reference grows a new user-facing skill, hook, or runtime behavior, this map should
make the missing LazyClaude target obvious.

## Runtime Concepts

| Reference surface | LazyClaude target | Status |
| --- | --- | --- |
| prompt activation | `hooks/hooks.json`, `bin/lazyclaude-hook.js`, `commands/ulw-loop.md`, `commands/ulw-plan.md`, `commands/start-work.md` | UserPromptSubmit detects ULW triggers and injects compact Claude Code guidance. |
| comment-checker | `skills/comment-checker`, `PostToolUse` hook guidance | Claude-native comment hygiene skill plus post-edit reminder. |
| lsp | `.lsp.json`, `.mcp.json`, `bin/lazyclaude-lsp-doctor.js`, `skills/lsp` | Lightweight Claude Code LSP/MCP helper rather than vendoring a full external package. |
| rules | `skills/rules`, `SessionStart` / `PostCompact` hook behavior | Claude session rule guidance and cache-reset messaging. |
| ultragoal | `skills/ultragoal`, `ulw-*`, `start-work` goal guidance | Claude-native goal wording with evidence/ledger/quality-gate discipline. |
| ultrawork | `commands/ulw-loop.md`, `commands/ulw-plan.md`, `skills/ulw-loop`, `skills/ulw-plan` | Claude skills, commands, agents, workflow/worktree guidance, and hook injection. |
| agents | `agents/*.md` | Planner, executor, verifier, reviewer, librarian, and QA runner roles. |
| mcp | `.mcp.json`, `bin/lazyclaude-mcp.js` | Plugin-local stdio helper surface. |
| install metadata | `bin/lazyclaude-ai.js`, `.claude-plugin/plugin.json`, local marketplace metadata | Installer writes Claude user plugin registry and LazyClaude-owned local marketplace records. |
| telemetry | No runtime telemetry | Intentionally omitted as network telemetry. LazyClaude remains quiet/local by default. |

## Skill Corpus

LazyClaude includes the compatibility skill corpus:

- `ai-slop-remover`
- `comment-checker`
- `debugging`
- `frontend-ui-ux`
- `lsp`
- `programming`
- `refactor`
- `remove-ai-slops`
- `review-work`
- `rules`
- `ultragoal`

LazyClaude now ships those names or Claude-native equivalents, plus LazyClaude
workflow additions:

- `start-work`
- `ulw-loop`
- `ulw-plan`

The original `ai-slop-remover` command-facing name is preserved as an
alias-style skill so older operator muscle memory still has a matching Claude
surface. `remove-ai-slops` remains the broader LazyClaude cleanup skill.

## Auxiliary Packs

The deeper workflow skills rely on files beyond `SKILL.md`. LazyClaude now
packages the high-value portable auxiliary packs:

- `programming/references`
- `programming/scripts`
- `debugging/references`

These packs carry language/runtime-specific guidance for TypeScript, Python,
Rust, Go, debugging methodology, runtime probes, and tool usage. OpenCode-only
coordination examples in the debugging references were rewritten as Claude
workflow/subagent pseudocode so they do not instruct Claude Code to call missing
tools literally.

## Deliberate Omissions

The following private reference content was audited but not copied into the
runtime package:

- Web/landing app: not part of the Claude Code plugin runtime.
- GitHub Actions and npm publish workflows: this repository uses manual user
  publication.
- Telemetry network component: omitted to keep LazyClaude local and quiet.
- Full component TypeScript packages for rules/comment-checker/LSP/ultragoal:
  represented by Claude-native hook/skill/MCP/LSP surfaces where portable, not
  vendored wholesale.

If any of those become desired runtime features, they should be introduced with
their own tests and explicit user approval.
