Kontraktet
ecosystem.yaml — en fil som varje del läser
Nio komponenter, fyra repon och en webbplats är överens om ett valv. De är överens för att de läser samma fil, inte för att någon kom ihåg att hålla dem i takt.
ecosystem.yaml deklarerar delarna och vad var och en läser och skriver, varje
sökväg i valvet med sina skribenter och läsare, de uppräkningar flera verktyg måste vara
överens om, och 19 regler som var och en bär en deklarerad styrka. Den här sajten
renderar den. Det gör README också, och ramverkets eget hjälpkommando.
Varför en fil och inte dokumentation
För att dokumentation är en kopia. Versionsnumret på den här sidan satt en gång i en Python-konstant och hann bli två releaser gammalt utan att någon märkte det, vilket inte är en berättelse om slarv — det är vad en andra kopia gör.
Regeln kontraktet tillämpar på sig självt: deklarerat en gång, renderat av många, återberättat av ingen. Där du ser ett faktum på den här sajten kom det ur filen.
Tre versionsnummer, och varför de inte ska vara lika
Den vanligaste feltolkningen är att de borde matcha. De mäter olika saker.
| Nummer | I dag | Vad det är |
|---|---|---|
core_skills_version | 1.89.4 | kontraktet och ramverket — ett nummer, ett repo |
contract_version | 41 | hur många gånger FORMEN ändrats. Additiva ändringar bumpar det; en skill-fix gör det inte |
| den här sajtens bygge | 2.0.0-alpha | oberoende. Det säger vad som är deployat här, inte var ramverket står |
En konsument som pinnar en ramverksversion påstår något den inte kan veta. En konsument som läser kontraktet kan inte ha fel om det. Det är skillnaden den här sidan finns för.
Läs vidare
- De 19 konventionerna — och vad en nivå faktiskt förpliktar till
- Valvet — 36 deklarerade sökvägar, med skribenter och läsare
- Kontrollerna — inklusive vad de inte kan se
Ur ecosystem.yaml, kontrakt 41 · core-skills 1.89.4 · läst vid bygge 2026-10-08