speccrew 0.1.0 → 0.1.2

package/README.bs.md

@@ -0,0 +1,321 @@
+# SpecCrew - AI-pogon softverski inženjerski okvir
+
+<p align="center">
+  <a href="./README.md">简体中文</a> |
+  <a href="./README.zh-TW.md">繁體中文</a> |
+  <a href="./README.en.md">English</a> |
+  <a href="./README.ko.md">한국어</a> |
+  <a href="./README.de.md">Deutsch</a> |
+  <a href="./README.es.md">Español</a> |
+  <a href="./README.fr.md">Français</a> |
+  <a href="./README.it.md">Italiano</a> |
+  <a href="./README.da.md">Dansk</a> |
+  <a href="./README.ja.md">日本語</a> |
+  <a href="./README.pl.md">Polski</a> |
+  <a href="./README.ru.md">Русский</a> |
+  <a href="./README.bs.md">Bosanski</a> |
+  <a href="./README.ar.md">العربية</a> |
+  <a href="./README.no.md">Norsk</a> |
+  <a href="./README.pt-BR.md">Português (Brasil)</a> |
+  <a href="./README.th.md">ไทย</a> |
+  <a href="./README.tr.md">Türkçe</a> |
+  <a href="./README.uk.md">Українська</a> |
+  <a href="./README.bn.md">বাংলা</a> |
+  <a href="./README.el.md">Ελληνικά</a> |
+  <a href="./README.vi.md">Tiếng Việt</a>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/speccrew"><img src="https://img.shields.io/npm/v/speccrew.svg" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/speccrew"><img src="https://img.shields.io/npm/dm/speccrew.svg" alt="npm downloads"></a>
+  <a href="https://github.com/charlesmu99/speccrew/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/speccrew.svg" alt="license"></a>
+</p>
+
+> Virtuelni AI razvojni tim koji omogućava brzu inženjersku implementaciju za bilo koji softverski projekat
+
+## Šta je SpecCrew?
+
+SpecCrew je ugrađeni virtuelni AI razvojni okvir. Transformiše profesionalne softverske inženjerske tokove rada (PRD → Feature Design → System Design → Dev → Test) u višekorisne tokove rada Agenta, pomažući razvojnim timovima da postignu Specification-Driven Development (SDD), posebno pogodan za postojeće projekte.
+
+Integracijom Agenata i Vještina u postojeće projekte, timovi mogu brzo inicijalizirati sisteme dokumentacije projekta i virtuelne softverske timove, implementirajući nove funkcionalnosti i modifikacije prema standardnim inženjerskim tokovima rada.
+
+---
+
+## Rješavanje 8 ključnih problema
+
+### 1. AI ignoriše postojeću dokumentaciju projekta (jaz u znanju)
+**Problem**: Postojeće SDD ili Vibe Coding metode se oslanjaju na AI da sumira projekte u realnom vremenu, lako propuštajući kritični kontekst i uzrokujući da rezultati razvoja odstupaju od očekivanja.
+
+**Rješenje**: Repozitorij `knowledge/` služi kao "jedini izvor istine" projekta, akumulirajući dizajn arhitekture, funkcionalne module i poslovne procese kako bi se osiguralo da zahtjevi ostanu na pravom putu od izvora.
+
+### 2. Direktna tehnička dokumentacija iz PRD-a (izostavljanje sadržaja)
+**Problem**: Direktni skok iz PRD-a u detaljni dizajn lako propušta detalje zahtjeva, uzrokujući da implementirane funkcionalnosti odstupaju od zahtjeva.
+
+**Rješenje**: Uvođenje faze **Dokumenta Feature Design**, fokusirajući se samo na skelet zahtjeva bez tehničkih detalja:
+- Koje stranice i komponente su uključene?
+- Tokovi operacija stranica
+| Logika obrade bekenda
+- Struktura skladištenja podataka
+
+Razvoj samo treba da "popuni meso" na osnovu specifičnog tehničkog steka, osiguravajući da funkcionalnosti rastu "blizu kostiju (zahtjeva)".
+
+### 3. Neizvjesni opseg pretrage Agenta (neizvjesnost)
+**Problem**: U kompleksnim projektima, široka pretraga koda i dokumenata od strane AI daje neizvjesne rezultate, čineći dosljednost teškom za garanciju.
+
+**Rješenje**: Jasne strukture direktorija dokumenata i predlošci, dizajnirani na osnovu potreba svakog Agenta, implementiraju **progresivno otkrivanje i učitavanje na zahtjev** kako bi se osigurao determinizam.
+
+### 4. Nedostajući koraci i zadaci (prekid procesa)
+**Problem**: Nedostatak potpunog pokrića inženjerskog procesa lako propušta kritične korake, čineći kvalitet teškim za garanciju.
+
+**Rješenje**: Pokrivanje cijelog životnog ciklusa softverskog inženjerstva:
+```
+PRD (Zahtjevi) → Feature Design (Dizajn funkcionalnosti) → API Contract (Ugovor)
+    → System Design (Sistemski dizajn) → Dev (Razvoj) → Test (Testiranje)
+```
+- Izlaz svake faze je ulaz sljedeće faze
+- Svaki korak zahtijeva ljudsku potvrdu prije nastavka
+- Sve egzekucije Agenata imaju todo liste sa samoprovjerom nakon završetka
+
+### 5. Niska efikasnost timskog kolaboracije (silosi znanja)
+**Problem**: Iskustvo AI programiranja je teško dijeliti među timovima, što dovodi do ponovljenih grešaka.
+
+**Rješenje**: Svi Agenti, Vještine i povezani dokumenti su verzionisani sa izvornim kodom:
+- Optimizacija jedne osobe se dijeli sa timom
+- Znanje se akumulira u bazi koda
+- Poboljšana efikasnost timskog kolaboracije
+
+### 7. Predugi kontekst jednog Agenta (uskog grla performansi)
+**Problem**: Veliki složeni zadaci premašuju kontekstne prozore jednog Agenta, uzrokujući odstupanja u razumijevanju i smanjenje kvaliteta izlaza.
+
+**Rješenje**: **Mehanizam auto-dispatch Sub-Agenata**:
+- Složeni zadaci se automatski identifikuju i dijele na podzadatke
+- Svaki podzadatak se izvršava od strane nezavisnog sub-Agenta sa izolovanim kontekstom
+- Roditeljski Agent koordinira i agregira kako bi osigurao ukupnu dosljednost
+- Izbjegava ekspanziju konteksta jednog Agenta, osiguravajući kvalitet izlaza
+
+### 8. Haos iteracije zahtjeva (poteškoće upravljanja)
+**Problem**: Višestruki zahtjevi pomiješani u istoj grani međusobno utiču, čineći praćenje i povratak teškim.
+
+**Rješenje**: **Svaki zahtjev kao nezavisni projekat**:
+- Svaki zahtjev kreira nezavisni direktorij iteracije `iterations/iXXX-[ime-zahtjeva]/`
+- Potpuna izolacija: dokumenti, dizajn, kod i testovi se upravljaju nezavisno
+- Brza iteracija: isporuka male granularnosti, brza verifikacija, brzo raspoređivanje
+- Fleksibilno arhiviranje: nakon završetka, arhiviranje u `archive/` sa jasnom historijskom praćivošću
+
+### 6. Kašnjenje ažuriranja dokumenata (propadanje znanja)
+**Problem**: Dokumenti zastarjevaju kako projekti evoluiraju, uzrokujući da AI radi sa netačnim informacijama.
+
+**Rješenje**: Agenti imaju mogućnosti automatskog ažuriranja dokumenata, sinhronizirajući promjene projekta u realnom vremenu kako bi održali tačnost baze znanja.
+
+---
+
+## Glavni tok rada
+
+```mermaid
+graph LR
+    A[PRD<br/>Dokument zahtjeva] --> B[Feature Design<br/>Dizajn funkcionalnosti]
+    B --> C[API Contract<br/>Ugovor interfejsa]
+    C --> D[System Design<br/>Sistemski dizajn]
+    D --> E[Dev<br/>Implementacija]
+    E --> F[System Test<br/>Testiranje]
+    F --> G[Archive<br/>Arhiviranje]
+    
+    H[Knowledge<br/>Repozitorij] -.-> A
+    H -.-> B
+    H -.-> D
+    H -.-> E
+    
+    E -.-> H
+    F -.-> H
+```
+
+### Opisi faza
+
+| Faza | Agent | Ulaz | Izlaz | Ljudska potvrda |
+|------|-------|------|-------|-----------------|
+| PRD | PM | Korisnički zahtjevi | Dokument zahtjeva proizvoda | ✅ Potrebna |
+| Feature Design | Feature Designer | PRD | Dokument Feature Design + API ugovor | ✅ Potrebna |
+| System Design | System Designer | Feature Spec | Dokumenti dizajna Frontend/Backend | ✅ Potrebna |
+| Dev | Dev | Design | Kod + Zapisi zadataka | ✅ Potrebna |
+| System Test | Test Manager | Izlaz Dev + Feature Spec | Test slučajevi + Test kod + Test izvještaj + Izvještaj bugova | ✅ Potrebna |
+
+---
+
+## Uporedno sa postojećim rješenjima
+
+| Dimenzija | Vibe Coding | Ralph Loop | **SpecCrew** |
+|-----------|-------------|------------|-------------|
+| Zavisnost od dokumenata | Ignoriše postojeće doc | Oslanja se na AGENTS.md | **Strukturirana baza znanja** |
+| Prijenos zahtjeva | Direktno kodiranje | PRD → Kod | **PRD → Feature Design → System Design → Kod** |
+| Ljudsko učešće | Minimalno | Pri pokretanju | **U svakoj fazi** |
+| Potpunost procesa | Slaba | Srednja | **Potpuni inženjerski tok rada** |
+| Timska kolaboracija | Teško dijeljenje | Lična efikasnost | **Dijeljenje znanja tima** |
+| Upravljanje kontekstom | Jedna instanca | Petlja jedne instance | **Auto-dispatch sub-Agenata** |
+| Upravljanje iteracijom | Pomiješano | Lista zadataka | **Zahtjev kao projekat, nezavisna iteracija** |
+| Determinizam | Nizak | Srednji | **Visok (progresivno otkrivanje)** |
+
+---
+
+## Brzi početak
+
+### Preduslovi
+
+- Node.js >= 16.0.0
+- Podržani IDE-ovi: Qoder (zadani), Cursor, Claude Code
+
+> **Napomena**: Adapteri za Cursor i Claude Code nisu testirani u stvarnim IDE okruženjima (implementirani na nivou koda i verificirani kroz E2E testove, ali još nisu testirani u stvarnom Cursor/Claude Code).
+
+### 1. Instaliraj SpecCrew
+
+```bash
+npm install -g speccrew
+```
+
+### 2. Inicijalizuj projekat
+
+Navigiraj do korijenskog direktorija projekta i pokreni komandu za inicijalizaciju:
+
+```bash
+cd /path/to/your-project
+
+| Zadano koristi Qoder
+speccrew init
+
+# Ili specificiraj IDE
+speccrew init --ide qoder
+speccrew init --ide cursor
+speccrew init --ide claude
+```
+
+Nakon inicijalizacije, u projektu će biti generisano:
+- `.qoder/agents/` / `.cursor/agents/` / `.claude/agents/` — 7 definicija uloga Agenata
+- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 38 tokova rada Vještina
+- `speccrew-workspace/` — Radni prostor (direktoriji iteracija, baza znanja, predlošci dokumenata)
+- `.speccrewrc` — Konfiguracioni fajl SpecCrew
+
+Da bi kasnije ažurirali Agente i Vještine za specifični IDE:
+
+```bash
+speccrew update --ide cursor
+speccrew update --ide claude
+```
+
+### 3. Započni tok rada razvoja
+
+Prati standardni inženjerski tok rada korak po korak:
+
+1. **PRD**: Agent Product Manager analizira zahtjeve i generiše dokument zahtjeva proizvoda
+2. **Feature Design**: Agent Feature Designer generiše dokument feature design + API ugovor
+3. **System Design**: Agent System Designer generiše dokumente system design po platformama (frontend/backend/mobile/desktop)
+4. **Dev**: Agent System Developer implementira razvoj po platformama paralelno
+5. **System Test**: Agent Test Manager koordinira trofazno testiranje (dizajn slučajeva → generisanje koda → izvještaj izvršavanja)
+6. **Archive**: Arhiviraj iteraciju
+
+> Rezultati svake faze zahtijevaju ljudsku potvrdu prije prelaska na sljedeću fazu.
+
+### 4. Druge CLI komande
+
+```bash
+speccrew list       # Izlistaj instalirane agente i vještine
+speccrew doctor     # Dijagnosticiraj okruženje i status instalacije
+speccrew update     # Ažuriraj agente i vještine na najnoviju verziju
+speccrew uninstall  # Deinstaliraj SpecCrew (--all također briše radni prostor)
+```
+
+📖 **Detaljni vodič**: Nakon instalacije, pogledaj [Vodič za početak](docs/GETTING-STARTED.bs.md) za kompletan tok rada i vodič za razgovore agenata.
+
+---
+
+## Struktura direktorija
+
+```
+your-project/
+├── .qoder/                          # IDE konfiguracioni direktorij (primjer Qoder)
+│   ├── agents/                      # 7 Agenata uloga
+│   │   ├── speccrew-team-leader.md       # Vođa tima: Globalno planiranje i upravljanje iteracijama
+│   │   ├── speccrew-product-manager.md   | Product Manager: Analiza zahtjeva i PRD
+│   │   ├── speccrew-feature-designer.md  # Feature Designer: Feature Design + API ugovor
+│   │   ├── speccrew-system-designer.md   # System Designer: Sistemski dizajn po platformama
+│   │   ├── speccrew-system-developer.md  # System Developer: Paralelni razvoj po platformama
+│   │   ├── speccrew-test-manager.md      # Test Manager: Koordinacija trofaznog testiranja
+│   │   └── speccrew-task-worker.md       # Task Worker: Paralelno izvršavanje podzadataka
+│   └── skills/                      # 38 Vještina (grupisanih po funkciji)
+│       ├── speccrew-pm-*/                # Upravljanje proizvodom (analiza zahtjeva, evaluacija)
+│       ├── speccrew-fd-*/                # Feature Design (Feature Design, API ugovor)
+│       ├── speccrew-sd-*/                # System Design (frontend/backend/mobile/desktop)
+│       ├── speccrew-dev-*/               # Razvoj (frontend/backend/mobile/desktop)
+│       ├── speccrew-test-*/              # Testiranje (dizajn slučajeva/generisanje koda/izvještaj izvršavanja)
+│       ├── speccrew-knowledge-bizs-*/    # Poslovno znanje (API analiza/UI analiza/klasifikacija modula itd.)
+│       ├── speccrew-knowledge-techs-*/   # Tehničko znanje (generisanje tehničkog steka/konvencije/indeks itd.)
+│       ├── speccrew-knowledge-graph-*/   # Graf znanja (čitanje/pisanje/upit)
+│       └── speccrew-*/                   # Alati (dijagnostika/vremenske oznake/tok rada itd.)
+│
+└── speccrew-workspace/              # Radni prostor (generisan pri inicijalizaciji)
+    ├── docs/                        # Upravljački dokumenti
+    │   ├── configs/                 # Konfiguracioni fajlovi (mapiranje platformi, mapiranje tehničkog steka itd.)
+    │   ├── rules/                   # Konfiguracije pravila
+    │   └── solutions/               # Dokumenti rješenja
+    │
+    ├── iterations/                  # Projekti iteracija (dinamički generisani)
+    │   └── {broj}-{tip}-{ime}/
+    │       ├── 00.docs/             # Originalni zahtjevi
+    │       ├── 01.product-requirement/ # Zahtjevi proizvoda
+    │       ├── 02.feature-design/   # Feature design
+    │       ├── 03.system-design/    # System design
+    │       ├── 04.development/      # Faza razvoja
+    │       ├── 05.system-test/      # Sistemsko testiranje
+    │       └── 06.delivery/         # Faza isporuke
+    │
+    ├── iteration-archives/          # Arhive iteracija
+    │
+    └── knowledges/                  # Baza znanja
+        ├── base/                    # Baza/metapodaci
+        │   ├── diagnosis-reports/   # Izvještaji dijagnostike
+        │   ├── sync-state/          # Stanje sinhronizacije
+        │   └── tech-debts/          # Tehnički dug
+        ├── bizs/                    # Poslovno znanje
+        │   └── {platform-type}/{module-name}/
+        └── techs/                   # Tehničko znanje
+            └── {platform-id}/
+```
+
+---
+
+## Ključni principi dizajna
+
+1. **Specification-Driven**: Prvo napiši specifikacije, a onda pusti kod da "izraste" iz njih
+2. **Progresivno otkrivanje**: Agenti počinju od minimalnih ulaznih tačaka, učitavajući informacije na zahtjev
+3. **Ljudska potvrda**: Izlaz svake faze zahtijeva ljudsku potvrdu kako bi se spriječilo odstupanje AI
+4. **Izolacija konteksta**: Veliki zadaci se dijele na male, kontekstno izolovane podzadatke
+5. **Kolaboracija sub-Agenata**: Složeni zadaci automatski dispatchaju sub-Agente kako bi izbjegli ekspanziju konteksta jednog Agenta
+6. **Brza iteracija**: Svaki zahtjev kao nezavisni projekat za brzu isporuku i verifikaciju
+7. **Dijeljenje znanja**: Sve konfiguracije su verzionisane sa izvornim kodom
+
+---
+
+## Slučajevi upotrebe
+
+### ✅ Preporučeno za
+| Srednje do velike projekte koji zahtijevaju standardizirane tokove rada
+- Tinsku kolaboraciju u razvoju softvera
+- Inženjersku transformaciju naslijeđenih projekata
+- Proizvode koji zahtijevaju dugoročno održavanje
+
+### ❌ Nije pogodno za
+- Ličnu brzu validaciju prototipa
+- Eksplorativne projekte sa vrlo neizvjesnim zahtjevima
+- Jednokratne skripte ili alate
+
+---
+
+## Više informacija
+
+- **Mapa znanja Agenata**: [speccrew-workspace/docs/agent-knowledge-map.md](./speccrew-workspace/docs/agent-knowledge-map.md)
+- **npm**: https://www.npmjs.com/package/speccrew
+- **GitHub**: https://github.com/charlesmu99/speccrew
+- **Gitee**: https://gitee.com/amutek/speccrew
+- **Qoder IDE**: https://qoder.com/
+
+---
+
+> **SpecCrew ne zamjenjuje developere, već automatizira dosadne dijelove kako bi se timovi mogli fokusirati na vrijedniji rad.**

