ucai CLAUDE.md

Ucai — Use Claude Code As Is

Overview

A Claude Code plugin that leverages native architecture — commands, agents, hooks, and skills — exactly as Anthropic designed them. v2.3 adds discipline layers on top of v2.2's enforcement engine: pre-flight requirement audits before code is written, per-issue failure-mode analysis on every review, design-pivot clauses, and strict author/reviewer separation for tests with anti-gaming verdicts aligned with the Pragma detector. v2.2 added the never-forget enforcement engine — programmatic phase enforcement via ContingencyEngine with dependencies, logic gates, shadow tasks, and audit trail. v2.0 added autonomous execution — /ship (zero-gate spec-to-PR pipeline), /bootstrap (infrastructure scaffolding), PostToolUse auto-formatting, deterministic test execution, and lessons consolidation. Built on the Cherny methodology: persistent task tracking, self-improvement loop, TDD integration, and elegance checkpoints.

Tech Stack

• Runtime: Node.js 18+ (CommonJS, zero external dependencies)
• Plugin format: Markdown (YAML frontmatter) + JSON configs
• Platform: Windows/Linux/macOS, CI matrix: Node 18 × 20 on ubuntu + windows

Development Commands

No build step. Validation only:

# Local dev
claude --plugin-dir ./ucai

# JSON syntax
node -e "JSON.parse(require('fs').readFileSync('.claude-plugin/plugin.json', 'utf8'))"
node -e "JSON.parse(require('fs').readFileSync('hooks/hooks.json', 'utf8'))"
node -e "JSON.parse(require('fs').readFileSync('.claude-plugin/marketplace.json', 'utf8'))"

# JS syntax (all handlers + scripts)
for file in hooks/handlers/*.js scripts/*.js; do node -c "$file" || exit 1; done

# Smoke test
output=$(node hooks/handlers/sessionstart-handler.js)
node -e "const o=JSON.parse(process.argv[1]); if(!o.hookSpecificOutput) process.exit(1)" "$output"

Architecture

Layers

• commands/ — Orchestration: phased workflows with user approval gates. Write/Edit only here.
• agents/ — Execution: read-only analysis workers, spawned in parallel via Task tool.
• hooks/handlers/ — Lifecycle: context injection, state management, config protection.
• skills/ — Knowledge: progressive disclosure domain expertise, loaded on-demand.
• scripts/ — Utilities: setup-ship.js, detect-infra.js, run-tests.js, consolidate-lessons.js.
• scripts/lib/never-forget/ — Vendored never-forget engine (ESM, zero deps): dependency validation, logic gates, shadow tasks, audit trail.