Przejdź do treści
Biblioteka skilli
Programowanie · Budowanie i kod

self-commenting

/self-commenting

Zostawia w kodzie wyszukiwalne znaczniki AICODE dla pamięci między sesjami: notatki, nieoczywistą logikę i poprawki błędów.

Repozytorium
mvp-builder ↗
Licencja
MIT
Ostatnia zmiana repozytorium
06.09.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 06.09.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

Zostawia w kodzie wyszukiwalne znaczniki AICODE dla pamięci między sesjami: notatki, nieoczywistą logikę i poprawki błędów.

Oryginalny opis (EN)

AI-native code commenting system with grep-searchable AICODE-* markers for cross-session memory. Use when: working with code files, leaving notes for future sessions, breaking down complex tasks, documenting non-obvious logic, recording bug fixes. Triggers: start coding session, edit code, complex logic, leave note, todo for later, debug session, bug fix, AICODE markers, self-commenting.

Jak działa

  1. Process
  2. Step 1: Scan
  3. Step 2: Work
  4. Step 3: Annotate
  5. Decision Rules
  6. Session Workflow
Sekcje z nagłówków SKILL.md, w oryginale · 63 linii, 200 słów
Podgląd SKILL.md
---
name: self-commenting
description: "AI-native code commenting system with grep-searchable AICODE-* markers for cross-session memory. Use when: working with code files, leaving notes for future sessions, breaking down complex tasks, documenting non-obvious logic, recording bug fixes. Triggers: start coding session, edit code, complex logic, leave note, todo for later, debug session, bug fix, AICODE markers, self-commenting."
---

# Self-Commenting

Long-term memory layer in code using grep-searchable AICODE-* markers.

## Process

**SCAN → WORK → ANNOTATE**

## Step 1: Scan

Before modifying any file, find existing markers:

```bash
grep -rn "AICODE-" <file-or-directory>
```

Read markers to understand previous context and pending tasks.

## Step 2: Work

Edit code normally.

## Step 3: Annotate

Add markers for cross-session memory:

- `AICODE-NOTE` — critical implementation details
- `AICODE-TODO` — pending tasks to complete
- `AICODE-FIX` — non-trivial bug solutions (problem → cause → fix)

See `references/conventions.md` for format, language syntax, and examples.

## Decision Rules

### Add AICODE-NOTE when:
- Non-obvious algorithm or approach
- External API constraints
- Complex state management
- Integration quirks

### Add AICODE-TODO when:
- Task out of current scope
- Needs more information
- Depends on other work

### Add AICODE-FIX when:
- Bug solution was non-trivial
- Root cause wasn't obvious
- Similar bugs might occur elsewhere

### Skip markers when:
- Code is self-explanatory
- Standard pattern usage
- Trivial one-line fix

## Session Workflow

**Start:** `grep -rn "AICODE-" src/`

**Before debugging:** Check for similar `AICODE-FIX` in codebase

**End:** Add TODO for incomplete work, NOTE for key decisions, FIX for solved bugs
Pliki w paczce (2)
  • SKILL.md 2 KB
  • references/conventions.md 3 KB

Wersje

W bazie nie ma innych skilli o nazwie self-commenting.

Identyczna treść występuje jeszcze w 1 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

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

  • 100code-analyzer
    Analizuje bazę kodu, aby zbudować model mentalny struktury projektu, zależności i kontekstu implementacji: architektura, moduły współdzielone, ścieżki wykonania i znaczniki AICODE-*.
  • 100self-explanatory-code-commenting
    Podpowiada, jak pisać samoopisujący się kod z mniejszą liczbą komentarzy, w dowolnym języku programowania.
  • 80Global Commenting
    Prowadzi do kodu, który dokumentuje się sam dzięki nazwom i strukturze, z minimalnymi komentarzami wyjaśniającymi, dlaczego coś jest zrobione.

Uwagi i zgłoszenia

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