summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMatt Pocock <bot@x>2026-11-11 14:40:16 +0000
committerMatt Pocock <bot@x>2026-11-11 14:40:16 +0000
commitd18183fe9d96e1240105a8534e53591e9b49afd7 (patch)
treedc6b596b851e6a987f86aeb934672d28cb767e5f
parent4ae2317ddb22b046e26455e4f9c9b3aaaf62212d (diff)
software-factory: "job" is the CI vendor's word; explore leaves findingssoftware-factory-task-wording
A Cohort 005 student found two drifts between this skill and the course's factory: the workflow files say "the explore job" while the skill avoids "job" for a task, and the course's explore run reproduces claims and leaves findings, where the example only sorted the ticket. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
-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.