setup-sandcastle
Configure Sandcastle for agent delegation -- headless run(), HITL interactive(), parallel sandboxes, branches. Use when delegating to autonomous agents, parallelizing implementation, or running interactive reviews.
소스 정보
- 저장소
- redpanda-data/ui-harness
- 최근 소스 활동
- 2026년 5월 27일 14:03
- 감지된 SKILL.md 언어
- 영어
- 스타
- 34
- 포크
- 4
설치 방법
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
소스 파일 검토
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
파일 탐색기
2 개 파일SKILL.md 표시 중
SKILL.md
소스 지침 · 읽기 전용 미리보기- name
- setup-sandcastle
- description
- Configure Sandcastle for agent delegation -- headless run(), HITL interactive(), parallel sandboxes, branches. Use when delegating to autonomous agents, parallelizing implementation, or running interactive reviews.
# Setup Sandcastle
[Sandcastle](https://github.com/mattpocock/sandcastle) orchestrate agents in sandboxes with branch strategies. Two modes:
- **`run()`** -- headless (`--print`), stream-JSON parsed. CI, batch, overnight.
- **`interactive()`** -- full TUI passthrough (stdin/stdout/stderr). Human watch + intervene. HITL review, pair-review, local dev.
Both modes: hooks fire inside each session. Dev lifecycle enforced regardless of launch method.
**Capabilities:** task picking (GitHub issues -> one agent per issue), parallel N agents in isolated sandboxes, HITL review with full TUI, `noSandbox()` for git worktrees only, hooks in each session, branch strategies (head, merge-to-head, branch).
```mermaid
sequenceDiagram
participant GH as GitHub Issues
participant Main as main.ts
participant A1 as Agent 1 (run)
participant An as Agent N (run)
participant Rev as Reviewer (interactive)
GH->>Main: Fetch labeled issues
par Headless parallel execution
Main->>A1: Issue #1 (Docker sandbox)
A1->>A1: development-lifecycle (6 phases)
and
Main->>An: Issue #N (Docker sandbox)
An->>An: development-lifecycle (6 phases)
end
A1->>Rev: Branch for HITL review
Note over Rev: Human watches TUI, can intervene
Rev->>Main: Approved -- merge to head
```
## Steps
### 1. Install
```bash
bun add -D @ai-hero/sandcastle && bunx sandcastle init
```
### 2. Configure `.sandcastle/.env`
```
ANTHROPIC_API_KEY=sk-ant-...
```
### 3. Choose launch mode
| Scenario | Mode | Sandbox |
|---|---|---|
| CI/batch/overnight | `run()` | `docker()` |
| Parallel 5+ issues | `run()` | `docker()` |
| Local dev quick review | `interactive()` | `noSandbox()` |
| Pair-review with human | `interactive()` | `docker()` or `noSandbox()` |
| Single interactive session | `interactive()` | `noSandbox()` |
### 4. Orchestration Script
See [REFERENCE.md](REFERENCE.md) for templates: headless batch, HITL review, mixed pipelines.
### 5. Run
```bash
bunx tsx .sandcastle/main.ts
```
Each agent: read issue -> development-lifecycle -> hooks enforce patterns -> commit -> review -> merge.
See [REFERENCE.md](REFERENCE.md) for templates + prompt patterns.
GitHub에서 보기