bstack
AI 코딩 어시스턴트 툴킷 — Claude Code, OpenCode, 그 외.
Features
bstack은 플러그인 형태로 묶인 단일 통합 패키지입니다:
- Git Guard:
--no-verify 등 위험한 git 명령어 자동 차단
- Session Handoff: Claude 세션 간 컨텍스트 인계/인수
- LSP Servers: Bash, TypeScript, Python, Go, Kotlin, Lua, Nix, Terraform 언어 서버 자동 설치
- Ralph Loop: PRD 기반 자동 반복 개발 루프
- Skills: 개인 개발 워크플로우 스킬 모음
- Jira Integration: Jira 이슈 트리아지, 백로그 생성, 상태 리포트 등
Quick Start
Installation from GitHub
# Add this repository as a marketplace
claude plugin marketplace add https://github.com/baleen37/bstack
# Install the plugin
claude plugin install bstack
Project Structure
bstack/
├── plugins/
│ ├── me/ # Core personal workflow plugin
│ │ ├── hooks/ # Session hooks (git guard, handoff, LSP checks)
│ │ └── skills/ # Personal skills (16 total)
│ ├── ralph/ # Ralph Loop plugin
│ │ ├── hooks/ # Ralph persistence hooks
│ │ └── skills/ # ralph, ralph-cancel
│ ├── autoresearch/ # Autonomous experiment loop plugin
│ │ ├── commands/
│ │ ├── hooks/
│ │ └── skills/ # autoresearch
│ ├── jira/ # Jira integration plugin
│ │ └── skills/ # 5 Jira workflow skills
│ ├── core/ # Shared agent definitions
│ ├── lsp-*/ # Individual LSP plugins (bash, go, lua, etc.)
├── scripts/ # Utility scripts (handoff, dispatch, version sync)
├── docs/ # Development and testing documentation
├── tests/ # BATS tests
├── schemas/ # JSON schemas
└── CLAUDE.md # Project instructions for Claude Code
Skills
me plugin (personal workflow)
| Skill | Description |
|---|
handoff | 세션 종료 시 다음 세션을 위한 인계 문서 생성 |
pickup | 이전 세션의 인계 문서 로드 |
create-pr | 커밋, 푸시, PR 생성 통합 워크플로우 |
pr-pass | CI 실패, 머지 충돌 등 깨진 PR 수정 |
commit | Conventional Commits 형식으로 커밋 |
research | 코드베이스 탐색 및 버그 조사 |
e2e | 다수 컴포넌트에 걸친 E2E 검증 |
eval-harness | 두 변형을 정의된 기준으로 비교 평가 |
iterate | 반복 단일 변경 사이클로 점진적 개선 |
competitive-agents | 병렬 경쟁 에이전트로 설계 탐색 |
tmux-workers | tmux 분할 창에서 병렬 AI 에이전트 실행 |
claude-code-rules | .claude/rules/ 규칙 파일 생성/관리 |
remembering-conversations | 이전 대화 컨텍스트 검색 및 적용 |
review-claudemd | CLAUDE.md 개선사항 발굴 |
reddit-fetch | WebFetch 차단 시 Reddit 콘텐츠 가져오기 |
ralph plugin
| Skill | Description |
|---|
ralph | PRD 기반 자동 반복 개발 루프 실행 |
ralph-cancel | 실행 중인 Ralph 루프 취소 |
autoresearch plugin
| Skill | Description |
|---|
autoresearch | 최적화 목표를 위한 자율 실험 루프 실행 |
jira plugin
| Skill | Description |
|---|
capture-tasks-from-meeting-notes | 회의록에서 Jira 태스크 자동 생성 |
generate-status-report | Jira 이슈 기반 프로젝트 상태 리포트 생성 |
search-company-knowledge | Jira에서 내부 개념/프로세스 검색 |
triage-issue | 버그 리포트 트리아지 및 중복 검색 |
spec-to-backlog | Confluence 스펙 문서를 Jira 백로그로 변환 |
Development
Running Tests
# Run all BATS tests
bats tests/
# Run pre-commit hooks manually
pre-commit run --all-files
Version Management & Release
이 프로젝트는 semantic-release와 Conventional Commits를 사용하여 자동으로 버전을 관리합니다.
# Interactive commit (recommended)
bun run commit
# Or write manually
git commit -m "type(scope): description"
Types:
feat: New feature (minor version bump)fix: Bug fix (patch version bump)docs, style, refactor, test, build, ci, chore, perf: Patch version bump
Release Process
- Push commits to main branch
- GitHub Actions runs tests then semantic-release
- Version is determined (feat → minor, fix → patch)
- Root
plugin.json and marketplace.json are updated
- Git tag is created and GitHub release is published
Pre-commit Hooks
pre-commit run --all-files
Validations:
- YAML syntax validation
- JSON schema validation
- ShellCheck (shell script linting)
- markdownlint (Markdown linting)
- commitlint (commit message format)
Note: Pre-commit failures cannot be bypassed with --no-verify (enforced by git-guard).
Contributing
- Conventional Commits - Use
bun run commit for interactive commit creation
- Pre-commit Hooks - All hooks must pass before committing
- Test Coverage - Add BATS tests for new features
- Documentation - Update README.md for changes
License
MIT License - see LICENSE file.
