@dirtydishes/skills 0.1.2 → 0.1.4
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +15 -11
- package/package.json +1 -1
- package/skills/dirtyloops/SKILL.md +8 -5
- package/skills/dirtyloops/examples/README.md +2 -2
- package/skills/dirtyloops/examples/orchestrator-callback/README.md +5 -3
- package/skills/dirtyloops/examples/orchestrator-callback/docs/implementation/example-stream/IMPLEMENT.md +29 -6
- package/skills/dirtyloops/examples/orchestrator-callback/docs/implementation/example-stream/prompts/closeout-selector-subagent.md +40 -0
- package/skills/dirtyloops/examples/orchestrator-callback/docs/implementation/example-stream/prompts/implementation-swarm-subagent.md +29 -0
- package/skills/dirtyloops/examples/orchestrator-callback/docs/implementation/example-stream/prompts/implementation-thread.md +11 -2
- package/skills/dirtyloops/examples/orchestrator-callback/docs/implementation/example-stream/prompts/review-thread.md +3 -2
- package/skills/dirtyloops/examples/orchestrator-callback/docs/implementation/example-stream/prompts/run-loop.md +10 -4
- package/skills/dirtyloops/examples/orchestrator-callback/docs/implementation/example-stream/prompts/selector-subagent.md +35 -0
- package/skills/dirtyloops/examples/orchestrator-callback/docs/implementation/example-stream/turn-docs/01-foundation.md +14 -2
- package/skills/dirtyloops/examples/single-thread-subagent/README.md +1 -0
- package/skills/dirtyloops/examples/single-thread-subagent/docs/implementation/example-stream/IMPLEMENT.md +2 -2
- package/skills/dirtyloops/examples/single-thread-subagent/docs/implementation/example-stream/prompts/run-loop.md +5 -4
- package/skills/dirtyloops/examples/single-thread-subagent/docs/implementation/example-stream/turn-docs/01-foundation.md +5 -5
- package/skills/dirtyloops/plan.html +13 -9
- package/skills/dirtyloops/references/beads.md +28 -4
- package/skills/dirtyloops/references/create-loop.md +17 -9
- package/skills/dirtyloops/references/help.md +9 -7
- package/skills/dirtyloops/references/run-loop.md +13 -6
- package/skills/dirtyloops/references/swarms.md +15 -6
- package/skills/dirtyloops/references/workflows/orchestrator-callback.md +83 -11
- package/skills/dirtyloops/references/workflows/single-thread-subagent.md +7 -6
- package/skills/dirtyloops/schemas/implementation-callback.schema.json +14 -1
- package/skills/dirtyloops/schemas/swarm-report.schema.json +1 -1
- package/skills/dirtyloops/templates/common/IMPLEMENT.md.template +3 -2
- package/skills/dirtyloops/templates/common/run-loop.md.template +3 -1
- package/skills/dirtyloops/templates/workflows/orchestrator-callback/closeout-selector-subagent-prompt.md.template +40 -0
- package/skills/dirtyloops/templates/workflows/orchestrator-callback/implementation-swarm-subagent-prompt.md.template +29 -0
- package/skills/dirtyloops/templates/workflows/orchestrator-callback/implementation-thread-prompt.md.template +11 -2
- package/skills/dirtyloops/templates/workflows/orchestrator-callback/review-thread-prompt.md.template +3 -2
- package/skills/dirtyloops/templates/workflows/orchestrator-callback/run-loop-addendum.md.template +10 -3
- package/skills/dirtyloops/templates/workflows/orchestrator-callback/selector-subagent-prompt.md.template +35 -0
- package/skills/dirtyloops/templates/workflows/single-thread-subagent/run-loop-addendum.md.template +5 -4
|
@@ -15,19 +15,28 @@ You must send your final callback to the exact orchestrator thread id `{{ORCHEST
|
|
|
15
15
|
- Implementation index: `{{IMPLEMENT_MD}}`
|
|
16
16
|
- Turn doc: `{{TURN_DOC}}`
|
|
17
17
|
- Branch/worktree instructions: `{{BRANCH_WORKTREE_INSTRUCTIONS}}`
|
|
18
|
-
-
|
|
18
|
+
- Launch defaults: speed `standard`, reasoning `high`, inherit_orchestrator_thread_settings `false`, unless Beads metadata explicitly overrides the implementation actor
|
|
19
|
+
- Do not run this worker with inherited UI, recent thread, parent/orchestrator, `fast`, or `xhigh` settings unless Beads metadata explicitly overrides the implementation actor
|
|
19
20
|
|
|
20
21
|
## Rules
|
|
21
22
|
|
|
22
23
|
- Implement exactly this phase.
|
|
23
24
|
- Do not widen scope.
|
|
24
|
-
-
|
|
25
|
+
- Do not do broad solo implementation.
|
|
26
|
+
- For non-trivial phases, run massive bounded swarms before broad edits:
|
|
27
|
+
- 8-20 scout agents across files, modules, risks, tests, and integration edges
|
|
28
|
+
- 8-16 slice-plan agents to propose non-overlapping implementation slices
|
|
29
|
+
- 8-16 implementation-helper agents assigned to slices in parallel
|
|
30
|
+
- If this phase is tiny enough to use fewer than the default agents, record the reason in the turn doc and callback `swarm_summary`.
|
|
31
|
+
- Synthesize swarm reports into one coherent slice plan before broad edits.
|
|
32
|
+
- Integrate helper output yourself; own conflicts, final repairs, gates, branch state, PR state, and callback.
|
|
25
33
|
- Update the existing Markdown turn doc.
|
|
26
34
|
- Run local gates before PR when feasible.
|
|
27
35
|
- Open or update the PR.
|
|
28
36
|
- Do not create the review thread.
|
|
29
37
|
- Call back exactly once to the orchestrator.
|
|
30
38
|
- The callback payload must include `orchestrator_thread_id: "{{ORCHESTRATOR_THREAD_ID}}"` and your `source_thread_id`.
|
|
39
|
+
- The callback payload must include `swarm_summary` with scout, slice-plan, implementation-helper, slice, synthesis, and under-default rationale fields.
|
|
31
40
|
|
|
32
41
|
## Callback States
|
|
33
42
|
|
package/skills/dirtyloops/templates/workflows/orchestrator-callback/review-thread-prompt.md.template
CHANGED
|
@@ -22,12 +22,13 @@ Use:
|
|
|
22
22
|
- PR: `{{PR_URL_OR_ID}}`
|
|
23
23
|
- Branch/commit: `{{BRANCH_OR_COMMIT}}`
|
|
24
24
|
- Required gates: `{{QUALITY_GATES}}`
|
|
25
|
-
-
|
|
25
|
+
- Launch defaults: speed `standard`, reasoning `high`, inherit_orchestrator_thread_settings `false`, unless Beads metadata explicitly overrides the review actor
|
|
26
|
+
- Do not run this reviewer with inherited UI, recent thread, parent/orchestrator, `fast`, or `xhigh` settings unless Beads metadata explicitly overrides the review actor
|
|
26
27
|
|
|
27
28
|
## Rules
|
|
28
29
|
|
|
29
30
|
- Be ambitious about structural simplification.
|
|
30
|
-
- Use reviewer and CI verification subagents
|
|
31
|
+
- Use reviewer and CI verification subagents for review and CI evidence. If the phase is tiny enough to use fewer than the default review/CI agents, record why in the turn doc.
|
|
31
32
|
- Own CI through green, repaired-and-green, unavailable-with-evidence, or blocked-with-cause.
|
|
32
33
|
- Apply safe in-scope repairs when assigned by the orchestrator prompt.
|
|
33
34
|
- Update the existing Markdown turn doc.
|
package/skills/dirtyloops/templates/workflows/orchestrator-callback/run-loop-addendum.md.template
CHANGED
|
@@ -3,9 +3,15 @@
|
|
|
3
3
|
This loop uses a main orchestrator thread plus separate implementation and review threads.
|
|
4
4
|
|
|
5
5
|
- Only the orchestrator creates implementation and review threads.
|
|
6
|
+
- Before the first worker, the orchestrator launches a selector subagent to choose exactly one next ready Beads phase.
|
|
7
|
+
- After every review callback, the orchestrator launches a closeout-selector subagent before closing the phase, stopping, or launching another worker.
|
|
8
|
+
- Selector and closeout-selector subagents return `swarm-report` payloads with mission `selector` or `closeout-selector`; they do not mutate Beads, edit files, implement, review, repair, create threads, or advance the loop.
|
|
9
|
+
- Selector, implementation, review, and closeout-selector threads launch with explicit actor defaults: `speed: standard`, `reasoning: high`, and `inherit_orchestrator_thread_settings: false`, unless Beads metadata overrides that actor.
|
|
10
|
+
- Do not inherit current UI settings, recent Codex defaults, or orchestrator-thread speed/reasoning. `fast` speed and `xhigh` reasoning require explicit Beads metadata for the actor being launched.
|
|
6
11
|
- The orchestrator passes its concrete thread id as the callback target.
|
|
7
12
|
- Before launching a worker or reviewer, verify the actual prompt text includes that exact thread id and does not rely on generic wording like `current orchestrator thread` or `this thread`.
|
|
8
|
-
-
|
|
13
|
+
- After launching a worker or reviewer, wait for its single callback. Do not repeatedly read, monitor, summarize, or status-check the child thread while waiting.
|
|
14
|
+
- Use a sparse fallback heartbeat around 30 minutes only when the callback is overdue or liveness is uncertain; do not use heartbeat as routine polling.
|
|
9
15
|
- Implementation threads update the existing phase turn doc, open the PR, and call back exactly once when PR-ready or blocked.
|
|
10
16
|
- Implementation callback payloads must echo `orchestrator_thread_id` and include `source_thread_id`.
|
|
11
17
|
- Implementation threads do not create review threads.
|
|
@@ -13,5 +19,6 @@ This loop uses a main orchestrator thread plus separate implementation and revie
|
|
|
13
19
|
- Review threads own CI, repairs, reruns, and evidence.
|
|
14
20
|
- Review threads update the existing phase turn doc and call back exactly once when review and CI are resolved.
|
|
15
21
|
- Review callback payloads must echo `orchestrator_thread_id` and include `source_thread_id`.
|
|
16
|
-
- The orchestrator owns Beads closeout and next
|
|
17
|
-
-
|
|
22
|
+
- The orchestrator validates selector reports, owns Beads closeout, and launches only the selected next phase.
|
|
23
|
+
- Implementation threads are swarm-first for non-trivial phases: 8-20 scout agents, 8-16 slice-plan agents, and 8-16 implementation-helper agents before broad edits.
|
|
24
|
+
- The implementation thread synthesizes swarm reports into the existing turn doc, integrates helper output coherently, and includes `swarm_summary` in the implementation callback.
|
|
@@ -0,0 +1,35 @@
|
|
|
1
|
+
# Selector Subagent Prompt: {{STREAM_NAME}}
|
|
2
|
+
|
|
3
|
+
You are the selector subagent for an `orchestrator-callback` dirtyloop.
|
|
4
|
+
|
|
5
|
+
Canonical tracker: Beads epic `{{EPIC_ID}}`
|
|
6
|
+
|
|
7
|
+
Mission: select at most one next ready Beads phase for the orchestrator.
|
|
8
|
+
|
|
9
|
+
Launch defaults:
|
|
10
|
+
|
|
11
|
+
- speed: `standard`
|
|
12
|
+
- reasoning: `high`
|
|
13
|
+
- inherit_orchestrator_thread_settings: `false`
|
|
14
|
+
|
|
15
|
+
Do not run this selector with inherited UI, recent thread, parent/orchestrator, `fast`, or `xhigh` settings unless Beads metadata explicitly overrides the selector actor.
|
|
16
|
+
|
|
17
|
+
Read:
|
|
18
|
+
|
|
19
|
+
- Beads epic `{{EPIC_ID}}`
|
|
20
|
+
- Beads loop metadata
|
|
21
|
+
- `docs/implementation/{{STREAM_SLUG}}/IMPLEMENT.md`
|
|
22
|
+
- `docs/implementation/{{STREAM_SLUG}}/loop-state.md`
|
|
23
|
+
- linked phase docs for ready or nearly-ready child issues
|
|
24
|
+
|
|
25
|
+
Rules:
|
|
26
|
+
|
|
27
|
+
- Do not implement.
|
|
28
|
+
- Do not review.
|
|
29
|
+
- Do not mutate Beads.
|
|
30
|
+
- Do not edit files.
|
|
31
|
+
- Do not create implementation or review threads.
|
|
32
|
+
- Select exactly one phase only when Beads says it is ready and the linked phase doc is coherent.
|
|
33
|
+
- If no phase is ready or the state is ambiguous, report `blocked` with evidence.
|
|
34
|
+
|
|
35
|
+
Return a compact report matching `schemas/swarm-report.schema.json` with `mission: "selector"`.
|
package/skills/dirtyloops/templates/workflows/single-thread-subagent/run-loop-addendum.md.template
CHANGED
|
@@ -3,10 +3,11 @@
|
|
|
3
3
|
This loop runs in one visible Codex coordinator thread. Single-thread means one coordinator, not solo implementation.
|
|
4
4
|
|
|
5
5
|
- Do not create separate Codex worker or reviewer threads.
|
|
6
|
-
-
|
|
7
|
-
-
|
|
8
|
-
-
|
|
6
|
+
- For every phase, use selector, scout, slice-planning, implementation-helper, reviewer, and CI subagent swarms inside this thread.
|
|
7
|
+
- Default per-phase sizes: selector 4-8 agents, scout 8-20 agents, slice-plan 8-16 agents, implementation-helper 8-16 agents, reviewer 8-20 agents, and CI verification 4-12 agents.
|
|
8
|
+
- If a phase is tiny enough to use fewer than the default per-phase swarms, record why in the turn doc before implementation.
|
|
9
|
+
- Before implementation, run a slice planning swarm and synthesize the slice plan into the turn doc.
|
|
9
10
|
- The main thread owns integration, branch state, PR state, Beads updates, and closeout.
|
|
10
11
|
- Subagents inspect, compare, critique, split the phase into slices, prepare implementation guidance or patches, verify, and report.
|
|
11
12
|
- Subagents do not own loop state.
|
|
12
|
-
- The coordinator may implement glue, integration, conflict resolution, and final repairs. It must not do most
|
|
13
|
+
- The coordinator may implement glue, integration, conflict resolution, and final repairs. It must not do most discovery or implementation itself.
|