dev-review
/dev-review
Czyta architekturę, specyfikacje i plan w zestawieniu z kodem i wystawia uszeregowaną listę ustaleń, bez zmian w projekcie.
- Autor
- HarunRRayhan ↗
- Repozytorium
- RayStack ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 06.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 1
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 06.11.2026, bez odwołań do wycofanych modeli i API.
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
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. Read
- 2. Check
- 3. Rank and report
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
| Repozytorium | Wynik | Licencja |
|---|---|---|
| Ta strona · HarunRRayhan/RayStack | 90 | MIT |
| nchandar/dev-kit | 100 | MIT |
| pdl-openair/OpenAIR | 100 | Apache-2.0 |
| lflish/devflow | 100 | MIT |
| codeaholicguy/ai-devkit | 90 | Apache-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.