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

project-standards

/project-standards

Tworzy i pilnuje pakietu standardów kodowania projektu, żeby kod pisany przez Claude zgadzał się ze stosem i regułami w kolejnych sesjach.

Repozytorium
claude-skills ↗
Licencja
MIT
Ostatnia zmiana repozytorium
03.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
14
Skrypty
1
Komentarze HTML
0
Adresy URL w SKILL.md
1
Przestarzałość

Brak sygnałów. Repozytorium zmienione 03.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 sprawdzić przed instalacją
  • 1 skrypt w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.

Skrypty: scripts/check_rules.py

Co robi i kiedy

Tworzy i pilnuje pakietu standardów kodowania projektu, żeby kod pisany przez Claude zgadzał się ze stosem i regułami w kolejnych sesjach.

Wyzwalacze z opisu

our stackproject rules
Oryginalny opis (EN)

Create and enforce a project's coding standards pack, so code Claude writes stays consistent with the locked stack, architecture and rules across sessions. Use when the user wants to set up conventions or guardrails for a codebase, asks Claude to follow "our stack" or "project rules", or when a repo already has a standards pack in .claude/skills and code is being written or reviewed.

Jak działa

  1. Mode 1: create a pack
  2. Mode 2: build with a pack
  3. Mode 3: change a decision
  4. Mode 4: review
  5. Worked example
Sekcje z nagłówków SKILL.md, w oryginale · 52 linii, 567 słów
Podgląd SKILL.md
---
name: project-standards
description: Create and enforce a project's coding standards pack, so code Claude writes stays consistent with the locked stack, architecture and rules across sessions. Use when the user wants to set up conventions or guardrails for a codebase, asks Claude to follow "our stack" or "project rules", or when a repo already has a standards pack in .claude/skills and code is being written or reviewed.
---

# Project Standards

AI coding assistants drift. Across sessions they swap libraries, invent folder layouts, skip validation and forget decisions made last week. This skill fixes that with a **standards pack**: three small project skills plus a progress log, kept in the repo and read before any code is written.

```
.claude/
├── skills/
│   ├── <project>-build/SKILL.md      master: locked decisions, layout, session rules
│   ├── <project>-frontend/SKILL.md   UI detail layer + definition of done
│   └── <project>-backend/SKILL.md    server/data detail layer + definition of done
└── standards-rules.json              machine-checkable rules (optional)
PROGRESS.md                           living build log, read at the start of every session
```

The build skill is the shared source of truth. The frontend and backend skills add detail and never contradict it. Project docs (`docs/*.md`) win over all three. When they disagree, follow the docs and tell the user about the drift.

## Mode 1: create a pack

1. **Read the repo first.** `package.json` or equivalent, config files, folder layout, existing docs, README, and any existing `.claude/` or `CLAUDE.md`. Record what is already decided by the code itself.
2. **Interview for the gaps.** Ask only about decisions the repo does not answer. Group them so it takes one or two rounds. The checklist is in `references/decision-checklist.md`. Typical gaps: UI library or hand-built, auth provider, migration tool, hosting target, tenancy, money and date handling, i18n, audit and deletion policy.
3. **Write the pack** from `templates/`. Fill every placeholder. Rules must be specific and testable:
   - Weak: "Write secure code."
   - Strong: "Every mutation re-checks the user's role server-side, even when middleware already did."
4. **Write a definition of done** at the end of the frontend and backend skills. Each item must be checkable by reading a diff.
5. **Add machine rules** for anything a regex can catch (hard-coded colours, banned imports, literal brand names) in `.claude/standards-rules.json`. See `references/rules-format.md`.
6. **Create `PROGRESS.md`** from `templates/PROGRESS.md` with the current stage and the next 3 to 5 tasks.
7. Show the user the locked-decisions table for confirmation before saving.

## Mode 2: build with a pack

When the repo has a pack, follow this loop for every coding task:

1. Read `PROGRESS.md`, then the build skill, then the frontend or backend skill for the area being changed.
2. Before writing code, name the locked decisions that apply. If the request conflicts with one, stop and ask. Never quietly deviate.
3. Write the code.
4. Run `python3 <skill-dir>/scripts/check_rules.py` from the repo root if `standards-rules.json` exists, and fix every finding.
5. Walk the definition of done for each area touched, item by item.
6. Update `PROGRESS.md`: move finished items to Done, add new decisions or gotchas, update "Last updated". A change without a progress update is incomplete.

## Mode 3: change a decision

The user may revise any locked decision. When they do, update the relevant `docs/*.md`, the build skill, the detail skill and the rules file in the same change, and log the decision with its reason in `PROGRESS.md`.

## Mode 4: review

To review a branch or PR against the pack, run the rule checker on the changed files, then check the diff against each definition-of-done item and list findings as: rule broken, file and line, suggested fix.

## Worked example

`examples/suwa/` is the full pack from [Suwa](https://github.com/thusalapi/Suwa), a self-hosted clinic management system built with Next.js, PostgreSQL, Drizzle and Liquibase. Use it as a reference for the level of detail a good pack needs.
Pliki w paczce (14)
  • README.md 3 KB
  • SKILL.md 4 KB
  • examples/suwa/README.md 1 KB
  • examples/suwa/.claude/standards-rules.json 2 KB
  • examples/suwa/.claude/skills/suwa-backend/SKILL.md 6 KB
  • examples/suwa/.claude/skills/suwa-build/SKILL.md 6 KB
  • examples/suwa/.claude/skills/suwa-frontend/SKILL.md 6 KB
  • references/decision-checklist.md 2 KB
  • references/rules-format.md 2 KB
  • scripts/check_rules.py 4 KB
  • templates/PROGRESS.md 1 KB
  • templates/backend.md 2 KB
  • templates/build.md 2 KB
  • templates/frontend.md 1 KB

Wersje

W bazie nie ma innych skilli o nazwie project-standards.

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

  • 100audit-standards
    Audytuje bieżący projekt pod kątem standardów programistycznych z ~/.claude/CLAUDE.md, zapisuje niezgodności jako zgłoszenia GitHub i plan poprawek w CLAUDE.md projektu.
  • 100project-conventions
    Tworzy plik CONVENTIONS.md opisujący architekturę, układ, zatwierdzone biblioteki i zasady kodowania na podstawie rzeczywistego kodu.
  • 100architect-foundation
    Ustawia po onboardingu reguły architektury, standardy kodu i guardrails: z project-understanding.md i dialogu sokratejskiego generuje kontrole CI, reguły lint, fitness functions i ADR.
  • 100learn
    Analizuje bazę kodu, odkrywa konwencje, wzorce architektoniczne i standardy kodowania projektu, a następnie generuje pliki reguł w .claude/rules/ dla Claude Code.
  • 100review-setup
    Tworzy lub aktualizuje dokument kontekstu projektu z warstwami, przepływem danych i regułami architektury, na podstawie analizy kodu i odpowiedzi użytkownika.
  • 100coding-standards
    Zawiera kanoniczne odniesienie do wielojęzycznych standardów kodowania, współdzielone przez agentów recenzujących: reguły nazewnictwa i bazowy styl.

Uwagi i zgłoszenia

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