analyzthis_design 1.20.1 → 2.0.1

package/skills/mood-board/SKILL.md

@@ -0,0 +1,113 @@
+---
+name: mood-board
+description: Build a visual/textual mood board from web references + design-system patterns, then run the persona team through adversarial deliberation to converge on a design direction. User can add references and rerun.
+---
+
+# Mood Board — Team-Based Visual Direction Setting
+
+Use `/mood-board` when you want to explore visual directions for a screen, flow, or product and have the persona team deliberate on which references fit the user, task, and design system.
+
+## What it does
+
+1. **Collects references** from URLs you provide, configured `moodboard.urls`, and optional web search stubs.
+2. **Tags each reference** with style, mood, surface, and heuristic keywords.
+3. **Pulls design-system guidance** from `skills/design-reference/*.csv` (ui-reasoning, colors, styles, typography, stack files) based on your task and detected tech stack.
+4. **Runs the team** (Arjun, Meera, Priya, Zara, Noor) through adversarial deliberation using the UX Honeycomb rigor matrix.
+5. **Writes artifacts** to:
+   - `~/.analyzthis_design/sessions/{projectId}/moodboard/{boardId}/board.json` (authoritative)
+   - `./moodboard/{boardId}.json` (workspace copy for the user to inspect)
+6. **Accepts user-contributed references** and reruns deliberation with the new input.
+
+## Entry commands
+
+```bash
+npx analyzthis_design moodboard create --task "B2B fintech dashboard, trustworthy, high-contrast" \
+  --url https://dribbble.com/shots/example --url https://example.com/article
+
+npx analyzthis_design moodboard create --task "SaaS onboarding landing page" --auto
+
+npx analyzthis_design moodboard critique --board <boardId>
+
+npx analyzthis_design moodboard add --board <boardId> \
+  --url https://dribbble.com/shots/new-ref \
+  --title "Alternative hero layout" \
+  --tags "landing,hero,trust" \
+  --note "I like the white space and the trust badge placement"
+
+npx analyzthis_design moodboard list
+```
+
+## v2.0 chunked execution
+
+`/mood-board` now runs internally through the v2.0 chunked executor:
+- Frontier planner scopes the board (personas, references, DS lookups).
+- Cheap/free models tag references, retrieve design-system rows, and run the deliberation loop.
+- Result is the same `board.json` artifact, but at lower average token cost.
+
+## How the personas use it
+
+| Persona | Lens |
+|---|---|
+| **Arjun** | Visual system fit, contrast, hierarchy, accessibility, WCAG |
+| **Meera** | Brand/category fit, GTM risk, competitive positioning |
+| **Priya** | Technical feasibility of implementing the style/pattern |
+| **Zara** | First impression, delight moment, emotional response |
+| **Noor** | IA clarity, progressive disclosure, surface structure |
+
+Each persona scores references with the Honeycomb rigor matrix:
+- Useful, Usable, Findable, Credible, Accessible, Desirable, Valuable
+- Then deliberates with low satisfaction until consensus or Raj escalation.
+
+## Output format
+
+`board.json` contains:
+
+```json
+{
+  "board_id": "abc123",
+  "task": "B2B fintech dashboard, trustworthy, high-contrast",
+  "references": [
+    {
+      "id": "def456",
+      "url": "https://dribbble.com/shots/example",
+      "title": "...",
+      "description": "...",
+      "source": "config",
+      "type": "visual",
+      "tags": ["dashboard", "trust", "dark", "data-dense"]
+    }
+  ],
+  "design_system_pack": [ { "file": "ui-reasoning.csv", "rows": [...] } ],
+  "deliberation": { "round_log": [...], "consensus_reached": true },
+  "synthesis": { "verdict": "SHIP", "top3": [...] }
+}
+```
+
+## User as "god"
+
+You can:
+- Add any URL or free-text note to the board.
+- Override tags.
+- Rerun critique after adding references.
+- Accept or reject the final direction with `session accept --persona arjun` etc.
+
+## Config
+
+In `~/.analyzthis_design/config.json`:
+
+```json
+{
+  "moodboard": {
+    "urls": ["https://dribbble.com/shots/example"],
+    "queries": ["fintech dashboard design"],
+    "limit": 12,
+    "workspace_dir": "./moodboard"
+  }
+}
+```
+
+## Notes
+
+- Image URLs are stored as references; alt-text/captions are added during tagging.
+- Web articles are fetched as plain text; image extraction from HTML is not yet implemented.
+- Router rule: `mood_board` signals route to the `mood-board` skill, not the critique chain.

