Przejdź do treści
Biblioteka skilli
Programowanie · Przegląd i audyt

dev-review

/dev-review

Czyta architekturę, specyfikacje i plan w zestawieniu z kodem i wystawia uszeregowaną listę ustaleń, bez zmian w projekcie.

Repozytorium
RayStack ↗
Licencja
MIT
Ostatnia zmiana repozytorium
06.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 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

Czyta architekturę, specyfikacje i plan w zestawieniu z kodem i wystawia uszeregowaną listę ustaleń, bez zmian w projekcie.

Wyzwalacze z opisu

review the architecture against the docsreview the plandoes the code match the specis the plan still right
Oryginalny opis (EN)

Read-only mid-build review of a project's architecture, tech specs and plan against the code, with a ranked findings report. Use for "/raystack project review", "review the architecture against the docs", "review the plan", "does the code match the spec", "is the plan still right".

Jak działa

  1. 1. Read
  2. 2. Check
  3. 3. Rank and report
Sekcje z nagłówków SKILL.md, w oryginale · 54 linii, 442 słów
Podgląd SKILL.md
---
name: dev-review
description: Read-only mid-build review of a project's architecture, tech specs and plan against the code, with a ranked findings report. Use for "/raystack project review", "review the architecture against the docs", "review the plan", "does the code match the spec", "is the plan still right".
hooks:
  PreToolUse:
    - matcher: Bash
      hooks:
        - type: command
          command: 'for f in "${CLAUDE_PLUGIN_ROOT}/skills/raystack/hooks/readonly-guard.sh" "${CLAUDE_PLUGIN_ROOT}/../raystack/hooks/readonly-guard.sh" "$HOME/.claude/skills/raystack/hooks/readonly-guard.sh"; do [ -x "$f" ] && exec "$f"; done; echo "RayStack review is read-only: guard missing" >&2; exit 2'
---

# Dev review

Check the design documents against each other and against the code, in the middle of a
build. Report only: never edit code, specs, plans or ledgers. Formats are in
`../dev/references/dev-contract.md`; the report follows
`../raystack/references/report-template.md` with skill `project-review`: `Est. $/mo` is
`n/a`, and each fix is a document or task edit, not a code diff.

## 1. Read

`DECISIONS.md`, the PRD's behaviour contract, `docs/architecture/`, `docs/tech-spec/`,
`docs/principles.md`, the newest plan and its ledger, then the code those documents name.
If there is no architecture, spec or plan, write a short report that lists what is missing,
offer `dev-gaps` and stop there.

## 2. Check

**Architecture**
1. Every part, store and service in the overview exists in the code, and every major part
   in the code is in the overview (drift, with file:line).
2. The code follows the `## Stack` rows and `D-` decisions (a second database, a new
   framework or a service split with no `D-` row is a finding).
3. The Simplicity and Anti-abstraction gates (`dev-spec` section 5, `docs/principles.md`):
   layers, wrappers, services or queues with one user and no `## Complexity` row.
4. Coupling: modules reaching into each other's tables or internals; a cycle between modules.
5. I/O boundaries: database, network and third-party calls sit where the spec says, with the
   failure path the spec names (timeout, retry, error shown).

**Specs and PRD**
6. Every B-ID is served by a spec (`Serves:`) and covered by a plan task or a test.
7. No spec or task contradicts a `Decided` row; open `[NEEDS CLARIFICATION]` markers that
   block work still in `todo`.

**Plan and ledger**
8. Tasks still `todo` fit the code as it is now (they name files and functions that exist).
9. The ledger matches git: `done` rows have their commit; no task stuck `in-progress` with
   no commit for over a week; `done-with-concerns` items were followed up.
10. Order and size: a task that depends on a later task; a task too big to review in one go.

For data access depth (N+1 queries, indexes) point to `performance-review` and
`database-review` rather than repeating them.

## 3. Rank and report

Severity: **Critical** the design or plan will ship wrong behaviour (a B-ID broken or
unserved on a path in use); **High** drift or a broken decision that the next tasks build
on; **Medium** over-design, coupling, a stale task; **Low** wording and tidy-ups. Each
finding has file:line evidence and a fix that names the document or task to change.

Write `reviews/YYYY-MM-DD-project-review.md`. Tell the user the path, the counts per
severity and the top three. To act on it, offer `dev` (replan, section 3) so fixes go
through the plan and the ledger.

Wersje

RepozytoriumWynikLicencja
Ta strona · HarunRRayhan/RayStack90MIT
nchandar/dev-kit100MIT
pdl-openair/OpenAIR100Apache-2.0
lflish/devflow100MIT
codeaholicguy/ai-devkit90Apache-2.0

Migawka bazy z 13.11.2026 · wersja paczki 9d23a2be1ea4 (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.
  • 100dev-spec
    Pisze architekturę i specyfikacje techniczne dla obszarów na podstawie PRD i kopiuje domyślne zasady do projektu.
  • 100tech-spec
    Generuje i przegląda specyfikacje techniczne przy projektowaniu funkcji, z wynikiem w postaci ponumerowanego dokumentu.
  • 9000-spec
    Pisze i aktualizuje specyfikacje techniczne w docs/spec przed kodem: globalną architekturę i opisy modułów.
  • 85plan-eng-review
    Przegląda architekturę, kontrakty, ścieżki awarii, współbieżność i strategię testów planu wdrożenia, zanim powstanie kod.
  • 100architecture
    Tworzy dokument 3-architecture.md z diagramami komponentów, przepływem danych, punktami integracji i decyzjami, na podstawie istniejącej specyfikacji technicznej.

Uwagi i zgłoszenia

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