matematic-spec-driven

name	matematic-spec-driven
description	Spec-Driven Development dla wewnetrznych projektow MateMatic (PATRON, KGLF, POAS, skille, mikroprodukty, aplikacje). Cherry-pick + adaptacja patternu github/spec-kit (MIT) - 4 fazy (Konstytucja -> Specyfikacja -> Plan -> Zadania) plus opcjonalna walidacja. Wbudowany Constitution Check GATE z 4 bramkami MateMatic (licencja / ToS-antyOS / jakosc / strategia). Marker `[P]` dla zadan parallel-safe (fan-out subagentow). Uzywaj gdy zaczynasz nowy projekt MateMatic, dodajesz duza ficzer do PATRON/KGLF, planujesz odcinek serialu wymagajacy formalnego rozbicia zadan, projektujesz nowy mikroprodukt, lub gdy chcesz audytowac istniejacy projekt pod katem zgodnosci z konstytucja MateMatic. Trigger - "spec-driven", "konstytucja projektu", "rozplanuj projekt", "rozbij na zadania", "zaplanuj ficzer", "spec dla projektu", "plan implementacji", "tasks z markerem P", "audyt projektu MateMatic", "Constitution Check". NIE uzywaj dla sprzedazy klientom kancelaria (do tego jest `matematic-konstytucja-ai` - produkt 15-40k PLN).
license	Apache-2.0
allowed-tools	["Read","Write","Glob"]
data-residency	local
requires-human-approval	false
pii-egress	none
metadata	{"author":"Wieslaw Mazur / MateMatic","version":"0.1.0","ratified":"2026-05-20T00:00:00.000Z","project":"MateMatic Internal Dev Pipeline","source_pattern":"github/spec-kit (MIT) v0.8.12.dev0 - 4-phase methodology, marker [P], Constitution Check GATE","related_skill":"matematic-konstytucja-ai (sprzedazowy produkt dla kancelarii, NIE myl)","delivery_format":"pliki markdown w katalogu projektu (.matematic/spec/<feature>/)"}

MateMatic Spec-Driven - dev pipeline dla naszych projektow

Spec-Driven Development dla wewnetrznych projektow MateMatic. NIE produkt sprzedazowy dla kancelarii (tym jest matematic-konstytucja-ai). Tutaj: my, dla siebie, do PATRON / KGLF / POAS / skilli / mikroproduktow / aplikacji / serialu.

Source pattern: github/spec-kit (MIT) v0.8.12 - 4-fazowa methodology Constitution -> Specify -> Plan -> Tasks z marker [P] i Constitution Check GATE. Cherry-pick wybranych elementow + adaptacja pod MateMatic project types.

Status: v0.1.0 - faza C adopcji spec-kit (po fazie B = sandbox install 2026-05-20). Walidacja w boju przy 1-2 projektach (rekomendacja: nowy konektor SAOS w PATRON albo Biblioteka EPUB v3).

---

Kiedy uzywac

✅ TAK:

• Nowy projekt MateMatic od zera (nowy mikroprodukt, aplikacja, agent)
• Duza ficzer w istniejacym projekcie (PATRON / KGLF / www-matematic)
• Skill ktory ma 4+ podkomendy i zaleznosci (np. matematic-video-pipeline)
• Odcinek serialu "Nie tylko dla orlow" wymagajacy formalnego rozbicia (6-9 scen, fan-out subagentow)
• Audyt istniejacego projektu - czy ma konstytucje? czy ficzer zgadza sie z konstytucja?

❌ NIE:

• Sprzedaz kancelarii (uzyj matematic-konstytucja-ai)
• Krotki post LI / aktualnosc BW (uzyj edit-article albo linkedin-voice-wieslaw-mazur)
• Pojedynczy bugfix / refactor w juz dzialajacym module
• MEMO Ej Aj (uzyj memo-production-pipeline)

---

4 fazy + walidacja

Faza 1 - /mspec-konstytucja (Constitution)

Output: .matematic/konstytucja.md (jeden plik per projekt, SEMVER versioning).

Konstytucja projektu = niezmienne zasady, na ktore wszystkie downstream artefakty musza sie powolac. NIE myl z konstytucja AI dla kancelarii (tamta dotyczy ORGANIZACJI klienta, ta - PROJEKTU MateMatic).

Struktura:

# [Nazwa projektu] - Konstytucja

## Mission (1 zdanie)
[Po co ten projekt istnieje, w kontekscie MateMatic]

## Core Principles (3-7 articles)

### Article I - [Nazwa]
[Imperatyw MUST / MUST NOT / SHOULD]

### Article II - [Nazwa]
...


 Co projekt 
 Czego projekt  (anty-zakres)
 Z czym wspolpracuje (zaleznosci na inne projekty MateMatic)


 Owner: Wieslaw Mazur
 Reviewers: [wewnetrzny senior review dla content, security-review dla kodu, etc.]
 Amendment process: [jak zmieniac konstytucje]


 AI Act art. ... (jesli dotyczy)
 RODO art. ... (jesli dotyczy)
 AGPL / MIT / CC BY-SA (licencja projektu)

 0.1.0 |  YYYY-MM-DD |  YYYY-MM-DD