package/skills/persona-orchestrator/SKILL.md

@@ -130,7 +130,7 @@ Run `ux-story-gate` Phase 5.5. If `mode: assess_only`, stop here — do not writ
 
 ---
 
-## Step 6.5 — Capture user corrections (v1.16)
+## Step 6.5 — Capture user corrections and outcomes (v1.16 / v1.21)
 
 When the user is **unhappy** with a persona's output or **rewrites/corrects** it, record that signal so future training can learn from mistakes:
 
@@ -152,6 +152,40 @@ Suggest this when the user says things like *"that's not what I meant,"* *"use o
 
 List or export later: `feedback list`, `feedback export --persona arjun --all`.
 
+**Track whether the advice actually shipped.** After the user implements changes, confirm the outcome so the evolution loop can learn:
+
+```bash
+npx analyzthis_design outcome --confirm --persona arjun --result shipped
+# or: revised, blocked_correctly, missed
+```
+
+**Default execution is chunked (v2.0).** `npx analyzthis_design run --task "..."` now uses a frontier planner + cheap chunk models. Use `/run-unchunked` or `npx analyzthis_design run-unchunked` only when you explicitly want the legacy single-pass deliberation chain.
+
+**Set visual direction with the team.** Use `/mood-board` when the user wants references and a team-deliberated direction:
+
+```bash
+npx analyzthis_design moodboard create --task "B2B fintech dashboard, trustworthy, high-contrast" --auto
+npx analyzthis_design moodboard critique --board <boardId>
+```
+
+References are tagged, design-system patterns are pulled, and Arjun/Meera/Priya/Zara/Noor deliberate with Honeycomb scoring until consensus.
+
+**Evolve the team.** Periodically (e.g., weekly), run:
+
+```bash
+npx analyzthis_design evolve --extract --dry-run   # preview proposed patches
+npx analyzthis_design evolve --extract             # write patch files for review
+npx analyzthis_design evolve --apply <patchId> --dry-run   # preview a patch
+npx analyzthis_design evolve --apply <patchId>    # apply after review
+```
+
+This harvests accepted outputs + confirmed outcomes, extracts lessons into `~/.analyzthis_design/lessons/`, and proposes patches to:
+- persona SKILL.md / cards (new canonical failure patterns),
+- `skills/design-reference/*.csv` rows (new product-type guidance),
+- `agents/router.json` rules (task_type → best-performing expert).
+
+Patches are **dry-run by default** and require human review before apply.
+
 **Share with maintainers (opt-in):** after recording, suggest `npx analyzthis_design feedback submit --yes` so anonymized corrections help improve personas for everyone. Preview first with `--dry-run`.
 
 ---

package/skills/run-unchunked/SKILL.md

@@ -0,0 +1,49 @@
+---
+name: run-unchunked
+description: Run the legacy non-chunked orchestrator. Useful when the chunked planner overhead is not justified for a quick single-expert task.
+---
+
+# Run Unchunked — Legacy Orchestrator Mode
+
+Use `/run-unchunked` when you want the original single-pass deliberation orchestrator instead of the default v2.0 chunked execution.
+
+## When to use
+
+- Quick single-expert tasks
+- You already know exactly which personas to run
+- You want one model to execute the whole chain without planner overhead
+- Debugging or comparing against chunked output
+
+## How to run
+
+**Cursor / Claude / Grok:**
+
+```
+/run-unchunked --task "Fix contrast on the invoice table" --experts arjun
+```
+
+**Windsurf:**
+
+```
+@run-unchunked --task "Fix contrast on the invoice table" --experts arjun
+```
+
+**CLI:**
+
+```bash
+npx analyzthis_design run-unchunked --task "Fix contrast on the invoice table" --experts arjun
+```
+
+## Flags
+
+- `--task` — required
+- `--figma` — optional Figma URL
+- `--experts` — explicit persona list
+- `--full` / `--lite` — chain size
+- `--no-deliberate` — legacy sequential handoff
+- `--provider` — model provider
+- `--max-rounds`, `--satisfaction` — deliberation tuning
+
+## Note
+
+This is the v1.x behavior preserved for compatibility. The default `npx analyzthis_design run` now uses chunked execution (frontier planner + cheap chunk models) in v2.0.