Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

workflow

/workflow

Stosuje metodę pracy przy zmianach w projekcie z plikiem .quality: najpierw zrozumienie, potem najmniejsza kompletna zmiana i testy.

Repozytorium
quality-pack ↗
Licencja
MIT
Ostatnia zmiana repozytorium
13.11.2026

Ocena i bezpieczeństwo

90/ 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ść25 / 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
1
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 13.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 robi i kiedy

Stosuje metodę pracy przy zmianach w projekcie z plikiem .quality: najpierw zrozumienie, potem najmniejsza kompletna zmiana i testy.

Oryginalny opis (EN)

Shipwright working method for any coding task in a project that has a .quality/project.json file: understand before coding, smallest complete change, written acceptance criteria, tests for risky logic, verification before saying done, and a frugal use of tokens. Use whenever you implement, change, refactor or fix something in such a project. FR : méthode de travail, implémenter une fonctionnalité, corriger un bug, modifier le code.

Jak działa

  1. Before you write code
  2. While you write code
  3. Find code cheaply
  4. Before you say it is done
  5. Long tasks
Sekcje z nagłówków SKILL.md, w oryginale · 45 linii, 827 słów
Podgląd SKILL.md
---
name: workflow
description: "Shipwright working method for any coding task in a project that has a .quality/project.json file: understand before coding, smallest complete change, written acceptance criteria, tests for risky logic, verification before saying done, and a frugal use of tokens. Use whenever you implement, change, refactor or fix something in such a project. FR : méthode de travail, implémenter une fonctionnalité, corriger un bug, modifier le code."
---

# Shipwright working method

The project's `.quality/project.json` gives its promise, profile, flags and stacks. Read it once per session if you have not.
If `.quality/handoff.md` exists and is recent, read it first: it says where the last session stopped.

## Before you write code

1. Restate the task in one or two sentences and list your assumptions. If something is ambiguous and a wrong guess would be costly, ask. Otherwise pick the most reasonable reading and say which one you took.
2. For a new feature, write its acceptance criteria first (in the task, a spec file or the ticket): what the user can do, what they see in the empty, loading and error cases, what must never happen.
3. Find every place your change must reach: callers, types, tests, fixtures, config, translations (see "Find code cheaply" below).
4. For a new or reorganised screen, use the `design-screens` skill before coding; for colours, fonts, spacing or a new look, the `design-direction` skill; for anything that moves with scrolling, the `scroll-animation` skill; to finish a screen (states, typography details, waiting, identity, copy), the `premium-craft` skill.
5. For accounts, customers, roles, subscriptions or service emails, use the `saas-foundations` skill; for an installed mobile app, the `mobile-app` skill; for a desktop app (Tauri, Electron), the `desktop-app` skill; for public pages to be found on search engines, the `seo-launch` skill. When the project starts from nothing or you do not know what comes next, the `from-zero` skill gives the stages and their gates.
6. Load the build skills of Shipwright for the domains you will touch (`build-product-experience`, `build-ergonomics`, `build-design`, `build-security-data`, `build-reliability-quality`, `build-performance-seo`, `build-integrations-payments`, `build-saas`, `build-mobile`, `build-operations`) and the rules skill of the stack you are in.

## While you write code

- Smallest complete change: reuse what the project already has, add no abstraction, option or dependency nobody asked for, and finish every part the task needs.
- Touch only what the task requires. If you see an unrelated problem, mention it instead of rewriting it.
- Never cut: input validation at trust boundaries, authorisation checks, error handling that prevents data loss, accessibility, anything the user asked for.
- Logic with a branch, a loop, money, parsing, permissions or security gets at least one test. A fixed bug gets a test that would have caught it.
- No secret in code. No debug `console.log` left behind. No filler text or invented content: no testimonial, figure, customer logo or badge that the user did not supply.
- A new kind of resource or a new role gets its line in `.quality/project.json` › `access` in the same change. A new entry point (route, webhook, upload) or third party gets its abuse case in `.quality/threats.json`.
- Before adding a dependency, check on the registry that the exact name exists, how old it is and where its repository is.

