docs(workflows): address CodeRabbit markdownlint and wording findings
This commit is contained in:
@@ -188,7 +188,7 @@ echo "Fix scope: ${FIX_SCOPE}"
|
||||
|
||||
Use Agent() to spawn agent:
|
||||
|
||||
```
|
||||
```text
|
||||
Agent(subagent_type="gsd-code-fixer", prompt="
|
||||
<files_to_read>
|
||||
${REVIEW_PATH}
|
||||
|
||||
@@ -480,7 +480,7 @@ increases monotonically across waves. `{status}` is `complete` (success),
|
||||
creation before the next begins (the round-trip latency of each tool call provides
|
||||
natural spacing), while all agents still **run in parallel** once created.
|
||||
|
||||
```
|
||||
```text
|
||||
# CORRECT: dispatch one Agent() per message, each with run_in_background: true
|
||||
# → worktrees created sequentially, agents execute in parallel
|
||||
#
|
||||
@@ -488,7 +488,7 @@ increases monotonically across waves. `{status}` is `complete` (success),
|
||||
# → simultaneous git worktree add → .git/config.lock contention → failures
|
||||
```
|
||||
|
||||
```
|
||||
```text
|
||||
Agent(
|
||||
subagent_type="gsd-executor",
|
||||
description="Execute plan {plan_number} of phase {phase_number}",
|
||||
|
||||
@@ -340,7 +340,7 @@ Use template: ~/.claude/get-shit-done/templates/research-project/{FILE}
|
||||
|
||||
After all 4 complete, spawn synthesizer:
|
||||
|
||||
```
|
||||
```text
|
||||
Agent(prompt="
|
||||
Synthesize research outputs into SUMMARY.md.
|
||||
|
||||
|
||||
@@ -920,7 +920,7 @@ Use template: ~/.claude/get-shit-done/templates/research-project/PITFALLS.md
|
||||
|
||||
After all 4 agents complete, spawn synthesizer to create SUMMARY.md:
|
||||
|
||||
```
|
||||
```text
|
||||
Agent(prompt="
|
||||
<task>
|
||||
Synthesize research outputs into SUMMARY.md.
|
||||
|
||||
@@ -866,9 +866,9 @@ Every task MUST include these fields — they are NOT optional:
|
||||
</quality_gate>
|
||||
```
|
||||
|
||||
**If `CHUNKED_MODE` is `false` (default):** Spawn the planner as a single long-lived Task:
|
||||
**If `CHUNKED_MODE` is `false` (default):** Spawn the planner as a single long-lived Agent:
|
||||
|
||||
```
|
||||
```text
|
||||
Agent(
|
||||
prompt=filled_prompt,
|
||||
subagent_type="gsd-planner",
|
||||
@@ -885,9 +885,9 @@ Agent(
|
||||
|
||||
**Skip if `CHUNKED_MODE` is `false`.**
|
||||
|
||||
Chunked mode splits the single long-lived planner Task into a short outline Task followed by
|
||||
N short per-plan Tasks. Each Task is bounded to ~3–5 min; each plan is committed individually
|
||||
for crash resilience. If any Task hangs and the terminal is force-killed, rerunning
|
||||
Chunked mode splits the single long-lived planner Agent run into a short outline Agent run followed by
|
||||
N short per-plan Agent runs. Each run is bounded to ~3–5 min; each plan is committed individually
|
||||
for crash resilience. If any run hangs and the terminal is force-killed, rerunning
|
||||
`/gsd-plan-phase {N} --chunked` resumes from the last successfully committed plan.
|
||||
|
||||
**Intended for new or in-progress chunked runs.** To recover plans already written by a prior
|
||||
|
||||
Reference in New Issue
Block a user