Meebouwen
De engine is nog niet publiek, dus deze pagina beschrijft hoe bijdragen werken zodra hij opengaat, niet hoe je vandaag een PR indient. Een paar conventies houden de bijdrage-loop straks soepel.
Waar te beginnen
CLAUDE.mdin de repo voor de developer-guide (architectuur, conventies, huidige staat)docs/VISION.mdvoor de product-filosofietests/directory voor ~500 tests die het beoogde gedrag demonstreren
De workflow
- Fork de repo, branch af van
main. - Schrijf eerst een falende test wanneer de wijziging gedrag-gebaseerd is. Soriku volgt RCT-disciplines (Red, Commit, Green).
- Houd de PR focused: één feature of fix per PR, geen grab bag.
- Draai
python -m pytest tests/ -vvoor je pusht. - Open de PR met het test plan in de beschrijving.
Engineering-principes
- RCT discipline: falende test eerst, kleinst mogelijke commit, dan groen maken
- Determinisme boven cleverness: de router en benchmarks moeten reproduceerbaar zijn
- Gemeten, niet geclaimd: capability-wijzigingen vereisen benchmark-bewijs
- Lokaal-eerst: features die alleen in cloud-mode werken gaan achter een heldere feature gate
- Eerlijkheid in errors: slik exceptions niet, surface root causes
- Compacte diffs: kleine PRs reviewen en mergen sneller
Deze docs verbeteren
De docs op deze site zijn handgeschreven en worden bijgewerkt op basis van de interne referentiematerie van de engine (API-oppervlak, persona-definities, config-schema) zodra die verandert.
Security-issues
Open geen publieke issues voor security-vulnerabilities. Mail security@atypisch.nl. Gecoördineerde disclosure binnen 90 dagen.