self-commenting
/self-commenting
Zostawia w kodzie wyszukiwalne znaczniki AICODE dla pamięci między sesjami: notatki, nieoczywistą logikę i poprawki błędów.
- Autor
- petbrains ↗
- Repozytorium
- mvp-builder ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 06.09.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 2
- Skrypty
- 0
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 06.09.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
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
- Process
- Step 1: Scan
- Step 2: Work
- Step 3: Annotate
- Decision Rules
- Session Workflow
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.