Przejdź do treści
Biblioteka skilli
Programowanie · Pisanie

design-doc

/design-doc

Pisze dokument projektu systemu lub RFC dla funkcji albo szybko sprawdza luki w istniejącym: wymagania, ograniczenia, architektura, model danych, API, wdrożenie i ryzyka.

Licencja
MIT
Ostatnia zmiana repozytorium
15.10.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
2
Skrypty
0
Komentarze HTML
0
Adresy URL w SKILL.md
0
Przestarzałość

Brak sygnałów. Repozytorium zmienione 15.10.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

Pisze dokument projektu systemu lub RFC dla funkcji albo szybko sprawdza luki w istniejącym: wymagania, ograniczenia, architektura, model danych, API, wdrożenie i ryzyka.

Oryginalny opis (EN)

Use when the user wants a system design doc or RFC written for a feature, or a quick gap check of one: requirements, constraints, architecture, data model, APIs, rollout, and risks. A rigorous multi-expert review before implementation belongs to spec-panel.

Jak działa

  1. Modes
  2. Rules
  3. Workflow context
  4. Output contract
Sekcje z nagłówków SKILL.md, w oryginale · 35 linii, 366 słów
Podgląd SKILL.md
---
name: design-doc
description: "Use when the user wants a system design doc or RFC written for a feature, or a quick gap check of one: requirements, constraints, architecture, data model, APIs, rollout, and risks. A rigorous multi-expert review before implementation belongs to spec-panel."
---

# Design doc (RFC)

A design doc decides how a feature or system will be built, with the alternatives weighed. It takes the what and why from a `prd` as given; a single decision that needs a lasting record goes in an `adr`.

## Modes
- **Write**: produce the doc from `assets/design-doc.md`, keeping only the sections this design needs.
- **Review**: for an existing doc, list concrete gaps and proposed fixes in severity order; do not rewrite it unasked.

Ask only what is missing: the problem and user, 1-3 measurable outcomes, hard constraints (deadline, compatibility, latency, cost, compliance), and what is out of scope. Read the code the design touches before proposing anything; reuse existing modules and framework features before adding components.

## Rules
- Requirements and non-goals before architecture.
- At least two real alternatives, including "extend what exists" when it is plausible, each with honest trade-offs. No straw men.
- Data model first: entities, ownership, keys, access patterns. Follow the house rules where the stack applies: money as `BigDecimal` / `NUMERIC`, time as `Instant` or `OffsetDateTime` / `TIMESTAMPTZ`, internal IDs as TSID `BIGINT`, external IDs as UUIDv7, API errors as RFC 9457 Problem Details. Leave schema and contract detail to `data-design`, `api-design`, and `db-migration`.
- For each external call or async step, state its failure semantics (timeout, duplicate, partial success, unknown outcome) and what the system does then. Choose retries, idempotency, or compensation from those semantics; never assume success.
- Rollout covers compatibility, migration, and a rollback or restore path. Feature flags, staged exposure, and new dashboards only when the risk calls for them.
- Test strategy names the business behaviors and failure modes to prove, not a layer checklist.
- End with open questions (owner each) and a 5-10 item review checklist reviewers can verify quickly.

## Workflow context
- `prd` says what and why; `design-doc` says how; `adr` records one decision; `decision-matrix` compares options when the choice is hard.
- Depth lives in `api-design`, `data-design`, `infra-design`, `migration-plan`.
- Feeds `ticket-breakdown`, `test-plan`, `security-review`, `performance-review`, `spec-to-impl`.

## Output contract
```yaml
produces:
  - type: "design-doc"
    format: "markdown"
    path: "claudedocs/<feature>-design-doc.md"
    sections: [requirements, architecture, data_model, apis, rollout, risks]
    handoff: "Write claudedocs/handoff-design-doc-<timestamp>.yaml - suggest: spec-to-impl, test-plan, security-review"
```
Pliki w paczce (2)
  • SKILL.md 3 KB
  • assets/design-doc.md 2 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · omexit/claude-skills-pack100MIT
userKael/rastro100MIT
hxxnn/codemap100MIT
lamngockhuong/aiteamkit100MIT
bdfinst/agentic-dev-team100MIT

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

  • 100tech-design-doc
    Pisze, szkicuje i audytuje dokument projektowy, RFC lub ADR, także dla zewnętrznych partnerów, z przygotowaniem do przeglądu architektury.
  • 100writing-rfc
    Pisze RFC lub dokument projektowy z podsumowaniem na początku, celami, poza zakresem, alternatywami i otwartymi pytaniami.
  • 100engineer-design-review
    Przegląda dokument projektowy, RFC lub plan budowy według listy kontrolnej: migracje, wycofanie zmian, obsługa błędów i ewaluacje.
  • 100tech-design-generation
    Generuje profesjonalne dokumenty projektu technicznego (design doc, RFC, dokument architektury) według praktyk branżowych, w tym formatu Google Design Doc.
  • 100rfc
    Pisze krótki RFC projektu: dopytuje o problem, cele, ograniczenia i opcje, czyta kod i zapisuje dokument Markdown w folderze RFC.
  • 100design-docs
    Pisze i przegląda dokumenty projektowe RFC oraz ADR z celami, alternatywami, ryzykiem, bezpieczeństwem, wdrożeniem i obserwowalnością.

Uwagi i zgłoszenia

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