integration-doc-maintainer
/integration-doc-maintainer
Prowadzi dokumentację integracji między modułami przy zmianach zdarzeń, zadań w tle, kontraktów usług i zależności.
- Autor
- eliyce ↗
- Repozytorium
- paqad-ai ↗
- Licencja
- MIT
- Ostatnia zmiana repozytorium
- 12.11.2026
Ocena i bezpieczeństwo
- Pliki w paczce
- 9
- Skrypty
- 3
- Komentarze HTML
- 0
- Adresy URL w SKILL.md
- 0
Brak sygnałów. Repozytorium zmienione 12.11.2026, bez odwołań do wycofanych modeli i API.
MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.
- 3 skrypty w paczce. Przejrzyj je przed instalacją, bo Claude może je uruchomić.
Skrypty: scripts/extract-events.sh, scripts/find-integration-docs.sh, scripts/lint-output.sh
Co robi i kiedy
Prowadzi dokumentację integracji między modułami przy zmianach zdarzeń, zadań w tle, kontraktów usług i zależności.
Oryginalny opis (EN)
Maintains cross-module integration documentation. Use when a request affects published or consumed events, background jobs, external service contracts or any cross-module dependency.
Jak działa
- What It Does
- Use This When
- Inputs
- Procedure
- Output Contract
- Escalate / Stop Conditions
- Resources
Podgląd SKILL.md
--- name: integration-doc-maintainer description: 'Maintains cross-module integration documentation. Use when a request affects published or consumed events, background jobs, external service contracts or any cross-module dependency.' metadata: model_tier: medium max_lines: '200' cacheable: 'false' output_format: markdown paqad-meta: skill.meta.yaml --- ## What It Does Maintains cross-module integration docs by documenting events, jobs, contracts, and fallback behavior for any change that crosses module or service boundaries. ## Use This When When a request affects published events, consumed events, background jobs, external service contracts, or any cross-module dependency. ## Inputs - Read the current integration docs first: `integration/events.md` and `integration/contracts.md` for the affected module. - Read the changed code and any generated event inventory or contract references. - Read `references/integration-contract-fields.md` before updating entries. ## Procedure 1. Run `scripts/find-integration-docs.sh` to enumerate canonical events/contracts/jobs/integration docs. 2. Run `scripts/extract-events.sh <changed-files...>` to surface candidate event names; LLM confirms each before writing. 3. Update each event entry using `assets/event.template.md` (publisher, subscribers, payload, async behavior, failure expectations, versioning). 4. Update contracts with owner, versioning, and fallback/degradation behavior. Document both sides of every cross-module coupling. 5. Format report per `assets/output.template.md` and validate with `scripts/lint-output.sh`. Missing fallback / undocumented coupling → `## Consistency Warnings`, never silent. ## Output Contract - Match `assets/output.template.md`: `## Updated Integration Docs` and `## Consistency Warnings`. - Every updated item must name the event, contract, job, or integration path and the canonical doc path changed. - Output must pass `scripts/lint-output.sh` (exit 0). - Missing fallback behavior, subscriber ownership, or compatibility policy belongs under `Consistency Warnings`, never as an invented completed entry. ## Escalate / Stop Conditions - Ask when subscriber ownership, contract versioning, or fallback policy is unclear. - Warn when a new integration path has no documented recovery or compatibility posture. - Do not invent event payloads or subscriber lists that are not evidenced by the code or project docs. ## Resources - `references/integration-contract-fields.md` - `scripts/find-integration-docs.sh` - `scripts/extract-events.sh` - `scripts/lint-output.sh` - `assets/output.template.md` - `assets/event.template.md` - `runtime/templates/runner-scripts/extract-events.sh.hbs` - `agents/openai.yaml`
Pliki w paczce (9)
- SKILL.md 3 KB
- skill.meta.yaml 1 KB
- agents/openai.yaml 1 KB
- assets/event.template.md 1 KB
- assets/output.template.md 1 KB
- references/integration-contract-fields.md 1 KB
- scripts/extract-events.sh 1 KB
- scripts/find-integration-docs.sh 1 KB
- scripts/lint-output.sh 1 KB
Wersje
W bazie nie ma innych skilli o nazwie integration-doc-maintainer.
Migawka bazy z 13.11.2026 · wersja paczki ff79c2cd3789 (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
- 90api-doc-maintainer
Utrzymuje dokumentację API modułu: aktualizuje endpointy, ładunki, zasady uwierzytelniania i błędy po każdej zmianie. - 90may-tech-lead
Ocenia kompromisy architektoniczne, kontrakty między modułami i kolejność integracji przy zmianach wymagających decyzji technicznych. - 90error-catalog-maintainer
Prowadzi katalogi błędów dla modułów: dopisuje kody, aktualizuje komunikaty i ścieżki odzyskiwania po zmianach w kodzie. - 100architecture
Mapuje architekturę projektu: zależności między modułami, sprzężenie, graf zależności i granice modułów. - 100add-integration-event
Publikuje zdarzenie integracyjne między modułami przez Outbox i obsługuje je idempotentnie w innym module, gdy jeden moduł musi zareagować na zdarzenie z drugiego. - 100native-integration
Przegląda pracę nad natywnymi modułami React Native, uprawnieniami i zadaniami w tle: integracje API platformy, kamera, biometria, pliki oraz granica mostu lub Turbo Module.