@davidbyoung/software-factory 0.1.3 → 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 +12 -11
- package/actions/factory-agent/action.yml +1 -1
- package/agents/factory-e2e-reviewer.md +102 -0
- package/agents/factory-test-reviewer.md +26 -64
- package/agents/factory-ticket-readiness.md +14 -6
- package/dist/cli.mjs +29 -2
- package/dist/commands.d.mts +16 -0
- package/dist/commands.mjs +129 -0
- package/dist/config.d.mts +61 -13
- package/dist/config.mjs +267 -65
- package/dist/deps.d.mts +7 -4
- package/dist/deps.mjs +20 -9
- package/dist/doctor.d.mts +3 -2
- package/dist/doctor.mjs +19 -4
- package/dist/explain.d.mts +4 -2
- package/dist/explain.mjs +66 -19
- package/dist/guard-commit.d.mts +7 -2
- package/dist/guard-commit.mjs +58 -21
- package/dist/init.d.mts +4 -2
- package/dist/init.mjs +15 -5
- package/dist/lib/default-branch.d.mts +35 -0
- package/dist/lib/default-branch.mjs +117 -0
- package/dist/lib/refined-check.d.mts +7 -0
- package/dist/lib/refined-check.mjs +76 -0
- package/dist/patch-coverage.d.mts +13 -0
- package/dist/patch-coverage.mjs +73 -0
- package/dist/pr-watch.d.mts +3 -2
- package/dist/pr-watch.mjs +22 -5
- package/dist/pr.mjs +34 -2
- package/dist/session-start.d.mts +23 -13
- package/dist/session-start.mjs +56 -44
- package/dist/site/servers.d.mts +6 -2
- package/dist/site/servers.mjs +14 -9
- package/dist/site.mjs +2 -2
- package/dist/sync.d.mts +8 -2
- package/dist/sync.mjs +40 -6
- package/dist/ticket.mjs +19 -1
- package/docs/builds.md +8 -8
- package/docs/cli.md +82 -45
- package/docs/configuration.md +455 -139
- package/docs/design.md +17 -4
- package/docs/developing.md +37 -6
- package/docs/existing-repo.md +8 -6
- package/docs/github/by-hand.md +23 -10
- package/docs/github/reference.md +19 -14
- package/docs/github/setup.md +12 -9
- package/docs/glossary.md +13 -3
- package/docs/limitations.md +27 -2
- package/docs/plugins.md +302 -48
- package/docs/quick-start.md +36 -8
- package/docs/removing.md +1 -1
- package/docs/skills.md +101 -52
- package/docs/updating.md +148 -3
- package/docs/workflow.md +13 -10
- package/package.json +1 -1
- package/review.md +20 -11
- package/rules.md +22 -18
- package/settings.schema.json +289 -69
- package/skills/factory-address-review/SKILL.md +50 -30
- package/skills/factory-build/SKILL.md +75 -22
- package/skills/factory-deps/SKILL.md +46 -21
- package/skills/factory-design/SKILL.md +17 -8
- package/skills/factory-diagnose/SKILL.md +22 -20
- package/skills/factory-mutate/SKILL.md +38 -24
- package/skills/factory-refine/SKILL.md +55 -31
- package/skills/factory-resolve-conflicts/SKILL.md +76 -34
- package/skills/factory-trace/SKILL.md +3 -2
- package/workflows/factory-build.yml +1 -1
- package/workflows/factory-conflicts.yml +8 -8
- package/workflows/factory-deps.yml +1 -1
- package/workflows/factory-review.yml +1 -1
- package/skills/factory-address-review/patch-coverage.py +0 -68
package/rules.md
CHANGED
|
@@ -13,7 +13,7 @@ and a pull request's conversation comments and labels through
|
|
|
13
13
|
|
|
14
14
|
A change is small when it changes under about 30 lines outside tests,
|
|
15
15
|
specs, and content, and adds no component and no state, whether or not a
|
|
16
|
-
|
|
16
|
+
user sees it: a style tweak, a bug fix, a link, or a line of copy. Its
|
|
17
17
|
size decides, not its kind; content the repository reviews by what changed
|
|
18
18
|
instead is named in "Small changes: this repository" in `CLAUDE.md`. A
|
|
19
19
|
follow-ups build is sized by its lines: when every line is small, its one
|
|
@@ -29,18 +29,20 @@ here rather than restate it.
|
|
|
29
29
|
- **Say the size first.** The first message of the work names the path,
|
|
30
30
|
such as "small: one test, red first, one UI reviewer read", so the
|
|
31
31
|
owner can overrule it before the work starts rather than halfway through.
|
|
32
|
-
- **No `spec` label**, even when a
|
|
32
|
+
- **No `spec` label**, even when a user sees it: the issue's acceptance
|
|
33
33
|
criteria are the spec. No OpenSpec change either, unless the change makes
|
|
34
34
|
a line of `openspec/specs/` false, as renaming a label a spec quotes
|
|
35
35
|
would. That issue also carries a Spec section of the changed line, and
|
|
36
36
|
the build archives a proposal and spec delta in the same pull request,
|
|
37
37
|
which then waits for the owner. A fix that restores what a spec says
|
|
38
38
|
changes no line of it.
|
|
39
|
-
- **No `factory-ticket-readiness` read and no
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
|
|
39
|
+
- **No `factory-ticket-readiness` read and no read by the test reviewers**
|
|
40
|
+
(`npx --no-install factory plugins test-reviewer` lists them), with two
|
|
41
|
+
exceptions that keep every test reviewer it prints whose `files`, if it
|
|
42
|
+
has any, the change touches: a change to
|
|
43
|
+
tests alone, the one kind they exist for, and code that builds what is
|
|
44
|
+
sent to an outside service, which "Small changes: this repository" in
|
|
45
|
+
`CLAUDE.md` names, since a broken payload loses data without a sound.
|
|
44
46
|
- **Tests.** A bug fix gets one test that reproduces the defect. A style
|
|
45
47
|
tweak gets one only when it sets what a check in the repository's design
|
|
46
48
|
guide measures, which "Small changes: this repository" in `CLAUDE.md`
|
|
@@ -53,7 +55,7 @@ here rather than restate it.
|
|
|
53
55
|
change, not one per way the code could break. A script proves each
|
|
54
56
|
behavior this way: script defects here have been silent data loss.
|
|
55
57
|
- **Choices.** One that is not layout, such as which page, what label, or
|
|
56
|
-
what it links to, is asked in plain English, saying what a
|
|
58
|
+
what it links to, is asked in plain English, saying what a user would
|
|
57
59
|
see. A layout or style choice gets no mockup round: build the
|
|
58
60
|
recommendation, put the UI reviewer's screenshots of it in the pull
|
|
59
61
|
request body, and leave the pull request a draft for the owner to mark
|
|
@@ -68,12 +70,14 @@ here rather than restate it.
|
|
|
68
70
|
|
|
69
71
|
## Branching, pushing, and review
|
|
70
72
|
|
|
71
|
-
|
|
73
|
+
The default branch, whose name `npx --no-install factory default-branch`
|
|
74
|
+
prints, is protected: no direct pushes, no bypass, CI must pass, and every
|
|
72
75
|
review thread must be resolved before a merge. Work accordingly rather than
|
|
73
76
|
discovering it at push time.
|
|
74
77
|
|
|
75
|
-
- **Never commit on
|
|
76
|
-
the latest origin
|
|
78
|
+
- **Never commit on the default branch.** If it is checked out, create a
|
|
79
|
+
branch from the latest copy of it on `origin` first and say which branch
|
|
80
|
+
you made. Reuse the
|
|
77
81
|
current feature branch when one is already checked out; a feature usually
|
|
78
82
|
spans several commits.
|
|
79
83
|
- **Push the branch after each coherent change.** Small commits are the point;
|
|
@@ -112,8 +116,8 @@ discovering it at push time.
|
|
|
112
116
|
wait for the review of that push, then work it with the `factory-address-review` skill
|
|
113
117
|
without being asked. If no PR exists yet, say so in one line: review begins
|
|
114
118
|
when the user opens one.
|
|
115
|
-
- **A conflict with
|
|
116
|
-
sweep runs after each merge into
|
|
119
|
+
- **A conflict with the default branch is fixed through the `factory-resolve-conflicts` skill.** Its
|
|
120
|
+
sweep runs after each merge into the default branch and nightly, on every ready pull
|
|
117
121
|
request that conflicts, and a session working a pull request with
|
|
118
122
|
`factory-address-review` runs its conflict fix before anything else. When the two
|
|
119
123
|
sides contradict, it pushes nothing, comments why, and opens an issue.
|
|
@@ -157,7 +161,7 @@ owner. Its `Who merges` status in the checks list says which, and why.
|
|
|
157
161
|
Agents never merge, enable auto-merge, or add the `verdict: override`
|
|
158
162
|
label, the owner's pass of the verdict for one commit; `factory pr label`
|
|
159
163
|
and `factory ticket label` refuse it, and the guard hook stops the ordinary
|
|
160
|
-
ways of adding it around them. Both workflows run from
|
|
164
|
+
ways of adding it around them. Both workflows run from the default branch's copy,
|
|
161
165
|
so a pull request cannot change how it is judged, and changes to them are
|
|
162
166
|
always the owner's.
|
|
163
167
|
|
|
@@ -172,7 +176,7 @@ into `openspec/specs/` in the same pull request. `openspec/specs/` is the
|
|
|
172
176
|
current description of what the repository does; a change to it starts by
|
|
173
177
|
reading its spec.
|
|
174
178
|
|
|
175
|
-
A change that adds or alters behavior a
|
|
179
|
+
A change that adds or alters behavior a user can see carries the
|
|
176
180
|
`spec` label, which `factory-refine` adds, unless it is small ("Small
|
|
177
181
|
changes" above). Everything else, such as copy, bug fixes that
|
|
178
182
|
restore intended behavior, style tweaks, tooling, CI, and docs, builds
|
|
@@ -225,7 +229,7 @@ labeled `follow-up`, holding a checklist. A line leads with the file or
|
|
|
225
229
|
page it is about:
|
|
226
230
|
|
|
227
231
|
```
|
|
228
|
-
- [ ] <file or page>: <what is wrong, as a
|
|
232
|
+
- [ ] <file or page>: <what is wrong, as a user or a maintainer sees it>. Found by <who> while building #N. <The rule it breaks, by its section in the guide that states it (an area's guide under "Rules by area" in CLAUDE.md, CLAUDE.md, or this file), or "Needs a decision: <the question>".>
|
|
229
233
|
```
|
|
230
234
|
|
|
231
235
|
It is added with the file and the rest of the line as two arguments, and
|
|
@@ -253,7 +257,7 @@ hook refuses the same in text sent to GitHub directly, as the
|
|
|
253
257
|
builder that meets such a line without the phrase adds it and leaves
|
|
254
258
|
the line unchecked.
|
|
255
259
|
- A follow-up gets its own issue only when it would need the `spec` label,
|
|
256
|
-
because it adds or alters behavior a
|
|
260
|
+
because it adds or alters behavior a user can see, or would make a
|
|
257
261
|
line of `openspec/specs/` false. A request from the owner is always its
|
|
258
262
|
own issue.
|
|
259
263
|
- The `factory-resolve-conflicts` conflict stop keeps opening its own issue: which side
|
|
@@ -272,7 +276,7 @@ touches a file that does, and gets the fresh-agent trace ("Changing the
|
|
|
272
276
|
process") when any line edits a rule.
|
|
273
277
|
|
|
274
278
|
**Not everything noticed is a follow-up.** What breaks no rule in the
|
|
275
|
-
guides, and what a
|
|
279
|
+
guides, and what a user or a maintainer would not notice without
|
|
276
280
|
measuring, gets no line and no fix. Once, every line left on a follow-ups
|
|
277
281
|
issue came from reviewing the previous batch's fixes, including a 1 px
|
|
278
282
|
jump, and each line's fix was reviewed in turn, so the list kept refilling
|
package/settings.schema.json
CHANGED
|
@@ -7,8 +7,8 @@
|
|
|
7
7
|
"required": ["version", "repository"],
|
|
8
8
|
"properties": {
|
|
9
9
|
"version": {
|
|
10
|
-
"const":
|
|
11
|
-
"description": "The shape of this file, not the factory's version. Must be
|
|
10
|
+
"const": 2,
|
|
11
|
+
"description": "The shape of this file, not the factory's version. Must be 2."
|
|
12
12
|
},
|
|
13
13
|
"repository": {
|
|
14
14
|
"type": "string",
|
|
@@ -41,7 +41,7 @@
|
|
|
41
41
|
"$ref": "#/definitions/builds"
|
|
42
42
|
},
|
|
43
43
|
"specs": {
|
|
44
|
-
"description": "How the written spec for a visible change is kept: openspec, or
|
|
44
|
+
"description": "How the written spec for a visible change is kept: openspec or none as one word, or a block with a type and the command that checks the specs.",
|
|
45
45
|
"anyOf": [
|
|
46
46
|
{
|
|
47
47
|
"$ref": "#/definitions/specs/properties/type"
|
|
@@ -51,28 +51,11 @@
|
|
|
51
51
|
}
|
|
52
52
|
]
|
|
53
53
|
},
|
|
54
|
-
"
|
|
55
|
-
"
|
|
56
|
-
"items": {
|
|
57
|
-
"type": "string",
|
|
58
|
-
"minLength": 1
|
|
59
|
-
},
|
|
60
|
-
"description": "Commands run from the repository's root before every commit a session makes. If one fails, the commit is blocked."
|
|
61
|
-
},
|
|
62
|
-
"build-setup": {
|
|
63
|
-
"type": "array",
|
|
64
|
-
"items": {
|
|
65
|
-
"type": "string",
|
|
66
|
-
"minLength": 1
|
|
67
|
-
},
|
|
68
|
-
"description": "Commands run from the repository's root before an unattended build starts work."
|
|
54
|
+
"commands": {
|
|
55
|
+
"$ref": "#/definitions/commands"
|
|
69
56
|
},
|
|
70
57
|
"plugins": {
|
|
71
|
-
"
|
|
72
|
-
"description": "Your own skills and agents.",
|
|
73
|
-
"items": {
|
|
74
|
-
"$ref": "#/definitions/plugins[]"
|
|
75
|
-
}
|
|
58
|
+
"$ref": "#/definitions/plugins"
|
|
76
59
|
},
|
|
77
60
|
"auto-merge": {
|
|
78
61
|
"$ref": "#/definitions/auto-merge"
|
|
@@ -217,9 +200,292 @@
|
|
|
217
200
|
"type": {
|
|
218
201
|
"enum": ["none", "openspec"],
|
|
219
202
|
"description": "How the spec for a visible change is kept. Default: none."
|
|
203
|
+
},
|
|
204
|
+
"check": {
|
|
205
|
+
"type": "string",
|
|
206
|
+
"minLength": 1,
|
|
207
|
+
"description": "The command that checks the specs, run from the repository's root with DO_NOT_TRACK=1. Needs type: openspec. Default: npx --no-install openspec validate --all --strict --no-interactive."
|
|
208
|
+
}
|
|
209
|
+
}
|
|
210
|
+
},
|
|
211
|
+
"commands": {
|
|
212
|
+
"type": "object",
|
|
213
|
+
"description": "Every command a build runs, each from the repository's root.",
|
|
214
|
+
"additionalProperties": false,
|
|
215
|
+
"properties": {
|
|
216
|
+
"build-setup": {
|
|
217
|
+
"type": "array",
|
|
218
|
+
"items": {
|
|
219
|
+
"type": "string",
|
|
220
|
+
"minLength": 1
|
|
221
|
+
},
|
|
222
|
+
"description": "Commands run before an unattended build starts work."
|
|
223
|
+
},
|
|
224
|
+
"before-commit": {
|
|
225
|
+
"type": "array",
|
|
226
|
+
"items": {
|
|
227
|
+
"type": "string",
|
|
228
|
+
"minLength": 1
|
|
229
|
+
},
|
|
230
|
+
"description": "Commands run before every commit a session makes. If one fails, the commit is blocked."
|
|
231
|
+
},
|
|
232
|
+
"gate": {
|
|
233
|
+
"type": "array",
|
|
234
|
+
"items": {
|
|
235
|
+
"type": "string",
|
|
236
|
+
"minLength": 1
|
|
237
|
+
},
|
|
238
|
+
"description": "Commands that check a change, run in order before a session reports a task done."
|
|
239
|
+
},
|
|
240
|
+
"test-one": {
|
|
241
|
+
"type": "string",
|
|
242
|
+
"minLength": 1,
|
|
243
|
+
"description": "Runs one test alone. $FILE is the test's file and $NAME the test's name, empty for the whole file."
|
|
244
|
+
},
|
|
245
|
+
"end-to-end": {
|
|
246
|
+
"type": "string",
|
|
247
|
+
"minLength": 1,
|
|
248
|
+
"description": "Runs one end-to-end spec alone. $FILE is the spec's file."
|
|
249
|
+
},
|
|
250
|
+
"coverage": {
|
|
251
|
+
"$ref": "#/definitions/commands.coverage"
|
|
252
|
+
},
|
|
253
|
+
"relock": {
|
|
254
|
+
"type": "string",
|
|
255
|
+
"minLength": 1,
|
|
256
|
+
"description": "Rebuilds the package manager's lock file after a conflict in it. Default: npm install."
|
|
257
|
+
}
|
|
258
|
+
}
|
|
259
|
+
},
|
|
260
|
+
"commands.coverage": {
|
|
261
|
+
"type": "object",
|
|
262
|
+
"description": "How coverage is measured, and where its report lands.",
|
|
263
|
+
"additionalProperties": false,
|
|
264
|
+
"properties": {
|
|
265
|
+
"run": {
|
|
266
|
+
"type": "string",
|
|
267
|
+
"minLength": 1,
|
|
268
|
+
"description": "The command that measures coverage."
|
|
269
|
+
},
|
|
270
|
+
"report": {
|
|
271
|
+
"type": "string",
|
|
272
|
+
"minLength": 1,
|
|
273
|
+
"description": "The path of the lcov report the command writes."
|
|
274
|
+
}
|
|
275
|
+
},
|
|
276
|
+
"required": ["run", "report"]
|
|
277
|
+
},
|
|
278
|
+
"plugins": {
|
|
279
|
+
"type": "object",
|
|
280
|
+
"description": "Your own skills and agents, grouped by the phase they work in. Every slot is optional.",
|
|
281
|
+
"additionalProperties": false,
|
|
282
|
+
"properties": {
|
|
283
|
+
"refine": {
|
|
284
|
+
"$ref": "#/definitions/plugins.refine"
|
|
285
|
+
},
|
|
286
|
+
"build": {
|
|
287
|
+
"$ref": "#/definitions/plugins.build"
|
|
288
|
+
},
|
|
289
|
+
"test": {
|
|
290
|
+
"$ref": "#/definitions/plugins.test"
|
|
291
|
+
},
|
|
292
|
+
"conflicts": {
|
|
293
|
+
"$ref": "#/definitions/plugins.conflicts"
|
|
294
|
+
}
|
|
295
|
+
}
|
|
296
|
+
},
|
|
297
|
+
"plugins.refine": {
|
|
298
|
+
"type": "object",
|
|
299
|
+
"description": "Plug-ins for refining a ticket.",
|
|
300
|
+
"additionalProperties": false,
|
|
301
|
+
"properties": {
|
|
302
|
+
"refiner": {
|
|
303
|
+
"$ref": "#/definitions/plugins.refine.refiner"
|
|
304
|
+
},
|
|
305
|
+
"mockups": {
|
|
306
|
+
"$ref": "#/definitions/plugins.refine.mockups"
|
|
307
|
+
}
|
|
308
|
+
}
|
|
309
|
+
},
|
|
310
|
+
"plugins.build": {
|
|
311
|
+
"type": "object",
|
|
312
|
+
"description": "Plug-ins for building a ticket.",
|
|
313
|
+
"additionalProperties": false,
|
|
314
|
+
"properties": {
|
|
315
|
+
"builders": {
|
|
316
|
+
"type": "array",
|
|
317
|
+
"description": "Skills that build a ticket carrying one of their labels.",
|
|
318
|
+
"items": {
|
|
319
|
+
"$ref": "#/definitions/plugins.build.builders[]"
|
|
320
|
+
}
|
|
321
|
+
},
|
|
322
|
+
"reviewers": {
|
|
323
|
+
"type": "array",
|
|
324
|
+
"description": "Agents considered when a change touches one of their files.",
|
|
325
|
+
"items": {
|
|
326
|
+
"$ref": "#/definitions/plugins.build.reviewers[]"
|
|
327
|
+
}
|
|
328
|
+
}
|
|
329
|
+
}
|
|
330
|
+
},
|
|
331
|
+
"plugins.test": {
|
|
332
|
+
"type": "object",
|
|
333
|
+
"description": "Plug-ins for a change's tests.",
|
|
334
|
+
"additionalProperties": false,
|
|
335
|
+
"properties": {
|
|
336
|
+
"prover": {
|
|
337
|
+
"$ref": "#/definitions/plugins.test.prover"
|
|
338
|
+
},
|
|
339
|
+
"reviewers": {
|
|
340
|
+
"type": "array",
|
|
341
|
+
"description": "The whole list of agents that read a change's tests. Default: factory-test-reviewer alone.",
|
|
342
|
+
"items": {
|
|
343
|
+
"$ref": "#/definitions/plugins.test.reviewers[]"
|
|
344
|
+
}
|
|
220
345
|
}
|
|
221
346
|
}
|
|
222
347
|
},
|
|
348
|
+
"plugins.conflicts": {
|
|
349
|
+
"type": "object",
|
|
350
|
+
"description": "Plug-ins for a conflict with the default branch.",
|
|
351
|
+
"additionalProperties": false,
|
|
352
|
+
"properties": {
|
|
353
|
+
"resolvers": {
|
|
354
|
+
"type": "array",
|
|
355
|
+
"description": "Skills that rebuild their files after a conflict, in place of a merge by hand.",
|
|
356
|
+
"items": {
|
|
357
|
+
"$ref": "#/definitions/plugins.conflicts.resolvers[]"
|
|
358
|
+
}
|
|
359
|
+
}
|
|
360
|
+
}
|
|
361
|
+
},
|
|
362
|
+
"plugins.refine.refiner": {
|
|
363
|
+
"type": "object",
|
|
364
|
+
"description": "The skill that refines a ticket, in place of factory-refine.",
|
|
365
|
+
"additionalProperties": false,
|
|
366
|
+
"properties": {
|
|
367
|
+
"skill": {
|
|
368
|
+
"type": "string",
|
|
369
|
+
"pattern": "^[\\w-]+$",
|
|
370
|
+
"description": "The name of one of your own skills, in .claude/skills/."
|
|
371
|
+
}
|
|
372
|
+
},
|
|
373
|
+
"required": ["skill"]
|
|
374
|
+
},
|
|
375
|
+
"plugins.refine.mockups": {
|
|
376
|
+
"type": "object",
|
|
377
|
+
"description": "The skill that makes pictures when a decision changes the look.",
|
|
378
|
+
"additionalProperties": false,
|
|
379
|
+
"properties": {
|
|
380
|
+
"skill": {
|
|
381
|
+
"type": "string",
|
|
382
|
+
"pattern": "^[\\w-]+$",
|
|
383
|
+
"description": "The name of one of your own skills, in .claude/skills/."
|
|
384
|
+
}
|
|
385
|
+
},
|
|
386
|
+
"required": ["skill"]
|
|
387
|
+
},
|
|
388
|
+
"plugins.build.builders[]": {
|
|
389
|
+
"type": "object",
|
|
390
|
+
"description": "One builder.",
|
|
391
|
+
"additionalProperties": false,
|
|
392
|
+
"properties": {
|
|
393
|
+
"skill": {
|
|
394
|
+
"type": "string",
|
|
395
|
+
"pattern": "^[\\w-]+$",
|
|
396
|
+
"description": "The name of one of your own skills, in .claude/skills/."
|
|
397
|
+
},
|
|
398
|
+
"labels": {
|
|
399
|
+
"type": "array",
|
|
400
|
+
"minItems": 1,
|
|
401
|
+
"items": {
|
|
402
|
+
"type": "string",
|
|
403
|
+
"minLength": 1
|
|
404
|
+
},
|
|
405
|
+
"description": "It builds a ticket carrying one of these labels."
|
|
406
|
+
}
|
|
407
|
+
},
|
|
408
|
+
"required": ["skill", "labels"]
|
|
409
|
+
},
|
|
410
|
+
"plugins.build.reviewers[]": {
|
|
411
|
+
"type": "object",
|
|
412
|
+
"description": "One reviewer of a change.",
|
|
413
|
+
"additionalProperties": false,
|
|
414
|
+
"properties": {
|
|
415
|
+
"agent": {
|
|
416
|
+
"type": "string",
|
|
417
|
+
"pattern": "^[\\w-]+$",
|
|
418
|
+
"description": "The name of an agent, in .claude/agents/."
|
|
419
|
+
},
|
|
420
|
+
"files": {
|
|
421
|
+
"type": "array",
|
|
422
|
+
"minItems": 1,
|
|
423
|
+
"items": {
|
|
424
|
+
"type": "string",
|
|
425
|
+
"minLength": 1
|
|
426
|
+
},
|
|
427
|
+
"description": "It is considered when a change touches one of these."
|
|
428
|
+
}
|
|
429
|
+
},
|
|
430
|
+
"required": ["agent", "files"]
|
|
431
|
+
},
|
|
432
|
+
"plugins.test.prover": {
|
|
433
|
+
"type": "object",
|
|
434
|
+
"description": "The skill that proves a new test can fail, in place of factory-mutate.",
|
|
435
|
+
"additionalProperties": false,
|
|
436
|
+
"properties": {
|
|
437
|
+
"skill": {
|
|
438
|
+
"type": "string",
|
|
439
|
+
"pattern": "^[\\w-]+$",
|
|
440
|
+
"description": "The name of one of your own skills, in .claude/skills/."
|
|
441
|
+
}
|
|
442
|
+
},
|
|
443
|
+
"required": ["skill"]
|
|
444
|
+
},
|
|
445
|
+
"plugins.test.reviewers[]": {
|
|
446
|
+
"type": "object",
|
|
447
|
+
"description": "One reviewer of a change's tests.",
|
|
448
|
+
"additionalProperties": false,
|
|
449
|
+
"properties": {
|
|
450
|
+
"agent": {
|
|
451
|
+
"type": "string",
|
|
452
|
+
"pattern": "^[\\w-]+$",
|
|
453
|
+
"description": "The name of an agent, in .claude/agents/."
|
|
454
|
+
},
|
|
455
|
+
"files": {
|
|
456
|
+
"type": "array",
|
|
457
|
+
"minItems": 1,
|
|
458
|
+
"items": {
|
|
459
|
+
"type": "string",
|
|
460
|
+
"minLength": 1
|
|
461
|
+
},
|
|
462
|
+
"description": "It is considered only when a change touches one of these. Left out, it is considered whenever a change touches tests."
|
|
463
|
+
}
|
|
464
|
+
},
|
|
465
|
+
"required": ["agent"]
|
|
466
|
+
},
|
|
467
|
+
"plugins.conflicts.resolvers[]": {
|
|
468
|
+
"type": "object",
|
|
469
|
+
"description": "One resolver.",
|
|
470
|
+
"additionalProperties": false,
|
|
471
|
+
"properties": {
|
|
472
|
+
"skill": {
|
|
473
|
+
"type": "string",
|
|
474
|
+
"pattern": "^[\\w-]+$",
|
|
475
|
+
"description": "The name of one of your own skills, in .claude/skills/."
|
|
476
|
+
},
|
|
477
|
+
"files": {
|
|
478
|
+
"type": "array",
|
|
479
|
+
"minItems": 1,
|
|
480
|
+
"items": {
|
|
481
|
+
"type": "string",
|
|
482
|
+
"minLength": 1
|
|
483
|
+
},
|
|
484
|
+
"description": "It resolves a conflict in one of these."
|
|
485
|
+
}
|
|
486
|
+
},
|
|
487
|
+
"required": ["skill", "files"]
|
|
488
|
+
},
|
|
223
489
|
"auto-merge": {
|
|
224
490
|
"type": "object",
|
|
225
491
|
"description": "Which pull requests may merge without you.",
|
|
@@ -341,52 +607,6 @@
|
|
|
341
607
|
},
|
|
342
608
|
"required": ["start", "url"]
|
|
343
609
|
},
|
|
344
|
-
"plugins[]": {
|
|
345
|
-
"type": "object",
|
|
346
|
-
"description": "One skill or one agent.",
|
|
347
|
-
"additionalProperties": false,
|
|
348
|
-
"properties": {
|
|
349
|
-
"skill": {
|
|
350
|
-
"type": "string",
|
|
351
|
-
"pattern": "^[\\w-]+$",
|
|
352
|
-
"description": "The name of one of your own skills, in .claude/skills/."
|
|
353
|
-
},
|
|
354
|
-
"agent": {
|
|
355
|
-
"type": "string",
|
|
356
|
-
"pattern": "^[\\w-]+$",
|
|
357
|
-
"description": "The name of one of your own agents, in .claude/agents/."
|
|
358
|
-
},
|
|
359
|
-
"role": {
|
|
360
|
-
"enum": ["mockups", "builder", "reviewer"],
|
|
361
|
-
"description": "What the plug-in does: mockups, builder, or reviewer."
|
|
362
|
-
},
|
|
363
|
-
"files": {
|
|
364
|
-
"type": "array",
|
|
365
|
-
"items": {
|
|
366
|
-
"type": "string",
|
|
367
|
-
"minLength": 1
|
|
368
|
-
},
|
|
369
|
-
"description": "For a reviewer: it is considered when a change touches one of these."
|
|
370
|
-
},
|
|
371
|
-
"labels": {
|
|
372
|
-
"type": "array",
|
|
373
|
-
"items": {
|
|
374
|
-
"type": "string",
|
|
375
|
-
"minLength": 1
|
|
376
|
-
},
|
|
377
|
-
"description": "For a builder: it builds a ticket carrying one of these labels."
|
|
378
|
-
}
|
|
379
|
-
},
|
|
380
|
-
"required": ["role"],
|
|
381
|
-
"oneOf": [
|
|
382
|
-
{
|
|
383
|
-
"required": ["skill"]
|
|
384
|
-
},
|
|
385
|
-
{
|
|
386
|
-
"required": ["agent"]
|
|
387
|
-
}
|
|
388
|
-
]
|
|
389
|
-
},
|
|
390
610
|
"session-minutes": {
|
|
391
611
|
"type": "object",
|
|
392
612
|
"description": "How long each kind of unattended session may run, in minutes. The job around it gets 10 more. GitHub's own runners stop a job at 6 hours, so a value above 350 does nothing there.",
|