ba-kit-solo

KO | EN

gitlite — search

#vue #git #c #nextjs #windows #dotnet #ui #pdf #typescript #api

(★ 9)

No description available.

파일 탐색기

ZIP 다운로드

- - build-release-archive.sh
  - test-release-archive.sh
- - release.yml
- release-min-cli-version
- - backbone.md
  - impact.md
  - intake.md
  - module-authoring.md
  - package-status-next.md
  - srs.md
- - artifact-en.json
  - artifact-vi.json
- - do.md
  - impact.md
  - next.md
- contract-behavior.md
- contract.yaml
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- - SKILL.md
- ascii-screen-index-template.md
- ascii-screen-template.md
- backbone-index-template.md
- brainstorm-template.md
- change-request-template.md
- common-rules-template.md
- control-type-library-template.md
- design-md-template.md
- frd-template.md
- impact-receipt-template.md
- impact-report-template.md
- intake-form-template.md
- message-list-template.md
- options-comparison-template.md
- options-index-template.md
- options-receipt-template.md
- project-home-template.md
- project-memory-template.md
- requirements-backbone-template.md
- screen-field-contract-template.yaml
- shared-definitions-template.md
- shared-rule-message-index-template.md
- shared-shell-contract-template.md
- shared-shell-index-template.md
- shared-staleness-template.md
- shared-traceability-template.md
- solution-option-template.md
- srs-compile-receipt-template.md
- srs-erd-template.md
- srs-flows-template.md
- srs-spec-template.md
- srs-states-template.md
- srs-template.md
- usecase-diagrams-template.md
- usecase-item-template.md
- usecases-index-template.md
- userstories-index-template.md
- userstory-item-template.md
.gitignore
README.md

# CDN으로 사용하기

jsDelivr

jsDelivr는 공개 GitHub 리포지토리를 별도 설정 없이 CDN으로 즉시 서빙합니다. 버전과 파일을 고르면 웹페이지에 바로 붙일 수 있는 링크와 예시 코드가 만들어집니다.

버전

파일

링크

예시

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

Trợ lý BA miễn phí cho Claude Code, Codex CLI, và Antigravity IDE. Làm việc độc lập, không cần team, không cần scripts, không cần hooks.

## Cài đặt

Cài qua BA-kit CLI (khuyên dùng):

```bash
npm install -g @bakit-org/cli
ba-kit install
```

CLI tự động phát hiện Solo Basic khi chưa đăng nhập GitHub. Có thể chọn runtime:

```bash
ba-kit install --runtime claude,codex,agy
```

### Cài thủ công (fallback)

Copy thư mục `skills/`, `core/`, và `templates/` vào thư mục runtime tương ứng:

```bash
# Claude Code
cp -r skills/ ~/.claude/skills/
cp -r core/ ~/.claude/core/
cp -r templates/ ~/.claude/templates/

# Codex CLI
cp -r skills/ ~/.codex/skills/

# Antigravity IDE
cp -r skills/ ~/.gemini/skills/
```

## Lệnh CLI

```bash
ba-kit install                     # Cài đặt lần đầu (mặc định: Claude)
ba-kit install --runtime claude,codex,agy
ba-kit update                      # Cập nhật tất cả runtime đã cài
ba-kit doctor                      # Kiểm tra trạng thái
ba-kit version                     # Xem phiên bản CLI + mỗi runtime
ba-kit uninstall                   # Gỡ cài đặt (tự động phát hiện runtime)
ba-kit uninstall --runtime codex   # Gỡ runtime cụ thể
```

- Không có flag `--product`. Chọn sản phẩm theo quyền truy cập GitHub.
- Bỏ `--runtime` sẽ chỉ cài cho Claude Code.
- `update` và `uninstall` (không scope) tự động phát hiện runtime đã cài.
- **Solo Basic không cần `gh auth login`** — CLI dùng `curl` để tải public release.

## Ngôn ngữ tương tác và artifact

- `interaction_language` được chọn trong BA-kit CLI installer và quyết định ngôn ngữ CLI/Agent giao tiếp với user.
- `artifact_language` được chọn tại intake (`vi` hoặc `en`), sau đó khóa tại backbone và kế thừa cho artifact downstream.
- `source_language` chỉ là provenance. Source tiếng Anh vẫn có thể sinh artifact tiếng Việt và ngược lại.
- Project cũ chưa có policy tiếp tục dùng mặc định `vi`. ID, code, filename, path, state và receipt key không bị dịch.

## Skills

| Skill | Dùng khi |
|-------|---------|
| `/ba-start` | Bắt đầu/triển khai lifecycle BA: intake -> backbone -> frd -> stories -> srs -> package |
| `/ba-do` | Không biết gõ lệnh gì, mô tả tự do: "tôi muốn tạo SRS module payment" |
| `/ba-next` | Xem bước tiếp theo nên làm gì |
| `/ba-impact` | Phân tích thay đổi trước khi sửa artifact |
| `/brainstorm` | Capture ý tưởng, phỏng vấn sâu |

