메뉴
TermQ development context. Load at session start and when working on TermQ. Covers project structure, module layout, toolchain rules, worktree workflow, settings architecture, and debugging (TermQLogger categories, log streaming, TERMQ_DEBUG mode).
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
TermQ release procedures. Load when executing any release — stable, beta, or hotfix. Covers versioning, tagging, monitoring, and verification.
TermQ code quality gate. Load when running verification checks before committing. Defines the four checks that must all pass with zero errors.
TermQ commit, branch, and PR conventions. Load when creating commits, branches, or pull requests.
TermQ localization workflows. Load when performing any localization task — extracting strings, translating, validating, auditing, or syncing language files.
Sparkle auto-update system for TermQ. Load when working on release workflows, appcast generation, update signing, or debugging update failures. Covers the full update pipeline from signing through delivery.
TermQ Swift code style and patterns. Load when writing or reviewing Swift code. Covers Swift 6 concurrency, error handling, memory management, UI components, and testing.
| name | termq-dev |
| description | TermQ development context. Load at session start and when working on TermQ. Covers project structure, module layout, toolchain rules, worktree workflow, settings architecture, and debugging (TermQLogger categories, log streaming, TERMQ_DEBUG mode). |
| compatibility | Designed for Claude Code. Requires Xcode, Swift 6, macOS 15+. |
TermQ is a macOS terminal emulator built in Swift 6. It wraps tmux sessions in a native SwiftUI interface and exposes them via an MCP server for AI-driven terminal control.
Sources/
├── TermQ/ — SwiftUI app: ViewModels, UI, @Observable types
├── TermQCore/ — Observable types for the app (TerminalCard, Board)
├── TermQShared/ — Sendable structs shared across all targets (MCPCard, MCPBoard, BoardLoader)
├── MCPServerLib/ — MCP server implementation (depends on TermQShared)
└── termq-cli/ — CLI tool (depends on TermQShared)
Key boundary: TermQCore types are @Observable for SwiftUI binding — not Sendable. TermQShared types are Sendable structs safe for cross-actor and cross-target use. Never mix these.
Always use make targets — never call Swift tools directly. See toolchain.md.
Use git worktrees for feature work. See worktrees.md.
Follow the three-tier settings architecture. See settings.md.
For TermQLogger usage, log streaming, and TERMQ_DEBUG mode, see debugging.md.
For test structure, what is/isn't testable, and the rule that tests are not optional, see testing.md.
For migration code (one-shot upgrades that consume legacy state), see migrations.md. Migrations belong in their own module — not embedded in main code paths.
See session-start.md for the session initialization checklist.