summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMatt Pocock <mattpocockvoice@gmail.com>2026-11-12 08:42:38 +0000
committerGitHub <noreply@github.com>2026-11-12 08:42:38 +0000
commit5863806dd4e15c63174bee4e7515a4256792ecfa (patch)
treedc6b596b851e6a987f86aeb934672d28cb767e5f
parent4ae2317ddb22b046e26455e4f9c9b3aaaf62212d (diff)
parentd18183fe9d96e1240105a8534e53591e9b49afd7 (diff)
Merge pull request #1416 from mattpocock/software-factory-task-wording
software-factory: "job" is the CI vendor's word; explore leaves findings
-rw-r--r--skills/in-progress/software-factory/EXAMPLE-TASKS.md2
-rw-r--r--skills/in-progress/software-factory/SKILL.md2
2 files changed, 2 insertions, 2 deletions
diff --git a/skills/in-progress/software-factory/EXAMPLE-TASKS.md b/skills/in-progress/software-factory/EXAMPLE-TASKS.md
index fc0972b..acb0f2b 100644
--- a/skills/in-progress/software-factory/EXAMPLE-TASKS.md
+++ b/skills/in-progress/software-factory/EXAMPLE-TASKS.md
@@ -6,7 +6,7 @@ Tasks grouped by the problem they solve. Each names the trigger that starts its
**Explore task**
- Trigger: a ticket is created, or a human labels it.
-- Does: checks the ticket against the codebase and sorts it into a category (easy call, needs a human, not a bug).
+- Does: checks the ticket's claims against the codebase, reproducing them where it can, sorts it into a category (easy call, needs a human, not a bug), and leaves its findings on the ticket for the implementer. It never pushes.
- Triggers: an implementer run for easy calls. Anything else ends with the ticket labelled as waiting for a human.
## Ready tickets wait for someone to build them
diff --git a/skills/in-progress/software-factory/SKILL.md b/skills/in-progress/software-factory/SKILL.md
index c60583a..8152f6d 100644
--- a/skills/in-progress/software-factory/SKILL.md
+++ b/skills/in-progress/software-factory/SKILL.md
@@ -10,7 +10,7 @@ A **software factory** is a system of agents that turns tickets, PRs and schedul
**Task**:
A kind of work the factory performs, defined once and run many times: review, explore, implement, ratchet. A task may work on a ticket, a PR, or the codebase as a whole.
-_Avoid_: job, workflow, action
+_Avoid_: job, workflow, action, as names for the task. A CI vendor's workflow file and its jobs are where a task is wired up, not the task.
**Trigger**:
The event that starts a run: a change in the ticket tracker or git host, a clock in the orchestrator, or another run.