package/README.da.md

@@ -0,0 +1,321 @@
+# SpecCrew - AI-drevet Software Engineering Framework
+
+<p align="center">
+  <a href="./README.md">简体中文</a> |
+  <a href="./README.zh-TW.md">繁體中文</a> |
+  <a href="./README.en.md">English</a> |
+  <a href="./README.ko.md">한국어</a> |
+  <a href="./README.de.md">Deutsch</a> |
+  <a href="./README.es.md">Español</a> |
+  <a href="./README.fr.md">Français</a> |
+  <a href="./README.it.md">Italiano</a> |
+  <a href="./README.da.md">Dansk</a> |
+  <a href="./README.ja.md">日本語</a> |
+  <a href="./README.pl.md">Polski</a> |
+  <a href="./README.ru.md">Русский</a> |
+  <a href="./README.bs.md">Bosanski</a> |
+  <a href="./README.ar.md">العربية</a> |
+  <a href="./README.no.md">Norsk</a> |
+  <a href="./README.pt-BR.md">Português (Brasil)</a> |
+  <a href="./README.th.md">ไทย</a> |
+  <a href="./README.tr.md">Türkçe</a> |
+  <a href="./README.uk.md">Українська</a> |
+  <a href="./README.bn.md">বাংলা</a> |
+  <a href="./README.el.md">Ελληνικά</a> |
+  <a href="./README.vi.md">Tiếng Việt</a>
+</p>
+
+<p align="center">
+  <a href="https://www.npmjs.com/package/speccrew"><img src="https://img.shields.io/npm/v/speccrew.svg" alt="npm version"></a>
+  <a href="https://www.npmjs.com/package/speccrew"><img src="https://img.shields.io/npm/dm/speccrew.svg" alt="npm downloads"></a>
+  <a href="https://github.com/charlesmu99/speccrew/blob/main/LICENSE"><img src="https://img.shields.io/npm/l/speccrew.svg" alt="license"></a>
+</p>
+
+> Et virtuelt AI-udviklingsteam, der muliggør hurtig engineering-implementering for ethvert softwareprojekt
+
+## Hvad er SpecCrew?
+
+SpecCrew er et indlejret virtuelt AI-udviklingsteam-framework. Det omdanner professionelle software engineering-workflows (PRD → Feature Design → System Design → Dev → Test) til genanvendelige Agent-workflows og hjælper udviklingsteams med at opnå Specification-Driven Development (SDD), især velegnet til eksisterende projekter.
+
+Ved at integrere Agents og Skills i eksisterende projekter kan teams hurtigt initialisere projektdokumentationssystemer og virtuelle softwareteams og implementere nye funktioner og ændringer efter standard engineering-workflows.
+
+---
+
+## 8 Kerne-problemer Løst
+
+### 1. AI Ignorerer Eksisterende Projektdokumentation (Videnskløft)
+**Problem**: Eksisterende SDD- eller Vibe Coding-metoder er afhængige af, at AI opsummerer projekter i realtid, hvilket let går glip af kritisk kontekst og får udviklingsresultater til at afvige fra forventninger.
+
+**Løsning**: `knowledge/`-repositoryet fungerer som projektets "eneste kilde til sandhed" og akkumulerer arkitekturdesign, funktionsmoduler og forretningsprocesser for at sikre, at krav holder sig på sporet fra kilden.
+
+### 2. Direkte PRD-til-Teknisk Dokumentation (Indholdsudeladelse)
+**Problem**: At hoppe direkte fra PRD til detaljeret design går let glip af kravdetaljer, hvilket får implementerede funktioner til at afvige fra krav.
+
+**Løsning**: Introducerer **Feature Design-dokument**-fasen, der kun fokuserer på kravets skelet uden tekniske detaljer:
+- Hvilke sider og komponenter er inkluderet?
+- Sideoperationsforløb
+- Backend-behandlingslogik
+- Dataopbevaringsstruktur
+
+Udvikling behøver kun at "udfylde kødet" baseret på den specifikke tech-stack og sikrer, at funktioner vokser "tæt på knoglen (krav)".
+
+### 3. Usikker Agent-søgningsomfang (Usikkerhed)
+**Problem**: I komplekse projekter giver AI's brede søgning efter kode og dokumenter usikre resultater, hvilket gør konsistens vanskelig at garantere.
+
+**Løsning**: Klare dokumentkatalogstrukturer og skabeloner, designet baseret på hver Agents behov, implementerer **progressiv offentliggørelse og on-demand indlæsning** for at sikre determinisme.
+
+### 4. Manglende Trin og Opgaver (Proces-nedbrydning)
+**Problem**: Manglende fuld engineering-procesdækning går let glip af kritiske trin, hvilket gør kvalitet vanskelig at garantere.
+
+**Løsning**: Dækker hele software engineering-livscyklussen:
+```
+PRD (Krav) → Feature Design (Funktionsdesign) → API Contract (Kontrakt)
+    → System Design (Systemdesign) → Dev (Udvikling) → Test (Test)
+```
+- Hver fasers output er næste fasers input
+- Hvert trin kræver menneskelig bekræftelse før fortsættelse
+- Alle Agent-eksekveringer har todo-lister med selv-tjek efter afslutning
+
+### 5. Lav Team-samarbejdseffektivitet (Videns-silos)
+**Problem**: AI-programmeringserfaring er svær at dele på tværs af teams, hvilket fører til gentagne fejl.
+
+**Løsning**: Alle Agents, Skills og relaterede dokumenter er versionsstyret med kildekode:
+- Én persons optimering deles af teamet
+- Viden akkumuleres i kodebasen
+- Forbedret team-samarbejdseffektivitet
+
+### 7. Enkelt Agent-kontekst for Lang (Ydeevne-flaskehals)
+**Problem**: Store komplekse opgaver overstiger enkelt Agent-kontekstvinduer, hvilket forårsager forståelsesafvigelser og nedsat outputkvalitet.
+
+**Løsning**: **Sub-Agent Auto-Dispatch-mekanisme**:
+- Komplekse opgaver identificeres automatisk og opdeles i underopgaver
+- Hver underopgave udføres af en uafhængig sub-Agent med isoleret kontekst
+- Parent Agent koordinerer og aggregerer for at sikre overordnet konsistens
+- Undgår enkelt Agent-kontekstudvidelse og sikrer outputkvalitet
+
+### 8. Krav-iterationskaos (Ledelsesvanskeligheder)
+**Problem**: Flere krav blandet i samme gren påvirker hinanden, hvilket gør sporing og rollback vanskeligt.
+
+**Løsning**: **Hvert Krav som et Uafhængigt Projekt**:
+- Hvert krav opretter et uafhængigt iterationskatalog `iterations/iXXX-[krav-navn]/`
+- Fuld isolation: dokumenter, design, kode og tests styres uafhængigt
+- Hurtig iteration: lille granularitetslevering, hurtig verifikation, hurtig udrulning
+- Fleksibel arkivering: efter afslutning arkivering til `archive/` med klar historisk sporing
+
+### 6. Dokumentopdateringsforsinkelse (Videns-forfald)
+**Problem**: Dokumenter bliver forældede efterhånden som projekter udvikler sig, hvilket får AI til at arbejde med forkert information.
+
+**Løsning**: Agents har automatiske dokumentopdateringsmuligheder, der synkroniserer projektændringer i realtid for at holde vidensbasen nøjagtig.
+
+---
+
+## Kerne-workflow
+
+```mermaid
+graph LR
+    A[PRD<br/>Kravdokument] --> B[Feature Design<br/>Funktionsdesign]
+    B --> C[API Contract<br/>Grænsefladekontrakt]
+    C --> D[System Design<br/>Systemdesign]
+    D --> E[Dev<br/>Implementering]
+    E --> F[System Test<br/>Test]
+    F --> G[Archive<br/>Arkivering]
+    
+    H[Knowledge<br/>Repository] -.-> A
+    H -.-> B
+    H -.-> D
+    H -.-> E
+    
+    E -.-> H
+    F -.-> H
+```
+
+### Fasebeskrivelser
+
+| Fase | Agent | Input | Output | Menneskelig Bekræftelse |
+|------|-------|-------|--------|------------------------|
+| PRD | PM | Brugerkrav | Produktkravsdokument | ✅ Påkrævet |
+| Feature Design | Feature Designer | PRD | Feature Design Dokument + API Kontrakt | ✅ Påkrævet |
+| System Design | System Designer | Feature Spec | Frontend/Backend Design-dokumenter | ✅ Påkrævet |
+| Dev | Dev | Design | Kode + Opgaveregistreringer | ✅ Påkrævet |
+| System Test | Test Manager | Dev Output + Feature Spec | Testcases + Testkode + Testrapport + Bug-rapport | ✅ Påkrævet |
+
+---
+
+## Sammenligning med Eksisterende Løsninger
+
+| Dimension | Vibe Coding | Ralph Loop | **SpecCrew** |
+|-----------|-------------|------------|-------------|
+| Dokumentafhængighed | Ignorerer eksisterende docs | Er afhængig af AGENTS.md | **Struktureret Vidensbase** |
+| Kravoverførsel | Direkte kodning | PRD → Kode | **PRD → Feature Design → System Design → Kode** |
+| Menneskelig involvering | Minimal | Ved opstart | **I hver fase** |
+| Procesfuldstændighed | Svag | Middel | **Fuld engineering-workflow** |
+| Team-samarbejde | Svært at dele | Personlig effektivitet | **Team vidensdeling** |
+| Kontekststyring | Enkelt instans | Enkelt instans-løkke | **Sub-Agent auto-dispatch** |
+| Iterationsstyring | Blandet | Opgaveliste | **Krav som projekt, uafhængig iteration** |
+| Determinisme | Lav | Middel | **Høj (progressiv offentliggørelse)** |
+
+---
+
+## Hurtig Start
+
+### Forudsætninger
+
+- Node.js >= 16.0.0
+| Understøttede IDE'er: Qoder (standard), Cursor, Claude Code
+
+> **Bemærk**: Adapterne til Cursor og Claude Code er ikke blevet testet i faktiske IDE-miljøer (implementeret på kodeniveau og verificeret gennem E2E-tests, men endnu ikke testet i faktisk Cursor/Claude Code).
+
+### 1. Installer SpecCrew
+
+```bash
+npm install -g speccrew
+```
+
+### 2. Initialiser Projekt
+
+Naviger til dit projekts rodmappe og kør initialiseringskommandoen:
+
+```bash
+cd /path/to/your-project
+
+# Bruger Qoder som standard
+speccrew init
+
+# Eller specificer IDE
+speccrew init --ide qoder
+speccrew init --ide cursor
+speccrew init --ide claude
+```
+
+Efter initialisering vil følgende blive genereret i dit projekt:
+- `.qoder/agents/` / `.cursor/agents/` / `.claude/agents/` — 7 Agent-rolledefinitioner
+- `.qoder/skills/` / `.cursor/skills/` / `.claude/skills/` — 38 Skill-workflows
+- `speccrew-workspace/` — Arbejdsområde (iterationsmapper, vidensbase, dokumentskabeloner)
+- `.speccrewrc` — SpecCrew-konfigurationsfil
+
+For at opdatere Agents og Skills til en specifik IDE senere:
+
+```bash
+speccrew update --ide cursor
+speccrew update --ide claude
+```
+
+### 3. Start Udviklingsworkflow
+
+Følg standard engineering-workflow trin for trin:
+
+1. **PRD**: Product Manager Agent analyserer krav og genererer produktkravsdokument
+2. **Feature Design**: Feature Designer Agent genererer feature design dokument + API kontrakt
+3. **System Design**: System Designer Agent genererer system design dokumenter pr. platform (frontend/backend/mobil/desktop)
+4. **Dev**: System Developer Agent implementerer udvikling pr. platform parallelt
+5. **System Test**: Test Manager Agent koordinerer tre-fase test (case-design → kode-generering → eksekveringsrapport)
+6. **Archive**: Arkiver iteration
+
+> Hver phases leverancer kræver menneskelig bekræftelse før fortsættelse til næste fase.
+
+### 4. Andre CLI-kommandoer
+
+```bash
+speccrew list       # List installerede agents og skills
+speccrew doctor     # Diagnosticer miljø og installationsstatus
+speccrew update     # Opdater agents og skills til nyeste version
+speccrew uninstall  # Afinstaller SpecCrew (--all fjerner også arbejdsområde)
+```
+
+📖 **Detaljeret Guide**: Efter installation, tjek [Kom-godt-i-gang-guiden](docs/GETTING-STARTED.da.md) for det fulde workflow og agent-konversationsguide.
+
+---
+
+## Katalogstruktur
+
+```
+your-project/
+├── .qoder/                          # IDE-konfigurationskatalog (Qoder-eksempel)
+│   ├── agents/                      # 7 rolle-Agents
+│   │   ├── speccrew-team-leader.md       # Teamleder: Global planlægning og iterationsstyring
+│   │   ├── speccrew-product-manager.md   # Produktleder: Kravanalyse og PRD
+│   │   ├── speccrew-feature-designer.md  # Feature Designer: Feature Design + API Kontrakt
+│   │   ├── speccrew-system-designer.md   # System Designer: System design pr. platform
+│   │   ├── speccrew-system-developer.md  # System Developer: Parallelt udvikling pr. platform
+│   │   ├── speccrew-test-manager.md      # Test Manager: Tre-fase testkoordinering
+│   │   └── speccrew-task-worker.md       # Opgavemedarbejder: Parallelt underopgave-eksekvering
+│   └── skills/                      # 38 Skills (grupperet efter funktion)
+│       ├── speccrew-pm-*/                # Produktstyring (kravanalyse, evaluering)
+│       ├── speccrew-fd-*/                # Feature Design (Feature Design, API Kontrakt)
+│       ├── speccrew-sd-*/                # System Design (frontend/backend/mobil/desktop)
+│       ├── speccrew-dev-*/               # Udvikling (frontend/backend/mobil/desktop)
+│       ├── speccrew-test-*/              # Test (case-design/kode-generering/eksekveringsrapport)
+│       ├── speccrew-knowledge-bizs-*/    # Forretningsviden (API-analyse/UI-analyse/modulklassificering osv.)
+│       ├── speccrew-knowledge-techs-*/   # Teknisk viden (tech-stack-generering/konventioner/indeks osv.)
+│       ├── speccrew-knowledge-graph-*/   # Vidensgraf (læse/skrive/forespørge)
+│       └── speccrew-*/                   # Hjælpeprogrammer (diagnostik/tidsstempler/workflow osv.)
+│
+└── speccrew-workspace/              # Arbejdsområde (genereret under initialisering)
+    ├── docs/                        # Styringsdokumenter
+    │   ├── configs/                 # Konfigurationsfiler (platform-mapping, tech-stack-mapping osv.)
+    │   ├── rules/                   # Regelkonfigurationer
+    │   └── solutions/               # Løsningsdokumenter
+    │
+    ├── iterations/                  # Iterationsprojekter (dynamisk genereret)
+    │   └── {nummer}-{type}-{navn}/
+    │       ├── 00.docs/             # Originale krav
+    │       ├── 01.product-requirement/ # Produktkrav
+    │       ├── 02.feature-design/   # Feature design
+    │       ├── 03.system-design/    # System design
+    │       ├── 04.development/      # Udviklingsfase
+    │       ├── 05.system-test/      # System test
+    │       └── 06.delivery/         # Leveringsfase
+    │
+    ├── iteration-archives/          # Iterationsarkiver
+    │
+    └── knowledges/                  # Vidensbase
+        ├── base/                    # Base/metadata
+        │   ├── diagnosis-reports/   # Diagnoserapporter
+        │   ├── sync-state/          # Synkroniseringsstatus
+        │   └── tech-debts/          # Teknisk gæld
+        ├── bizs/                    # Forretningsviden
+        │   └── {platform-type}/{module-name}/
+        └── techs/                   # Teknisk viden
+            └── {platform-id}/
+```
+
+---
+
+## Kerne Design-principper
+
+1. **Specification-Driven**: Skriv specifikationer først, og lad koden "vokse" fra dem
+2. **Progressiv Offentliggørelse**: Agents starter fra minimale indgangspunkter og indlæser information on-demand
+3. **Menneskelig Bekræftelse**: Hver phases output kræver menneskelig bekræftelse for at forhindre AI-afvigelse
+4. **Kontekst-isolation**: Store opgaver opdeles i små, kontekst-isolerede underopgaver
+5. **Sub-Agent-samarbejde**: Komplekse opgaver dispatcher automatisk sub-Agents for at undgå enkelt Agent-kontekstudvidelse
+6. **Hurtig Iteration**: Hvert krav som et uafhængigt projekt for hurtig levering og verifikation
+7. **Vidensdeling**: Alle konfigurationer er versionsstyret med kildekode
+
+---
+
+## Anvendelsestilfælde
+
+### ✅ Anbefalet Til
+| Mellemstore til store projekter, der kræver standardiserede workflows
+| Team-samarbejde softwareudvikling
+| Legacy-projekt engineering-transformation
+| Produkter, der kræver langvarig vedligeholdelse
+
+### ❌ Ikke Velegnet Til
+| Personlig hurtig prototype-validering
+| Udforskende projekter med meget usikre krav
+| Engangsscripts eller værktøjer
+
+---
+
+## Mere Information
+
+- **Agent Videnskort**: [speccrew-workspace/docs/agent-knowledge-map.md](./speccrew-workspace/docs/agent-knowledge-map.md)
+- **npm**: https://www.npmjs.com/package/speccrew
+- **GitHub**: https://github.com/charlesmu99/speccrew
+- **Gitee**: https://gitee.com/amutek/speccrew
+- **Qoder IDE**: https://qoder.com/
+
+---
+
+> **SpecCrew handler ikke om at erstatte udviklere, men om at automatisere de kedelige dele, så teams kan fokusere på mere værdifuldt arbejde.**