| name | ttb-skill-init |
| description | TTBaseUIKit project initialization skill: scaffold MVVM-C folder structure, setup TTBaseUIKitConfig, configure localization, integrate TTBDebugPlus. Run BEFORE any other TTBaseUIKit skill. |
| version | 2.3.0 |
| date_updated | 2026-05-30 |
| risk | safe |
| source | internal |
| loadLevel | always |
| tags | ["init","project-setup","mvvm-c","ttbaseuikit","localization","debug","routing"] |
ttb-skill-init
TTBaseUIKit project initialization skill.
Run FIRST before any other TTBaseUIKit skill (uikit, swiftui, bugfix, refactor, audit).
MVVM-C Structure | TTBaseUIKitConfig | Localization | TTBDebugPlus | iOS 14+
Mandatory Preflight Execution Gate
Before this skill generates code, refactors, migrates, modifies files, creates architecture, updates UI/navigation, changes dependencies, updates workflows, or changes business logic, run the shared gate:
ttb-skill-shared/fragments/ttb-preflight-execution-gate.frag.mdttb-skill-shared/fragments/ttb-cross-functional-analysis-gate.frag.md when initialization scope includes product flows, feature foundations, or bug-prevention architecturettb-skill-shared/templates/ttb-clarification-survey.md when confidence is below threshold
Required phase order: Requirement Analysis -> Context Validation -> Ambiguity Detection -> Missing Information Detection -> Survey / Clarification -> Confidence Evaluation -> Execution Approval.
Execution thresholds:
| Confidence | Action |
|---|
90-100 | Execute directly and state key assumptions |
70-89 | Execute only with documented low-risk assumptions |
<70 | Do not execute; ask a concise survey first |
Cap confidence at 69 when target module, architecture direction, UIKit/SwiftUI choice, navigation behavior, API/business logic, localization format, state management, dependency info, or ownership is unclear. Parse English, Vietnamese, mixed-language, diacritic-free Vietnamese, and light typos before scoring.
When project initialization includes feature foundations, product flows, architecture choices, or bug-prevention decisions, analyze as Product Owner, Business Analyst, UX/UI Designer, Solution Architect, Senior Developer, and QA. Compare options across business value, architecture, UI/UX, performance, scalability, maintainability, security, testing, and operations; ask at least 5 value-expansion questions after analysis. If requirements are ambiguous/incomplete, ask at least 6 clarification questions before design/development.
Skills in This Set
| Command | Description |
|---|
/ttb-init | Full project initialization (all phases) |
/ttb-init-structure | MVVM-C folder structure + coordinators |
/ttb-init-config | TTBaseUIKitConfig + dependency setup (SPM/CocoaPods) |
/ttb-init-l10n | Localizable.strings + XText/XTextU setup |
/ttb-init-debug | TTBDebugPlus integration |
When to Use
Activate FIRST when user:
- "init project", "khởi tạo dự án", "setup project", "new TTBaseUIKit project"
- "cấu trúc dự án", "project structure", "project scaffold"
- "configure TTBaseUIKit", "setup TTBaseUIKit"
- "add TTBaseUIKit to existing project"
- Starting a new iOS/macOS app with TTBaseUIKit
- Existing project missing proper TTBaseUIKit foundation
Routing Contract
input:
required: [project_name_or_existing_project, dependency_manager, target_platform]
optional: [localization_scope, debug_tooling, existing_architecture, app_modules]
output:
artifacts: [folder_structure, ttbaseuikit_config, localization_files, coordinator_foundation, debug_setup, verification_report]
completion_gate: "xcodebuild BUILD SUCCEEDED or documented blocker"
confidence:
auto_route: ">= 0.78 when prompt asks init/setup/scaffold/config/localization/debug foundation"
clarify: "0.55-0.77 when project is existing but missing foundation details"
fallback:
ask: "Dependency manager, project name, new vs existing app, and whether TTBaseUIKit is already installed."
Multilingual aliases: init project, setup project, new app foundation, khởi tạo dự án, khoi tao du an, tạo cấu trúc, cấu hình TTBaseUIKit.
Anti-patterns: do not generate feature screens before foundation validation; do not invent a new architecture if the app already has MVVM-C; do not skip localization/debug setup when requested.
Why This Skill Exists
Every existing TTBaseUIKit skill (uikit, swiftui, bugfix, refactor, audit) assumes the project already has:
| Assumption | Will Fail Without |
|---|
TTBaseUIKit dependency installed | error: cannot find module 'TTBaseUIKit' |
TTBaseUIKitConfig initialized | Runtime crash, config tokens return nil |
Localizable.strings exists | XText/XTextU return empty strings |
| MVVM-C folder structure | Cannot create files in expected paths |
| Coordinators scaffolded | Navigation flow breaks |
| Xcode project registered files | xcodebuild fails with "file not found" |
| iOS 14+ deployment target | iOS 15+/16+/17+ API calls crash |
This skill creates the correct foundation so all other skills work without errors.
Quick Start
- Ask clarifying questions (dependency manager, architecture, navigation style)
- Run
/ttb-init for full setup, or specific command for partial setup
- Verify with xcodebuild
- Project is READY FOR BUILDING with other skills
11 Iron Laws + Init Guardrails
- iOS 14+ ONLY — no iOS 15+/16+/17+ APIs without
@available
- TTBaseUIKit COMPONENTS — never use raw UIKit when TTBaseUIKit exists
- TTViewCodable MVVM — UIKit views must use TTViewCodable protocol
- TTBaseSUI FOR SWIFTUI — use TTBaseSUI* wrappers for SwiftUI
- MVVM SEPARATION — ViewModel never imports UIKit/SwiftUI
- xcodebuild CLI IS LAW — use
xcodebuild command, not Cmd+B
- ZERO REGRESSION — every change verified against existing code
- INHERIT ARCHITECTURE — do not create new patterns
- ANTI-LOOP: MAX 3 ROUNDS — 3 build failures → stop
- CODE GENERATION MARKER — every generated file must have the marker comment
- POST-BUILD VERIFICATION IS MANDATORY — after every skill: xcodebuild must succeed + FCR compliance verified
- ASK BEFORE ASSUME — if context insufficient, ask. Do not guess.
Code Generation Marker
Every generated file must include:
Phase Overview
Phase 0: Pre-Init Assessment → Ask clarifying questions
Phase 1: Project Folder Structure → MVVM-C directories + base classes
Phase 2: Dependency Setup → SPM or CocoaPods integration
Phase 3: TTBaseUIKitConfig → Initialize TTBaseUIKitConfig
Phase 4: Localization Setup → Localizable.strings + XText/XTextU
Phase 5: Navigation Architecture → BaseTabBarController + AppCoordinator
Phase 6: TTBDebugPlus Integration → TTBaseDebugKit + debug bridge
Phase 7: Resources → Info.plist, Assets, Xcode project
Phase 8: xcodebuild Verification → BUILD SUCCEEDED → READY FOR BUILDING
Files in This Skill Set
| File | Purpose |
|---|
ttb-skill-init.prompt.md | Full 8-phase init workflow |
ttb-skill-init-structure.prompt.md | MVVM-C folder structure + coordinators |
ttb-skill-init-ttbaseui-kit.prompt.md | TTBaseUIKitConfig + dependency setup |
ttb-skill-init-localization.prompt.md | Localizable.strings + XText/XTextU setup |
ttb-skill-init-debug.prompt.md | TTBDebugPlus integration |
Shared Resources
ttb-skill-shared/rules/ttb-rule-coding-standards.md — File header, MARK sections, namingttb-skill-shared/rules/ttb-rule-anti-patterns.md — Component anti-patternsttb-skill-shared/rules/ttb-rule-memory-leaks.md — Memory leak detectionttb-skill-shared/phases/ttb-phase-verify.md — 5-layer post-build verificationttb-skill-shared/refs/ttb-ref-ttbaseuikit.md — TTBaseUIKit API referencettb-skill-shared/refs/ttb-ref-config-tokens.md — TTView/TTSize/TTFont tokensttb-skill-shared/refs/ttb-ref-ios14-compatibility.md — iOS 14 API guide
Integration with Other Skills
This skill is the foundation. After init completes, proceed with:
| Scenario | Use Next |
|---|
| Building UIKit screens | TTB UIKit Skill (/ttb-uikit-*) |
| Building SwiftUI screens | TTB SwiftUI Skill (/ttb-sui-*) |
| Fixing bugs in existing code | TTB Bugfix Skill (/ttb-bug-*) |
| Refactoring old code | TTB Refactor Skill (/ttb-refactor-*) |
| Running quality audit | TTB Audit Skill (/ttb-audit-*) |
| Starting from scratch (new app) | TTS Product Workflow (/tts-product-*) |
| Adding features to existing app | TTS Function Workflow (/tts-function-*) |
All skills share ttb-skill-shared/ rules and phases.
Version: 2.3.0 | Date: 2026-05-30
Changelog: v2.3.0 — Added cross-functional product analysis gate, option exploration, 5 value-expansion questions, and 6-question ambiguity clarification gate. v2.2.0 — Added standardized routing contract, EN/VI aliases, input/output schema, confidence guidance, and fallback strategy. v2.0.0 — Version bump, Iron Laws, critical token warnings, and shared resource alignment.
