ttb-skill-init

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.md
• ttb-skill-shared/fragments/ttb-cross-functional-analysis-gate.frag.md when initialization scope includes product flows, feature foundations, or bug-prevention architecture
• ttb-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

1. Ask clarifying questions (dependency manager, architecture, navigation style)
2. Run /ttb-init for full setup, or specific command for partial setup
3. Verify with xcodebuild
4. Project is READY FOR BUILDING with other skills

11 Iron Laws + Init Guardrails

1. iOS 14+ ONLY — no iOS 15+/16+/17+ APIs without @available
2. TTBaseUIKit COMPONENTS — never use raw UIKit when TTBaseUIKit exists
3. TTViewCodable MVVM — UIKit views must use TTViewCodable protocol
4. TTBaseSUI FOR SWIFTUI — use TTBaseSUI* wrappers for SwiftUI
5. MVVM SEPARATION — ViewModel never imports UIKit/SwiftUI
6. xcodebuild CLI IS LAW — use xcodebuild command, not Cmd+B
7. ZERO REGRESSION — every change verified against existing code
8. INHERIT ARCHITECTURE — do not create new patterns
9. ANTI-LOOP: MAX 3 ROUNDS — 3 build failures → stop
10. CODE GENERATION MARKER — every generated file must have the marker comment
11. POST-BUILD VERIFICATION IS MANDATORY — after every skill: xcodebuild must succeed + FCR compliance verified
12. ASK BEFORE ASSUME — if context insufficient, ask. Do not guess.

Code Generation Marker

Every generated file must include:

// [TTBaseUIKit-AI-Agents]: TTBaseUIKit Agent Support is active 🚀
//  {FileName}.swift
//  {AppName}
//

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, naming
• ttb-skill-shared/rules/ttb-rule-anti-patterns.md — Component anti-patterns
• ttb-skill-shared/rules/ttb-rule-memory-leaks.md — Memory leak detection
• ttb-skill-shared/phases/ttb-phase-verify.md — 5-layer post-build verification
• ttb-skill-shared/refs/ttb-ref-ttbaseuikit.md — TTBaseUIKit API reference
• ttb-skill-shared/refs/ttb-ref-config-tokens.md — TTView/TTSize/TTFont tokens
• ttb-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.