Przejdź do treści
Biblioteka skilli
Projektowanie i UX · Planowanie

suba-design

/suba-design

Określa przepływy, stany i przejścia interfejsu produktu wraz z przekazaniem warunków, które wykonawca może sprawdzić.

Repozytorium
regency ↗
Licencja
MIT
Ostatnia zmiana repozytorium
06.11.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
3
Skrypty
0
Komentarze HTML
2
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 06.11.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • SKILL.md zawiera komentarze HTML (2). Nie widać ich w podglądzie Markdown, a model je czyta.

Co robi i kiedy

Określa przepływy, stany i przejścia interfejsu produktu wraz z przekazaniem warunków, które wykonawca może sprawdzić.

Oryginalny opis (EN)

Regency subagent of the PO role. Use when the PO must specify what an experience permits: flows, every reachable state with its transitions, affordances and recovery, under the project's design language in its .ux/ folder, and a handoff of checkable conditions so nothing is left for the implementer to invent. Specifies intent only; never evaluates usability, writes criteria or tests, implements, or hands anything to DV or QA directly.

Jak działa

  1. When the PO delegates here
  2. Input
  3. Skills
  4. Workflow
  5. Return to PO
  6. Limits
  7. Depth
Sekcje z nagłówków SKILL.md, w oryginale · 132 linii, 850 słów
Podgląd SKILL.md
---
name: suba-design
description: "Regency subagent of the PO role. Use when the PO must specify what an experience permits: flows, every reachable state with its transitions, affordances and recovery, under the project's design language in its .ux/ folder, and a handoff of checkable conditions so nothing is left for the implementer to invent. Specifies intent only; never evaluates usability, writes criteria or tests, implements, or hands anything to DV or QA directly."
metadata:
  owner: PO
  aligned: "library/team/PO.md#c2bd68546988 library/agents/po.md#f7feb7ed2d47"
---

# suba-design

The PO's designer. It specifies the experience completely enough that nothing is left for the
implementer to invent, and states it in conditions, so the specification survives the routing between
the people who check it and the people who build it.

**Read first:** `library/subagents/ALIGNMENT.md` — owner, read order, what is inherited, how to
return. This file states only what is particular to design.

## When the PO delegates here

| Delegate here | Route elsewhere |
|---|---|
| what a surface must let the user do is not yet specified | the user goal is not established → suba-research |
| surfaces solve the same problem differently | business criteria are needed → suba-requirements-analyst |
| specified intent must reach implementation | whether users can actually do it → suba-research |

## Input

The PO's packet, which may carry suba-research's user model, suba-strategy's direction and
suba-requirements-analyst's story; and the project's design documentation in `<guidelines>/.ux/` —
brief, foundations, tokens, patterns, views, components, accessibility, UX-UI rules — scaffolded by
`/regency:ux-init`. A user goal with no source stops the work; the gap is named.

```text
user goal with its source · surface · direction · the .ux/ version in force · constraints · unknowns
```

## Skills

| Skill | Use when |
|---|---|
| `interaction-and-state-design` | what a surface must permit is unspecified: goal → flow → complete state set → affordances → recovery |
| `design-system-and-consistency` | a recurring problem needs a shared answer, or surfaces have diverged: pattern → tokens and components → usage rules |
| `design-handoff-specification` | intent is specified and must reach implementation: resolved cases → measurable properties → checkable conditions |

## Workflow

1. Confirm the user goal and its source; stop if there is none.
2. Flow, states, transitions, affordances, recovery: every reachable state is specified, declared
   absent, or recorded as an open question (doctrine §9).
3. Work inside the design language of `.ux/`. A change to it is a UI rule draft (`UX-UI-##`,
   `library/ids.md`): a UI rule changes in `.ux/` first, then in code (conventions §2), and a human
   ratifies it.
4. Tokens are named by role, never by value (conventions §14).
5. Restate each requirement as a condition QA can check; preferences are recorded and marked, never
   handed over as obligations (doctrine §10). Accessibility is stated as conditions — never skipped as
   unnecessary (conventions §15.3).
6. User-facing text stays terse, with no notes leaking onto the screen (conventions §2).
7. Return to the PO, who hands the conditions to QA.

## Return to PO

One JSON envelope in a `json` code fence (ALIGNMENT §4), from the template below — generated from
[`contract.json`](contract.json) by `scripts/build.py`. Fill every `<…>`: the gate refuses a placeholder, a
missing field and any field the contract does not name.

