@ui8kit/uxdx 0.1.0 → 0.1.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ui8kit/uxdx",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "CLI to accumulate operator and developer experience packs",
   "type": "module",
   "bin": {

package/packages/sdlc/harness/README.md

@@ -1,18 +1,28 @@
 # SDLC harness packs (solo)
 
-Copy-paste packs for the AI-native loop, sized for one operator. Source method:
-[`.manual/sdlc-en`](../.manual/sdlc-en/README.md). Which product gets which pack:
-[`.project/sdlc-scope.md`](../.project/sdlc-scope.md).
+Copy-ready packs for the AI-native loop, sized for one operator. Method:
+[The AI-Native SDLC Playbook](https://academy.claude.com/courses/ai-native-sdlc-playbook)
+(public course). Map `plan.md` / `CLAUDE.md` onto Cursor Plan mode and
+`AGENTS.md`.
 
-Later this tree can move to its own repo or a CLI (`sdlc init --level full`).
-Until then the consumer copies **one** pack into **`.sdlc/`**.
+This tree is the source of truth. Install a pack with the published CLI:
+
+```text
+npx @ui8kit/uxdx sdlc --level light|core|full
+```
+
+That copies **one** pack into the target repo’s `.sdlc/` and, unless
+`--no-install`, overlays Cursor rules/skills and merges `AGENTS.md`.
+Never stack two levels. Do not copy this tree by hand.
+
+Package: [`@ui8kit/uxdx`](https://www.npmjs.com/package/@ui8kit/uxdx)
 
 ## How it works
 
 ```
-hinddy/brainstorm/.harness-sdlc/<level>/     (this gym)
+@ui8kit/uxdx  packages/sdlc/harness/<level>/
         │
-        │  copy (do not merge levels)
+        │  npx @ui8kit/uxdx sdlc --level <level>
         ▼
 your-repo/.sdlc/                             artifacts + overlay text
         │
@@ -23,9 +33,15 @@ your-repo/.sdlc/                             artifacts + overlay text
         └── cursor/rules/                    copy → .cursor/rules/
 ```
 
-1. Pick **full**, **core**, or **light** from `sdlc-scope.md`. Never stack two packs.
-2. Copy the pack directory contents into `<repo>/.sdlc/` (keep `manifest.yaml`).
-3. **Activate Cursor** (rules/skills are not loaded from `.sdlc` by default):
+1. Pick **full**, **core**, or **light**. Never stack two packs.
+2. Run `npx @ui8kit/uxdx sdlc --level <level>` (add `--dir` if needed).
+3. **Activate Cursor** is done by `sdlc.sh install` (default). To copy only:
+
+   ```text
+   npx @ui8kit/uxdx sdlc --level <level> --no-install
+   ```
+
+   then overlay yourself:
 
    ```bash
    mkdir -p .cursor/rules .cursor/skills
@@ -33,26 +49,29 @@ your-repo/.sdlc/                             artifacts + overlay text
    cp -R .sdlc/skills/* .cursor/skills/
    ```
 
-4. **AGENTS.md**: if the repo already has a product `AGENTS.md` (SiteStarter, YPanel, …), **append** a short pointer. Do not replace stack-contract text. If there is no root file, copy `.sdlc/AGENTS.md` to the repo root.
-5. For each change: copy `intent.md` / `spec.md` / `plan.md` into `.sdlc/changes/<slug>/` and fill them. Leave the pack-root files as templates.
-6. Existing product rules (`.cursor/rules/stack-contract.mdc`, …) stay. The harness adds SDLC rules; it does not own Codex IA.
+4. **AGENTS.md**: if the repo already has one, the install **appends** a
+   marked overlay. Do not replace product contract text. If there is no root
+   file, install writes `.sdlc/AGENTS.md` to the repo root.
+5. For each change: copy templates into `.sdlc/changes/<slug>/` (`sdlc.sh
+   start <slug>`) and fill them. Leave the pack-root files as templates.
+6. Existing product rules stay. The harness adds SDLC rules only.
 
-Human still merges. The agent writes artifacts and code; you accept `plan.md` before a large diff.
+Human still merges. The agent writes artifacts and code; you accept `plan.md`
+before a large diff.
 
 ## Levels
 
 | Pack | Use when | Artifacts | Extra |
 | --- | --- | --- | --- |
-| `light/` | Product on an existing contract; small blast radius | `plan.md` required; `intent.md` optional; skip `spec.md` unless IA changes | No evals, no maintain bands |
-| `core/` | Kernel, API, ARIA, shared library | `intent.md` + `plan.md`; compressed `spec.md` on boundary changes | Invariant skills; short `REVIEW.md` |
-| `full/` | Portable Codex path, YPanel, anything that ships + is pinned | Full chain including `spec.md` | `REVIEW.md`, `evals/` stub, `bands.yaml` stub |
-
-## Future CLI (not built)
+| `light/` | Product already has a contract; small blast radius | `plan.md` required; `intent.md` optional; skip `spec.md` unless the public contract changes | No evals, no maintain bands |
+| `core/` | Kernel, API, or shared library | `intent.md` + `plan.md`; short `spec.md` on boundary changes | Invariant skills; short `REVIEW.md` |
+| `full/` | Shipping product or high-stakes operator surface | Full chain including `spec.md` | `REVIEW.md`, `evals/` stub, `bands.yaml` stub |
 
-Suggested commands, matching `manifest.yaml` in each pack:
+## Commands
 
-- `sdlc init --level full` → copy pack to `.sdlc`, overlay rules/skills, patch root `AGENTS.md` between markers
-- `sdlc change start <slug>` → copy templates into `.sdlc/changes/<slug>/`
-- `sdlc change accept` → remind to commit artifacts with the diff
-
-Do not invent a second content REST or product kinds from this harness.
+```text
+npx @ui8kit/uxdx sdlc --level full
+bash .sdlc/sdlc.sh install
+bash .sdlc/sdlc.sh start <slug>
+bash .sdlc/sdlc.sh status
+```

package/packages/sdlc/harness/core/AGENTS.md

@@ -1,7 +1,7 @@
 <!-- sdlc-harness:begin -->
 ## SDLC harness (core)
 
-This repo uses the **core** pack (`.harness-sdlc/core` → `.sdlc/`).
+This repo uses the **core** pack from [`@ui8kit/uxdx`](https://www.npmjs.com/package/@ui8kit/uxdx) (`.sdlc/`).
 
 - Boundary, API, and policy changes: `intent.md` + short `spec.md` + `plan.md`.
 - Mechanical fixes: `plan.md` only, still name the invariant you must not break.

package/packages/sdlc/harness/core/README.md

@@ -1,9 +1,12 @@
 # Core harness
 
 For kernels, shared libraries, and high blast-radius contracts.
-Examples: FormSet, Framework, Panel, ui8kit/aria, Context.
 
-Copy this directory to `<repo>/.sdlc/`. Overlay Cursor files — `../README.md`.
+Install:
+
+```text
+npx @ui8kit/uxdx sdlc --level core
+```
 
 ## Per change
 

package/packages/sdlc/harness/full/AGENTS.md

@@ -1,7 +1,7 @@
 <!-- sdlc-harness:begin -->
 ## SDLC harness (full)
 
-This repo uses the **full** pack (`.harness-sdlc/full` → `.sdlc/`).
+This repo uses the **full** pack from [`@ui8kit/uxdx`](https://www.npmjs.com/package/@ui8kit/uxdx) (`.sdlc/`).
 
 Loop: accepted `intent.md` → `spec.md` → `plan.md` → diff + existing verify
 → PR against `.sdlc/REVIEW.md` → you merge. Optional later: `evals/` on

package/packages/sdlc/harness/full/README.md

@@ -1,9 +1,12 @@
 # Full harness
 
-For the portable Codex path and high-stakes operators.
-Examples: SiteStarter, GoBackend, SvelteCMS, YPanel.
+For shipping products and high-stakes operator surfaces.
 
-Copy this directory to `<repo>/.sdlc/`. Overlay Cursor files — `../README.md`.
+Install:
+
+```text
+npx @ui8kit/uxdx sdlc --level full
+```
 
 Solo adaptation: no MDM, no weekly committee. You still accept `spec.md` and
 `plan.md`, merge PRs, and authorize production.
@@ -20,4 +23,4 @@ Solo adaptation: no MDM, no weekly committee. You still accept `spec.md` and
 
 ## Per change
 
-`mkdir -p .sdlc/changes/<slug>` and copy `intent.md`, `spec.md`, `plan.md`.
+`bash .sdlc/sdlc.sh start <slug>` (copies `intent.md`, `spec.md`, `plan.md`).

package/packages/sdlc/harness/full/hooks/README.md

@@ -12,6 +12,6 @@ repo, for example:
 Keep approval prompts off the build hot path so parallel sessions are not
 serialized. Production gates belong at deploy, not on every file save.
 
-Example PreToolUse shape lives in the playbook
-(`.manual/sdlc-en/10-hooks-as-approval-gates.md`). Do not enable managed-only
-enterprise settings unless you actually operate MDM.
+Example PreToolUse shape lives in the public playbook
+([hooks as approval gates](https://academy.claude.com/courses/ai-native-sdlc-playbook/hooks-as-approval-gates)).
+Do not enable managed-only enterprise settings unless you actually operate MDM.

package/packages/sdlc/harness/light/AGENTS.md

@@ -1,7 +1,7 @@
 <!-- sdlc-harness:begin -->
 ## SDLC harness (light)
 
-This repo uses the **light** pack from `hinddy/brainstorm` (`.harness-sdlc/light`).
+This repo uses the **light** pack from [`@ui8kit/uxdx`](https://www.npmjs.com/package/@ui8kit/uxdx).
 Working copy: `.sdlc/`. Per-change artifacts: `.sdlc/changes/<slug>/`.
 
 - Non-trivial work starts in plan mode. Commit `plan.md` before a large diff.

package/packages/sdlc/harness/light/README.md

@@ -1,15 +1,17 @@
 # Light harness
 
-For product repos that already have a contract (`AGENTS.md`, stack rules, tests).
-Examples: AlexY OS, GitCourse, Lab, BrandOSS, ui8px-cli, FastyGo UI.
+For product repos that already have a contract (`AGENTS.md`, rules, tests).
 
-Copy this directory to `<repo>/.sdlc/`. Then overlay Cursor files — see
-`../README.md`.
+Install:
+
+```text
+npx @ui8kit/uxdx sdlc --level light
+```
 
 ## Per change
 
-1. `mkdir -p .sdlc/changes/<slug>`
-2. Copy `plan.md` into that folder and fill it.
-3. Add `intent.md` only if the origin is unclear (incident, external request).
-4. Skip `spec.md` unless you are changing published IA or a user-visible contract.
-5. Run the repo's existing verify command before calling the task done.
+1. `bash .sdlc/sdlc.sh start <slug>` (or `mkdir -p .sdlc/changes/<slug>`).
+2. Fill `plan.md` in that folder.
+3. Add `intent.md` only if the origin is unclear.
+4. Skip `spec.md` unless you are changing a published or user-visible contract.
+5. Run the repo’s existing verify command before calling the task done.

package/packages/sdlc/harness/light/skills/sdlc-light/SKILL.md

@@ -2,7 +2,8 @@
 name: sdlc-light
 description: >-
   Light AI-native SDLC for a solo developer. Use when planning or implementing
-  work in a repo that copied .harness-sdlc/light into .sdlc. Write plan.md,
+  work in a repo whose `.sdlc` was installed with `@ui8kit/uxdx` at level
+  light. Write plan.md,
   skip spec.md unless IA changes, run existing verify commands.
 ---