Solo Basic chỉ ship đúng 5 skill trên. Request thuộc bản khác (Notion/Figma/Stitch sync, QC export, reverse engineering, collaboration/GitHub handoff) sẽ được báo là không hỗ trợ và dừng, không tự tạo command thay thế.

## Lệnh `/ba-start` được hỗ trợ

- `frd`, `stories`, và `srs` chạy theo module đã đăng ký bằng `MOD-*`.
- `package` là lệnh đóng gói duy nhất; có thể xuất FRD-only khi dự án không phát sinh SRS.
- Chạy từ workspace root chứa `plans/`; không cần CLI riêng của BA-kit.

## Lifecycle

```
intake -> options? -> backbone -> frd? -> stories -> srs -> package
```

- `intake`: tiếp nhận yêu cầu thô, chuẩn hóa
- `options`: (optional) so sánh giải pháp
- `backbone`: khung yêu cầu đã chốt
- `frd`: (optional) đặc tả chức năng chi tiết
- `stories`: user stories + acceptance criteria
- `srs`: SRS canon (use cases, screens, ASCII wireframes)
- `package`: đóng gói bàn giao (HTML)

## Cách Solo giữ chất lượng thủ công

- **Module registry:** backbone khóa `MOD-*`, module slug, phạm vi `F-*`, portal, trạng thái và đường dẫn `03_modules/{module_slug}`. Project Home và backbone index dùng cùng registry để định tuyến.
- **Solution options:** bước `options` dùng tối đa 3 brief, chỉ tạo comparison khi có từ 2 phương án khả thi, và chỉ promote phương án user đã chọn.
- **Source fidelity:** intake dùng ID ổn định `STK-*`, `REQ-*`, `SCRSRC-*`, `PROC-*`, `CON-*`, `CMP-NNN`; mỗi claim giữ verbatim evidence, source locator và confidence. User confirmation không ghi đè evidence gốc.
- **Traceability:** backbone và FRD map ngược về intake IDs. Claim chưa có nguồn phải giữ dạng assumption/gap.
- **Manual gates:** agent kiểm tra đường dẫn, ID, diff và cross-reference trực tiếp. Solo Basic không cần runtime script, hook, validator CLI, network service, hoặc token-budget mechanism.

## Brainstorm sang lifecycle

Brainstorm là input độc lập trước lifecycle và luôn nằm tại:

```text
docs/{feature}/brainstorms/{idea-slug}.md
```

Sau khi duyệt brainstorm, đưa file vào Solo intake bằng đúng một handoff:

```text
/ba-start intake docs/{feature}/brainstorms/{idea-slug}.md
```

Intake sau đó chuẩn hóa source locator và stable IDs trước khi tạo backbone/module artifacts.

## So sánh 3 phiên bản

| | Solo Basic (free) | Solo Pro (paid) | BA-kit Course |
|---|---|---|---|
| **Skills** | 5 | 8 | 14 |
| **Cài đặt** | CLI + thủ công | `install.sh` + CLI | `install.sh` + CLI |
| **Scripts / Hooks** | ❌ | ✅ | ✅ |
| **Lifecycle đầy đủ** | ✅ | ✅ | ✅ |
| **Templates** | Đầy đủ | Đầy đủ | Đầy đủ |
| **Stitch sync** | ❌ | ✅ | ✅ |
| **Content audit** | ❌ | ✅ | ✅ |
| **Auto index / guardrails** | ❌ (thủ công) | ✅ (cơ bản) | ✅ (đầy đủ) |
| **Self-update** | ✅ (CLI) | ✅ | ✅ |
| **Figma sync** | ❌ | ❌ | ✅ |
| **QC review** | ❌ | ❌ | ✅ |
| **Multi-BA collab** | ❌ | ❌ | ✅ |
| **Reverse engineering** | ❌ | ❌ | ✅ |
| **Notion publish** | ❌ | ❌ | ✅ |
| **QC export bridge** | ❌ | ❌ | ✅ |
| **Context budget (full)** | ❌ | ❌ | ✅ |
| **Tool lanes** | ❌ | ❌ | ✅ |
| **Project memory shards** | ❌ | ❌ | ✅ |

## Nâng cấp

- **Solo Basic**: Chạy `ba-kit update` để cập nhật lên bản mới nhất.
- **Solo Basic → Solo Pro**: Cài `install.sh` từ repo BA-kit Solo Pro. Script sẽ ghi đè skills/hooks/templates.
- **Solo Pro → BA-kit Course**: Cài `install.sh` từ repo BA-kit Course. Script ghi đè bản Solo Pro.
- **Self-update**: Solo Basic dùng `ba-kit update` qua CLI (không cần script riêng).

ba-kit-solo

파일 탐색기

# CDN으로 사용하기

Was this content helpful?

Recent Feedback

Download README