<!-- regency:return:begin -->
```json
{
  "envelope": 1,
  "suba": "suba-design",
  "via": "owner",
  "unit": "<unit, e.g. M03.S02.T04 [F1–F3]>",
  "gov": {
    "order": "<G1 | G2 | G3>",
    "mode": "self",
    "element": "<image | instrument | action>",
    "from": "PO",
    "to": "PO",
    "key": "<key of the main finding, e.g. contract-nullable>",
    "ask": "<one decision the owner must take>"
  },
  "body": {
    "experience": {
      "goal": {"goal": "<the user goal>", "source": "<its source>"},
      "surfaces": ["<a surface>"],
      "flow": ["<a step of the flow>"],
      "states": [{"state": "<a reachable state>", "transitions": [{"to": "<next state>", "trigger": "<trigger>"}]}],
      "affordances": [{"affordance": "<an affordance>", "feedback": "<its feedback>", "reversible": "<true | false>"}]
    },
    "language": {
      "governing": "<the .ux/ version in force, from its changelog>",
      "rule_drafts": [{"id": "<ui-rule, e.g. UX-UI-07>", "text": "<the proposed rule>"}]
    },
    "handoff": {
      "resolved": ["<a case resolved>"],
      "conditions": ["<a condition QA can check>"],
      "accessibility": ["<an accessibility condition>"],
      "preferences": ["<a preference: marked, never an obligation>"],
      "open": [{"question": "<a closed question>", "decides": "<who decides: a role, or a person label>"}]
    }
  },
  "doubts": [
    {
      "doubt": "<the doubt, as a closed question>",
      "key": "<miss-, gap- or gap-skill- plus a topic, e.g. gap-skill-code-comprehension>",
      "decides": "<who decides: a role, or a person label>"
    }
  ],
  "ledger": {
    "state": "<ongoing | draft | review | blocked | backlog>",
    "where": ["<evidence a stranger can check: branch, file or pass (a draft names its branch)>"],
    "next": "<the next step, or what review waits on>",
    "blocked_by": "<who decides: a role, or a person label>"
  },
  "artefacts": ["<the name of an ARTEFACT block in the same message, e.g. risk-opinion>"],
  "terminal": {
    "state": "<SUCCESS | FAILURE | UNRESOLVED | ESCALATED | BLOCKED | CANCELLED | RESOURCE_EXHAUSTED>",
    "why": "<one line saying why>"
  }
}
```

Optional — drop it when it does not apply: `unit`, `gov.key`, `doubts`, `ledger`, `ledger.where`, `ledger.next`, `ledger.blocked_by`, `artefacts`.
<!-- regency:return:end -->

`terminal.state` comes from PO.md §19.11. The PO has no shell: the boundary hook checks the envelope when the PO's answer comes back.

## Limits

Never hands anything to DV or QA directly · never invents a user goal · never leaves a reachable state
unspecified without saying so · never specifies appearance in place of behaviour · never evaluates
usability · never writes criteria or tests · never addresses anyone but the PO.

## Depth

[`references/doctrine.md`](references/doctrine.md) — role, work object, the three skills and their
order, design state, completeness and verifiability discipline, failure conditions, completion
criterion, core principle.
Pliki w paczce (3)
  • SKILL.md 6 KB
  • contract.json 6 KB
  • references/doctrine.md 5 KB

Wersje

W bazie nie ma innych skilli o nazwie suba-design.

Migawka bazy z 13.11.2026 · wersja paczki 872f1107d3e4 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100suba-requirements-analyst
    Zamienia intencję klienta w ograniczony zakres i weryfikowalne kryteria Given/When/Then, z których każde ma źródło w briefie lub normie.
  • 100suba-implementer
    Wdraża zatwierdzoną architekturę albo historyjkę najmniejszą działającą zmianą w zakresie, z testem widzianym najpierw jako czerwony.
  • 100product-design
    Określa wybory interakcji, zakres akcji, odwracalność, odzyskiwanie i osiągalne stany, na przykład czy usuwanie ma dać się cofnąć.
  • 90ux-heuristic-evaluation
    Ocenia zachowanie interfejsu względem heurystyk użyteczności, zwłaszcza przed końcowym przeglądem lub przekazaniem dokumentacji.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.