daveebbelaar/bama

BAMA(모든 Mac 앱 구축) 는 AI 코딩 에이전트가 아이디어나 기존 앱을 Swift 및 SwiftUI로 작성된 기본 macOS 앱으로 변환하는 데 도움이 되는 에이전트 스킬 모음입니다. Xcode의 그래픽 인터페이스를 열지 않고 작동하도록 설계되었습니다. 모든 것은 코드와 명령줄 도구를 통해 수행됩니다.

기능:

• 에이전트에게 "내 할 일 앱을 기본 Mac 앱으로 복제해" 또는 "BAMA로 window-snapper.md의 앱을 빌드해"와 같은 프롬프트를 제공합니다.
• 에이전트는 3단계 프로세스를 따릅니다: 복제(마음에 드는 앱의 모든 화면을 스크린샷하고 화면 인덱스를 작성), 계획(화면을 수락 기준이 있는 사용자 스토리로 변환하고 마일스톤으로 그룹화), 빌드(커밋당 하나의 스토리를 구현하고 각 커밋 전에 라이트/다크 스냅샷을 찍고 테스트 실행).
• /bama 명령은 라우터 역할을 합니다: 프로젝트를 검사하고 다음 적절한 스킬을 선택합니다.

스킬(총 21개):

• 시작: bama(라우터), app-brief(아이디어를 한 페이지 브리프로 변환), new-mac-app(SwiftData, 빌드 스크립트, 스냅샷 모드, git이 포함된 템플릿에서 작동하는 앱 생성).
• 계획: research(시장, 사용자, 기능, 디자인, macOS API에 대한 병렬 리서치), clone(컴퓨터 사용 또는 브라우저를 통해 모든 앱의 스크린샷), user-stories(확인 가능한 수락 기준이 있는 백로그).
• 코드: swift-swiftui(Swift 6 동시성, 상태, SwiftData, AppKit 브리지), os-integrations(단축키, 메뉴 바, 플로팅 패널, 화면 캡처, Shortcuts, URL 스킴, CLI, 권한), performance(메인 스레드, GPU, 이미지, Instruments 측정 및 수정), improve-architecture(커밋당 하나의 핫스팟 리팩토링), agent-cli(외부 제어를 위한 선택적 CLI 및 MCP 서버).
• 디자인: ux-design(이름, 흐름, 기능이 열리는 위치, 접근성), mac-design(Liquid Glass, 레이아웃, 툴바, 메뉴, 다크 모드), design-system(액센트 색상, 토큰, 규칙이 있는 네이티브 룩), layout-grid(정렬 검사가 있는 4pt 그리드), design-kit(사용자 지정 부품, 아이콘 세트, 모든 상태, 부품 갤러리), design-from-app(스크린샷에서 앱의 모양을 재구성, 픽셀 단위 비교), app-icon(Icon Composer 파일로 Liquid Glass 아이콘).
• 출시: build-and-verify(빌드, 설치, 라이트/다크에서 각 페이지 스냅샷), test-mac-app(Swift Testing, 앱 내 자체 테스트, 디버그 브리지), improve-loop(마일스톤이 완료될 때까지 커밋당 하나의 스토리를 백로그에서 처리).

사양:

• specs/ 폴더에는 작은 Mac 앱(창 스내퍼, 창 전환기, 런처, 클립보드 기록, 스크린샷, 화면 녹화 등)을 위한 12개의 빌드 계획이 포함되어 있습니다. 빈 폴더에 복사하고 에이전트에게 빌드를 요청할 수 있습니다.

설치:

• Claude Code의 경우: /plugin marketplace add daveebbelaar/bama 그런 다음 /plugin install bama@bama.
• Codex의 경우: codex plugin marketplace add daveebbelaar/bama 그런 다음 codex plugin add bama@bama.
• 다른 에이전트(Cursor, Gemini CLI, Copilot)의 경우: npx skills@latest add daveebbelaar/bama -a <agent>(또는 단일 스킬의 경우 --skill=clone)를 사용합니다.
• 수동: git clone https://github.com/daveebbelaar/bama.git을 실행한 다음 bama/scripts/link-skills.sh를 실행하여 스킬을 ~/.claude/skills 및 ~/.agents/skills에 연결합니다.

요구 사항:

• macOS 26 이상
• Xcode 26 이상(Swift 6.2 툴체인용, 하지만 열 필요는 없음)
• 스킬을 지원하는 에이전트(Claude Code, Codex, Cursor, Gemini CLI)
• 네이티브 앱의 clone 스킬의 경우: 컴퓨터 사용(Claude Pro 또는 Max)

크레딧:

• 아이디어와 "모든" 약속은 morluto의 REA: Reverse Engineer Anything에서 비롯되었습니다.
• 스킬 형식은 Matt Pocock의 skills 및 그의 writing-for-agents 스킬을 따릅니다.
• Paul Hudson의 SwiftUI Pro 및 Antoine van der Lee의 SwiftUI Expert와 잘 작동합니다.

라이선스: MIT.