context-docs
/context-docs
Tworzy trwały kontekst dla podsystemu, przeznaczony dla przyszłych agentów i inżynierów, gdy granice i niezmienniki ciągle trzeba odkrywać od nowa.
- Autor
- yeaight7 ↗
- Repozytorium
- agent-powerups ↗
- Licencja
- Apache-2.0
- Ostatnia zmiana repozytorium
- 27.09.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 27.09.2026, bez odwołań do wycofanych modeli i API.
Apache-2.0, otwarta: można używać i zmieniać, z zachowaniem licencji i informacji o zmianach.
Co robi i kiedy
Tworzy trwały kontekst dla podsystemu, przeznaczony dla przyszłych agentów i inżynierów, gdy granice i niezmienniki ciągle trzeba odkrywać od nowa.
Oryginalny opis (EN)
Use when a subsystem needs persistent context for future agents or engineers -- its boundaries keep being rediscovered the hard way, invariants keep getting violated, or sessions repeatedly ask the same questions about it.
Jak działa
- Purpose
- When to Use
- Inputs
- Workflow
- Output
- Verification
- Failure Modes
Podgląd SKILL.md
--- name: context-docs description: Use when a subsystem needs persistent context for future agents or engineers -- its boundaries keep being rediscovered the hard way, invariants keep getting violated, or sessions repeatedly ask the same questions about it. --- ## Purpose Large centralized documentation files consume too much context window. Decentralized, module-specific context docs provide targeted information exactly when an agent needs it. ## When to Use - A module's boundaries or invariants keep being rediscovered the hard way - Onboarding or agent sessions repeatedly ask the same questions about a subsystem - After a refactor changed how a module communicates with the rest of the app ## Inputs - The subsystem directory and its public interface - Existing docs, to avoid duplicating the central README or architecture docs ## Workflow 1. **Decide where the context belongs.** Module-specific knowledge goes in a context file *inside* the subsystem directory (e.g., `src/auth/CONTEXT.md`); repo-wide knowledge belongs in the central README or architecture docs — one home per fact, never both: ```bash find src -iname "CONTEXT.md" -o -iname "README.md" # existing context docs rg -ln "<module name>" docs/ # already documented centrally? ``` 2. **Document only the boundaries.** How does this module communicate with the rest of the app? What are its critical invariants? Not implementation detail the code already states. 3. **Keep it terse.** Bullet points and exact file paths. No transient notes — session state, TODO lists, and progress logs belong in handoff documents, not context docs. 4. **Validate every path the doc references:** ```bash rg -no "src/[A-Za-z0-9_./-]+" src/auth/CONTEXT.md | sort -u # referenced paths test -f src/auth/session.ts && echo OK # confirm each exists ``` 5. **Update these files inline when refactoring the module.** A context doc that lags the refactor is worse than none. ## Output - A short, boundary-focused context file inside the subsystem directory - Stale or central-doc-duplicating content removed or relocated ## Verification - [ ] Doc lives inside the subsystem it describes - [ ] Content is boundaries and invariants, not implementation detail or transient notes - [ ] Every referenced file path verified to exist - [ ] No duplication of central docs — one home per fact - [ ] Doc updated in the same change set as the refactor that affected it ## Failure Modes - **Context dumping** — pasting session notes or progress logs into a context doc; that is a handoff, not context. - **Central duplication** — the same fact in the central README and the module doc, guaranteed to diverge. - **Path rot** — referenced files moved since the doc was written; validate paths on every touch. - **Novel-length context** — if it doesn't fit on a screen, agents won't load it when they need it.
Wersje
W bazie nie ma innych skilli o nazwie context-docs.
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 803063a0ec03 (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
- 100documentation-and-adrs
Zapisuje decyzje projektowe i kontekst dla przyszłych inżynierów oraz agentów przy zmianach w architekturze. - 100documentation-and-adrs
Prowadzi zapis decyzji architektonicznych i dokumentacji przy zmianach publicznych API i wdrażaniu funkcji, utrwalając kontekst dla przyszłych inżynierów i agentów. - 100architecture-md-writer
Pisze lub sprawdza plik ARCHITECTURE.md dla agentów: granice, niezmienniki z poleceniami weryfikacji i przewodnik po zmianach.