Przejdź do treści
Biblioteka skilli
Zarządzanie i produkt · Przegląd i audyt

dev-gaps

/dev-gaps

Wskazuje dokumenty, których brakuje istniejącemu projektowi, i uzupełnia je na podstawie kodu oraz pytań do zespołu.

Repozytorium
RayStack ↗
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
1
Skrypty
0
Komentarze HTML
0
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 robi i kiedy

Wskazuje dokumenty, których brakuje istniejącemu projektowi, i uzupełnia je na podstawie kodu oraz pytań do zespołu.

Wyzwalacze z opisu

what docs is this project missingdocument this existing codebaseadd a PRD to this repo
Oryginalny opis (EN)

Find which dev-flow documents an existing project is missing (research, PRD, architecture, tech specs, plan, decisions) and fill them, drafted from the code where it can and asked where it cannot. Use for "/raystack project update", "/raystack project gaps", "what docs is this project missing", "document this existing codebase", "add a PRD to this repo".

Jak działa

  1. 1. Inventory
  2. 2. Ask what to fill
  3. 3. Finish
Sekcje z nagłówków SKILL.md, w oryginale · 56 linii, 506 słów
Podgląd SKILL.md
---
name: dev-gaps
description: Find which dev-flow documents an existing project is missing (research, PRD, architecture, tech specs, plan, decisions) and fill them, drafted from the code where it can and asked where it cannot. Use for "/raystack project update", "/raystack project gaps", "what docs is this project missing", "document this existing codebase", "add a PRD to this repo".
---

# Dev gaps

This skill brings an existing project up to the RayStack dev flow. It reads the code, lists
what is missing, then fills each gap with the matching `dev-*` skill. It writes documents
only, never code. Formats and question rules are in `../dev/references/dev-contract.md`.

## 1. Inventory

Read `AGENTS.md`, `DECISIONS.md` and `docs/` if they exist, then the code: the README, the
manifests (`package.json`, `composer.json`, `go.mod`, `Cargo.toml`, `pyproject.toml`...),
the entry points, routes, models or schema, jobs, tests, CI and deploy files. Never open
`.env*` files (`.env.example` is fine), `*.tfstate*` or credential files.

Fill this table and show it to the user:

| Artifact | Where | Status |
| --- | --- | --- |
| Hub files | `AGENTS.md`, `DECISIONS.md` | present / missing |
| Research | `docs/research/` | present / missing / stale (older than the stack in use) |
| PRD | `docs/prd/` | present / missing / partial (behaviours with no B-ID) |
| Architecture | `docs/architecture/system-overview.md` | present / missing / drifted |
| Tech specs | `docs/tech-spec/` | per area: present / missing / drifted |
| Principles | `docs/principles.md` | present / missing |
| Plan and ledger | `docs/plans/` | none / open (unfinished ledger) / shipped |

Drifted means the document names a part, route, table or service the code no longer has, or
the code has a major part the document does not name. Give one example per drift with
file:line.

## 2. Ask what to fill

Ask once through the question tool: fill every gap (recommended), pick which, or stop at the
table. Then fill in this order, skipping what is present:

1. **Hub:** `dev-hub` single-repo steps. Never replace an existing `AGENTS.md`; append.
2. **PRD from behaviour:** draft B-IDs from the routes, screens, jobs and tests that exist.
   Each line cites the file it came from. Then ask, one question per call, only what code
   cannot tell: who it is for, goals, non-goals, anti-goals. `dev-prd` checks the result.
3. **Architecture as built:** `dev-spec` writes `system-overview.md` from the code, with the
   `## Stack` table read from the manifests and logged as `D-` rows ("as found in code", with
   the file as the way to confirm). Do not re-decide the stack.
4. **Tech specs as built:** one area spec per area with real design, each with `Serves:`
   the B-IDs from step 2 and `Status: as-built. Date: YYYY-MM-DD.`
5. **Research:** only if the user wants it; `dev-research` on the market or on the stack.

A drifted document is updated, never rewritten: change the lines that are wrong, add a dated
`D-` row for each real change and keep the rest.

## 3. Finish

Report the table again with the new status, the files written, the B-ID count, open
`[NEEDS CLARIFICATION]` markers and the `D-` rows added. Ask the user to review. Then offer
the next step: `dev` Standard for the next slice, `dev-review` to check the plan and the
architecture against the code, `dev-migrate` to move part of the stack, or `dev-refactor` to clean up the code.

Wersje

W bazie nie ma innych skilli o nazwie dev-gaps.

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

  • 90dev
    Prowadzi przepływ RayStack od pomysłu do wysyłki: nowe projekty, plany funkcji, naprawy błędów i przegląd stanu projektu.
  • 90dev-hub
    Zakłada strukturę projektu dla przepływu RayStack: AGENTS.md, DECISIONS.md i foldery dokumentów, w jednym repo lub w centrum bez kodu.
  • 90code-to-prd
    Odtwarza PRD z istniejącego kodu, opisując, co aplikacja już robi, zamiast zaczynać od opisanego pomysłu.
  • 100project-specs-reconciliation
    Tworzy lub aktualizuje dokumentację PRD i ADR przed implementacją, uzgadniając wymagane zachowanie, kryteria akceptacji, decyzje architektoniczne i kompromisy techniczne w katalogach docs/PRD i docs/ADR.
  • 100write-a-prd
    Tworzy PRD na podstawie wywiadu z użytkownikiem, analizy kodu i projektu modułów, a następnie zgłasza go jako issue na GitHubie.
  • 100write-a-prd
    Tworzy PRD na podstawie wywiadu z użytkownikiem, analizy kodu i projektu modułów, a następnie zgłasza go jako issue na GitHubie.

Uwagi i zgłoszenia

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