luciazero 2.4.2 → 2.4.3

package/README.md

@@ -2,29 +2,68 @@
   <img src="https://cdn.jsdelivr.net/gh/ohm41321/luciazero@37cb470e2b7c704ff32f3a46dbb125e312875960/docs/assets/lucia.png" width="220" alt="Lucia — Luciazero's mascot">
   <h1>Luciazero</h1>
   <p>
-    <strong>Evidence-first discipline for coding agents.</strong><br>
+    <strong>Make coding agents prove their work.</strong><br>
     <code>plan → change → verify → fix</code>
   </p>
   <p>
     <a href="https://www.npmjs.com/package/luciazero"><img src="https://img.shields.io/npm/v/luciazero" alt="npm version"></a>
+    <a href="https://www.npmjs.com/package/luciazero"><img src="https://img.shields.io/npm/dw/luciazero" alt="npm weekly downloads"></a>
     <a href="https://github.com/ohm41321/luciazero/actions/workflows/ci.yml"><img src="https://github.com/ohm41321/luciazero/actions/workflows/ci.yml/badge.svg" alt="CI status"></a>
+    <a href="https://github.com/ohm41321/luciazero/stargazers"><img src="https://img.shields.io/github/stars/ohm41321/luciazero?style=flat" alt="GitHub stars"></a>
+    <a href="https://github.com/ohm41321/luciazero/network/members"><img src="https://img.shields.io/github/forks/ohm41321/luciazero?style=flat" alt="GitHub forks"></a>
     <a href="https://github.com/ohm41321/luciazero/blob/main/LICENSE"><img src="https://img.shields.io/github/license/ohm41321/luciazero" alt="MIT license"></a>
   </p>
 </div>
 
 **English** · [ภาษาไทย](https://github.com/ohm41321/luciazero/blob/main/README.th.md)
 
-Luciazero is a lightweight discipline layer for coding agents. It works with
-Claude Code, Codex CLI, and compatible skill runtimes through plugin, CLI, or
-skills-only installs.
+<p align="center">
+  <strong>11 skills</strong> · <strong>Relay fixture 6/6</strong> · <strong>Claude + Codex</strong> · <strong>MIT</strong>
+</p>
+<p align="center"><sub>Relay 6/6 is a mechanical protocol check; behavioral results are reported separately.</sub></p>
+
+Luciazero is the verification and handoff layer for Claude Code, Codex CLI, and
+compatible skill runtimes. It helps agents prove tests, preserve scope, and
+move unfinished work with evidence.
 
 > Done is proven by a command, not by my judgment. If no verification command
 > exists, that is the first bug.
 
-It ships a compact [9-rule doctrine](https://github.com/ohm41321/luciazero/blob/main/claude/luciazero.md), 11 on-demand skills,
-verification hooks, a risk-routed reviewer, and an eval harness. It is designed
-to make completion claims auditable—not to replace an agent runtime or become an
-overnight orchestrator.
+Luciazero is for teams that want coding agents to prove work instead of merely
+report it. It helps prevent false-green verification and dropped scope,
+preserves lessons from repeated dead ends, and carries context across handoffs
+when `/lucia-relay` is used. It is a discipline layer, not an agent runtime.
+
+## Start in 30 seconds
+
+Choose the path that matches your agent, then start a new session:
+
+**Claude Code · full pack**
+
+```text
+/plugin marketplace add ohm41321/luciazero
+/plugin install luciazero@luciazero
+```
+
+Run `/luciazero:ready` in the new session.
+
+**Codex CLI · doctrine + skills**
+
+```bash
+npx luciazero codex
+```
+
+Run `$ready` in the new session.
+
+**Skills-only · any compatible agent**
+
+```bash
+npx skills add ohm41321/luciazero
+```
+
+Invoke the installed `ready` skill using your agent's syntax (for Codex CLI,
+use `$ready`). This path intentionally does not install the doctrine, reviewer,
+or hooks.
 
 ## See the loop
 
@@ -40,6 +79,20 @@ This GIF is driven by the shipped hooks, not a mockup:
 ✅ verify 3m   → the latest check passed three minutes ago
 ```
 
+Run the same shipped hook driver locally—no model or API is required:
+
+```bash
+bash docs/assets/statusline-demo.sh
+```
+
+For the cross-session handoff demo:
+
+```bash
+bash docs/assets/relay-demo.sh
+```
+
+Both scripts use throwaway directories and exercise the real implementation.
+
 ## What it protects
 
 | Failure mode | Mechanism |
@@ -151,11 +204,13 @@ Other install channels use their own updater:
 
 ```bash
 claude plugin update luciazero@luciazero   # then run /reload-plugins
-npx skills update                          # review the scope prompt
+npx skills update                          # every installed skill in the selected scope
+npx skills update done -g                 # only the global "done" skill
 ```
 
 The skills command updates every installed skill in the selected scope, not
-only Luciazero; review its prompt before confirming.
+only Luciazero; review its prompt before confirming. Use the targeted form when
+you only want to refresh one skill.
 
 Claude Code can auto-update the plugin at startup: open `/plugin` →
 **Marketplaces** → **luciazero** → **Enable auto-update**. Third-party
@@ -164,7 +219,8 @@ GitHub **Watch → Custom → Releases**.
 
 ## Skills at a glance
 
-Run `/ready` first; the rest activate when their moment arrives.
+Invoke `ready` first (`/ready` for slash-based agents, `$ready` in Codex); the
+rest activate when their moment arrives.
 
 | Moment | Skill | Result |
 |---|---|---|
@@ -191,6 +247,10 @@ separate passes.
 
 ## Evidence & limitations
 
+The measurements below are early and model/task-specific. The linked raw rows
+and methodology are the source of truth; they are not a promise of uplift on
+every repository or model.
+
 <!-- BEGIN GENERATED: benchmark-evidence -->
 
 ### Claude results
@@ -273,6 +333,7 @@ More detail:
 - [Benchmark results and GPT plan](https://github.com/ohm41321/luciazero/blob/main/docs/benchmark.md)
 - [Raw campaign registry](https://github.com/ohm41321/luciazero/blob/main/eval/results/campaigns.json)
 - [Experiment log](https://github.com/ohm41321/luciazero/blob/main/docs/experiments.md)
+- [Launch kit](https://github.com/ohm41321/luciazero/blob/main/docs/launch-kit.md)
 - [Contributing](https://github.com/ohm41321/luciazero/blob/main/CONTRIBUTING.md)
 - [Publishing](https://github.com/ohm41321/luciazero/blob/main/docs/publishing.md)
 - [Changelog](https://github.com/ohm41321/luciazero/blob/main/CHANGELOG.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "luciazero",
-  "version": "2.4.2",
+  "version": "2.4.3",
   "description": "Verification-first discipline for coding agents (Claude Code + Codex CLI): 9-rule doctrine, 11 skills, risk-routed reviewer, fail-open enforcement hooks. npx luciazero installs it.",
   "repository": {
     "type": "git",
@@ -32,10 +32,17 @@
   "keywords": [
     "claude-code",
     "codex",
+    "ai-agent",
+    "ai-agents",
     "agent-skills",
+    "coding-agent",
+    "claude-plugin",
+    "context-handoff",
     "verification",
     "doctrine",
     "hooks",
-    "agentic-engineering"
+    "agentic-engineering",
+    "agent-workflow",
+    "test-discipline"
   ]
 }