## Find code cheaply

- If `graphify-out/graph.json` exists, ask the graph before searching files: `graphify query "<question>"`, `graphify path "<A>" "<B>"`, `graphify explain "<name>"`. Then read only the lines it points to.
- Otherwise, use Grep with precise patterns and line numbers, then Read only the needed range (`offset`, `limit`).
- Do not re-read a file that is already in your context and has not changed.
- For commands with long output (tests, lint, builds, audits), use `node "${CLAUDE_PLUGIN_ROOT}/scripts/sw.mjs" run <label> "<command>"`. You get the exit code and the error lines; the full log stays on disk.

## Before you say it is done

1. Run the project's typecheck, lint and tests (the stack rules skill lists the commands) and read the result.
2. For UI changes, open the page (Playwright or the browser) at mobile and desktop widths, check the empty, loading and error states, and read the console. If the change touches a key task of `.quality/project.json` › `flows`, play it: `node "${CLAUDE_PLUGIN_ROOT}/scripts/sw.mjs" flows <flow-id>`, then look at the screenshots of the steps you changed, on the phone and on the desktop. A screen that passes every check but makes the task long or confusing is not done. Before saying interface work is done, follow the `deslop-ui` skill: `sw.mjs deslop <url>`, fix the high findings, look at the screenshots.
3. If the change touches routes, permissions or data access and the project declares `access`, play it on the local app: `node "${CLAUDE_PLUGIN_ROOT}/scripts/sw.mjs" access`. A leak is a blocker, not a note.
4. For a screen meant to be finished, measure it: `sw.mjs craft <url>` (no failed "must") and `sw.mjs deslop <url>`.
5. Check the "Done means" criteria of the domains you touched.
6. Report in two or three lines: what changed, how you verified it, and anything you skipped or could not check. No recap of the steps, no restating the code. Never claim a check you did not run.

## Long tasks

When a task will continue in another session, or the context is getting long, run `/sw:handoff`. The next session then starts from a short summary instead of exploring the project again.

Wersje

RepozytoriumWynikLicencja
Ta strona · 1AngelMicka/quality-pack90MIT
jeremylongshore/tons-of-skills-marketplace100MIT
SimHacker/moollm100MIT
mlophez/polix-ai100Apache-2.0
stellarie/minimal-agent-kit100MIT
waynesutton/builder-skills100Apache-2.0
claude-world/director-mode-lite100MIT
DawitLemmaBalcha/agent-workflow100MIT
zhinkgit/embeddedskills100MIT

Migawka bazy z 13.11.2026 · wersja paczki f85edc103059 (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

  • 90implement-slice
    Pomaga pisać kod z agentem AI dla wycinka mającego specyfikację: najpierw testy, najmniejsza zmiana i małe commity.
  • 95shipwright-iterate
    Prowadzi lekki cykl SDLC dla zmian w gotowych projektach Shipwright: funkcje, poprawki, refaktoryzacje i ulepszenia.
  • 95fix
    Naprawia jeden błąd z tablicy bez iteracji: najpierw test, który nie przechodzi, potem najmniejsza poprawka i jeden pull request.
  • 100verify-before-done
    Dowodzi, że zmiana w kodzie działa, uruchamiając build, typy, lint i testy oraz sprawdza interfejs w przeglądarce.
  • 100test-first
    Wymusza dyscyplinę red-green-refactor przy funkcjach, poprawkach i refaktoryzacji: padający test, najmniejsza zmiana i obowiązkowe pokazanie wyników uruchomienia testów.
  • 100executing-plans
    Implementuje kod według specyfikacji i testów: najpierw test, który nie przechodzi, a potem zmiana, z dowodem przed domknięciem.

Uwagi i zgłoszenia

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