Package Exports

ios-sdd-mcp
ios-sdd-mcp/dist/index.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (ios-sdd-mcp) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

iOS Spec2Code (ios-sdd-mcp) 🍎

Sadece iOS için Specification-Driven Development MCP sunucusu. Cursor içinde AI ile fikirden spec → plan → task’lara, oradan Swift/SwiftUI uygulamasına gider. SwiftUI first, MVVM first, implementation-first (test zorunlu değil).

Paketi npm’den kurma

npm install -g ios-sdd-mcp

Gereksinimler: Node.js 18+, macOS, Cursor (MCP açık). iOS geliştirme için Xcode gerekir.

Cursor’da nasıl kullanılır?

1. MCP ayarını ekle

Cursor’da Settings → MCP (veya ~/.cursor/mcp.json) dosyasına şunu ekle:

{
  "mcpServers": {
    "ios-sdd-mcp": {
      "command": "sdd-mcp",
      "args": [],
      "env": {
        "PROJECT_ROOT": "${workspaceFolder}"
      }
    }
  }
}

2. Cursor’u yenile

Cursor’u yeniden başlat veya MCP sunucularını yenile. Araçlar listesinde sdd_specify, sdd_plan, sdd_tasks, sdd_implement vb. görünmeli.

3. Komutları kullan

Sohbet içinde sırayla:

Ne yapmak istiyorsun?	Komut
Spec oluştur	`/sdd_specify "Yapılacaklar listesi uygulaması, SwiftUI ile"`
Plan oluştur	`/sdd_plan`
Task’ları oluştur (4 faz, 33 task)	`/sdd_tasks`
Faz faz implement et	`/sdd_implement phase=1` → `phase=2` → `phase=3` → `phase=4`

İlk kez kullanıyorsan önce /sdd_implement phase=1 çağrılması önerilir; araç sana adım adım ne yapacağını söyler.

Tüm komutlar

Komut	Açıklama
`/sdd_specify`	iOS odaklı spec üretir → `specs/spec.md`
`/sdd_plan`	Implementation planı oluşturur → `specs/plan.md`
`/sdd_tasks`	4 fazda 33 task dosyası üretir
`/sdd_implement phase=X`	İlgili fazı çalıştırır (implementation-first)
`/sdd_implement phase=X task=Y`	Belirli bir task’ı çalıştırır
`/sdd_workflow`	specify → plan → tasks → implement tam zincir
`/sdd_validate_architecture`	Implementasyonu spec’e göre doğrular

Özellikler

Sadece iOS — Swift/SwiftUI, Xcode; platform her zaman iOS kabul edilir.
SwiftUI first, MVVM first — Apple HIG, 44pt tap target, SF Symbols, NavigationStack, TabView.
Implementation-first — Doğrulama: build (xcodebuild) + simulator’da çalıştırma; test yazımı zorunlu değil.
Cursor MCP — Tüm akış Cursor sohbetinde komutlarla yürür.

Sorun giderme

Komut bulunamıyor: Terminalde which sdd-mcp yaz. Bir path görüyorsan kurulum tamam; Cursor’da MCP command değerinin sdd-mcp olduğundan emin ol.
Araçlar görünmüyor: Cursor’u yeniden başlat veya MCP sunucularını yenile; PROJECT_ROOT için ${workspaceFolder} kullandığından emin ol.
Spec/plan oluşmuyor: Önce /sdd_specify "..." ile spec, sonra /sdd_plan, sonra /sdd_tasks çağır; ardından /sdd_implement phase=1 ile devam et.

Geliştiriciler / Kaynaktan kurulum ve npm’e yayınlama

Paketi kaynaktan kurmak veya npm’e yayınlamak istiyorsan:

Kaynaktan global kurulum

git clone <repo-url>
cd spec2code--iOS-
npm install
npm run build:lib
npm run install:global

İzin hatası alırsan: sudo npm run install:global

npm’e yayınlama

https://www.npmjs.com/signup — Hesap oluştur.
Terminalde npm login (username, password, email).
package.json içinde "name": "ios-sdd-mcp" (veya @kullaniciadin/ios-sdd-mcp).
Proje klasöründe:
```
npm run build:lib
npm publish
```
Scope kullandıysan: npm publish --access public
Versiyon güncellemek için package.json → "version": "1.0.1" artırıp tekrar npm publish.

iOS projelerini AI ile spec’ten koda taşı. 🎉