Skip to content
Open
Show file tree
Hide file tree
Changes from 8 commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
29 changes: 29 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -86,6 +86,8 @@ scripts/squad-tmux-launch.sh /path/to/project --dry-run
It can:
- read project-local launcher config from `.squad/launcher.yaml`
- read a task brief from `.squad/run-task.md`
- or auto-discover the latest implementation plan + matching spec from `docs/superpowers/...`
- or use custom discovery globs from `.squad/launcher.yaml -> task_discovery`
- generate manager / inspector prompt files under `.squad/quickstart/`
- start a tiled `tmux` session and inject `/squad` commands into Claude panes
- optionally create an isolated git worktree before launching agents
Expand All @@ -97,6 +99,33 @@ Requirements:

This launcher is intentionally separate from the core Rust CLI. Treat it as optional automation for people who want a repeatable multi-terminal workflow.

### Launcher task discovery

Task sources are resolved in this order:

1. `--task-file <path>`
2. `<project>/.squad/run-task.md`
3. auto-discovery

Default auto-discovery looks for:

- the newest `docs/superpowers/plans/*-implementation.md`
- plus the newest matching `docs/superpowers/specs/*-design.md`
Comment thread
Aias00 marked this conversation as resolved.
Outdated

If your repo uses a different layout or naming convention, configure it in `.squad/launcher.yaml`:

```yaml
task_discovery:
plan_globs:
- workitems/plans/*-plan.md
spec_globs:
- workitems/specifications/*-spec.md
plan_suffix: -plan.md
spec_suffix: -spec.md
```

`plan_globs` and `spec_globs` are resolved relative to the `project-dir` you pass to the launcher. With that config, the launcher will pick the newest matching plan, derive its topic from the filename, and attach the newest matching spec with the same topic slug.

## Usage Flow

```
Expand Down
29 changes: 29 additions & 0 deletions README.zh-CN.md
Original file line number Diff line number Diff line change
Expand Up @@ -88,6 +88,8 @@ scripts/squad-tmux-launch.sh /path/to/project --dry-run
它可以:
- 从 `.squad/launcher.yaml` 读取项目级启动配置
- 从 `.squad/run-task.md` 读取本次任务说明
- 或自动发现 `docs/superpowers/...` 下最新的 implementation plan 和匹配 spec
- 或通过 `.squad/launcher.yaml -> task_discovery` 使用自定义发现规则
- 在 `.squad/quickstart/` 下生成 manager / inspector prompt
- 启动平铺布局的 `tmux` 会话,并自动向 Claude pane 注入 `/squad` 命令
- 在启动 agent 前可选地创建独立 git worktree
Expand All @@ -99,6 +101,33 @@ scripts/squad-tmux-launch.sh /path/to/project --dry-run

这个启动器刻意保持在核心 Rust CLI 之外。它是给需要固定化多终端协作流程的用户准备的可选自动化能力。

### Launcher 任务发现规则

任务输入按下面的优先级解析:

1. `--task-file <path>`
2. `<project>/.squad/run-task.md`
3. 自动发现

默认的自动发现规则会寻找:

- 最新的 `docs/superpowers/plans/*-implementation.md`
- 以及同主题、最新匹配的 `docs/superpowers/specs/*-design.md`
Comment thread
Aias00 marked this conversation as resolved.
Outdated

如果你的仓库目录或命名规则不同,可以在 `.squad/launcher.yaml` 里配置:

```yaml
task_discovery:
plan_globs:
- workitems/plans/*-plan.md
spec_globs:
- workitems/specifications/*-spec.md
plan_suffix: -plan.md
spec_suffix: -spec.md
```

`plan_globs` 和 `spec_globs` 都是相对于你传入的 `project-dir` 解析的。配置后,launcher 会选出最新的 plan,从文件名里提取 topic,再自动附带同一 topic 的最新 spec。

## 使用流程

```
Expand Down
Loading
Loading