# Workflow Compatibility Audit

Reference workflow snapshot:
`3fb8802e314dc0a1f23481dd3782cdca26b92dc2`.

This document tracks the reference workflow 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.

## Workflow Parity Matrix

| Reference workflow category | LazyClaude target | Status | Reason / acceptance signal |
| --- | --- | --- | --- |
| review-work 5-lane orchestration | `commands/review-work.md`, `skills/review-work`, `agents/quality-reviewer.md`, `agents/oracle-verifier.md`, `agents/qa-runner.md`, `agents/librarian-researcher.md` | Implemented | `review-work` is the v0.2.0 workflow parity 5-lane review route: scout / skeptic / implementer / edge-case / decision ledger discipline is represented as goal/constraint verification, hands-on QA execution, code quality, security, and local-first context mining with an aggregate verdict. |
| ultragoal state/runtime | `commands/ultragoal.md`, `skills/ultragoal`, `plugins/lazyclaude/lib/ultragoal/`, `.omo/ultragoal/`, `bin/lazyclaude-ai.js ultragoal ...` commands | Implemented | `ultragoal` now has durable state, ledger, checkpoint, steering, quality gate, and review blocker commands through `lazyclaude ultragoal create-goals`, `record-evidence`, `checkpoint`, `steer`, and `record-review-blockers`. |
| ULW/start-work discipline | `commands/ulw-loop.md`, `commands/ulw-plan.md`, `commands/start-work.md`, `skills/ulw-loop`, `skills/ulw-plan`, `skills/start-work` | Implemented | Existing ULW/start-work surfaces require plan reading, ledger updates, publish boundary checks, verification, manual QA artifacts, cleanup receipts, resume checkpoints, and evidence artifacts. |
| hook trigger safety | `hooks/hooks.json`, `bin/lazyclaude-hook.js`, `test/hooks.test.mjs`, `docs/hooks.md` | Implemented | Hooks use `UserPromptSubmit` trigger detection, exact workflow aliases, near-miss fixtures, prompt injection safe context, and no auto-type behavior for slash commands. |
| agent/command routing | `agents/*.md`, `commands/*.md`, `.claude-plugin/plugin.json`, command discovery tests | Implemented | Agents and commands route planner, executor, verifier, reviewer, librarian, and QA responsibilities into Claude Code surfaces, including review-work and ultragoal command files. |
| docs/package payload | `README.md`, `README_ko-KR.md`, `docs/*.md`, `package.json`, `.claude-plugin/plugin.json`, `test/workspace-hygiene.test.mjs` | Implemented | Docs, package payload, manifest, install metadata, and package allowlist are covered by tests; v0.2.0 docs describe local parity without implying publish completion. |
| excluded/deferred telemetry | No runtime telemetry package; docs omission note | Omitted | Telemetry is omitted and any network telemetry remains deferred by reason: LazyClaude should stay local and quiet unless the user explicitly requests an observable reporting feature. |

## 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/deep-interview.md`, `commands/start-work.md` | UserPromptSubmit detects workflow 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 | `commands/ultragoal.md`, `skills/ultragoal`, `plugins/lazyclaude/lib/ultragoal/`, `ulw-*`, `start-work` goal guidance | Claude-native goal wording with evidence/ledger/quality-gate discipline and durable CLI state. |
| 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. |
| clarification interview | `commands/deep-interview.md`, `skills/deep-interview` | Socratic requirements mode with ambiguity scoring, persisted state, and a handoff to planning/execution. |
| 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`
- `review-work`
- `ultragoal`
- `ulw-loop`
- `ulw-plan`

## v0.2.0 Operator Contract

The v0.2.0 workflow parity documentation is intentionally local-first. It does
not claim npm publication, remote marketplace registration, or public promotion.
The publish boundary remains explicit user approval, and uninstall remains
limited to LazyClaude-managed state.

Review work uses a 5-lane review: goal/constraint verification, hands-on QA
execution, code quality, security, and local-first context mining. Manual-QA
channels must leave artifacts and a cleanup receipt. Ultragoal state is managed
with:

```bash
lazyclaude ultragoal create-goals --brief "<brief>" --json
lazyclaude ultragoal record-evidence --criterion <id> --status pass --json '{"artifact":"...","cleanup":"..."}'
lazyclaude ultragoal checkpoint --status active --note "<progress>" --json
lazyclaude ultragoal steer --kind scope --note "<what changed and why>" --json
```

Current docs/test reads override stale state during audits. Prompt text is not
executed or echoed, and malformed input should produce a controlled error.

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. Non-Claude
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 reference workflow 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.
