@davidbyoung/software-factory 0.1.3 → 0.1.5

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.
Files changed (80) hide show
  1. package/README.md +12 -11
  2. package/actions/factory-agent/action.yml +1 -1
  3. package/agents/factory-e2e-reviewer.md +102 -0
  4. package/agents/factory-test-reviewer.md +26 -64
  5. package/agents/factory-ticket-readiness.md +14 -6
  6. package/dist/cli.mjs +28 -1
  7. package/dist/code-host/github-setup.mjs +1 -1
  8. package/dist/commands.d.mts +16 -0
  9. package/dist/commands.mjs +129 -0
  10. package/dist/config.d.mts +61 -13
  11. package/dist/config.mjs +271 -69
  12. package/dist/deps.d.mts +7 -4
  13. package/dist/deps.mjs +20 -9
  14. package/dist/doctor.d.mts +3 -2
  15. package/dist/doctor.mjs +19 -4
  16. package/dist/explain.d.mts +4 -2
  17. package/dist/explain.mjs +70 -23
  18. package/dist/guard-commit.d.mts +7 -2
  19. package/dist/guard-commit.mjs +58 -21
  20. package/dist/init.d.mts +4 -2
  21. package/dist/init.mjs +18 -8
  22. package/dist/lib/default-branch.d.mts +35 -0
  23. package/dist/lib/default-branch.mjs +117 -0
  24. package/dist/lib/refined-check.d.mts +7 -0
  25. package/dist/lib/refined-check.mjs +76 -0
  26. package/dist/lib/work-status.d.mts +2 -2
  27. package/dist/lib/work-status.mjs +4 -4
  28. package/dist/parts.d.mts +1 -1
  29. package/dist/parts.mjs +2 -2
  30. package/dist/patch-coverage.d.mts +13 -0
  31. package/dist/patch-coverage.mjs +73 -0
  32. package/dist/pr-watch.d.mts +3 -2
  33. package/dist/pr-watch.mjs +22 -5
  34. package/dist/pr.mjs +34 -2
  35. package/dist/review-cost.mjs +1 -1
  36. package/dist/review-tools.mjs +3 -3
  37. package/dist/session-start.d.mts +23 -13
  38. package/dist/session-start.mjs +56 -44
  39. package/dist/site/servers.d.mts +6 -2
  40. package/dist/site/servers.mjs +14 -9
  41. package/dist/site.mjs +2 -2
  42. package/dist/sync.d.mts +8 -2
  43. package/dist/sync.mjs +41 -7
  44. package/dist/ticket.mjs +19 -1
  45. package/docs/builds.md +8 -8
  46. package/docs/cli.md +82 -45
  47. package/docs/configuration.md +838 -565
  48. package/docs/design.md +17 -4
  49. package/docs/developing.md +44 -8
  50. package/docs/existing-repo.md +9 -7
  51. package/docs/github/by-hand.md +27 -14
  52. package/docs/github/reference.md +21 -16
  53. package/docs/github/setup.md +14 -11
  54. package/docs/glossary.md +14 -5
  55. package/docs/limitations.md +27 -2
  56. package/docs/plugins.md +307 -52
  57. package/docs/quick-start.md +37 -9
  58. package/docs/removing.md +2 -2
  59. package/docs/skills.md +103 -54
  60. package/docs/updating.md +149 -3
  61. package/docs/workflow.md +13 -10
  62. package/package.json +1 -1
  63. package/review.md +20 -11
  64. package/rules.md +23 -19
  65. package/settings.schema.json +292 -72
  66. package/skills/factory-address-review/SKILL.md +50 -30
  67. package/skills/factory-build/SKILL.md +76 -23
  68. package/skills/factory-deps/SKILL.md +46 -21
  69. package/skills/factory-design/SKILL.md +18 -9
  70. package/skills/factory-diagnose/SKILL.md +22 -20
  71. package/skills/factory-mutate/SKILL.md +38 -24
  72. package/skills/factory-refine/SKILL.md +55 -31
  73. package/skills/factory-resolve-conflicts/SKILL.md +76 -34
  74. package/skills/factory-trace/SKILL.md +3 -2
  75. package/workflows/factory-build.yml +1 -1
  76. package/workflows/factory-claude-review.yml +1 -1
  77. package/workflows/factory-conflicts.yml +8 -8
  78. package/workflows/factory-deps.yml +1 -1
  79. package/workflows/factory-review.yml +1 -1
  80. 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
- visitor sees it: a style tweak, a bug fix, a link, or a line of copy. Its
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 visitor sees it: the issue's acceptance
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 `factory-test-reviewer` read**, with two
40
- exceptions that keep `factory-test-reviewer`: a change to tests alone, the one
41
- kind it exists for, and code that builds what is sent to an outside
42
- service, which "Small changes: this repository" in `CLAUDE.md` names,
43
- since a broken payload loses data without a sound.
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 visitor would
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
@@ -62,18 +64,20 @@ here rather than restate it.
62
64
  - For a visible change, a UI reviewer read pointed at the states the change
63
65
  touched, not every size and scheme, and told the change is small. The UI
64
66
  reviewer is `factory-ui-reviewer` where the repository lists it, and
65
- otherwise the repository's own, among its reviewer plug-ins
67
+ otherwise the repository's own, among its reviewer plugins
66
68
  (`npx --no-install factory plugins reviewer`).
67
69
  - The gate and CI stay. The pull request says it took this path.
68
70
 
69
71
  ## Branching, pushing, and review
70
72
 
71
- `main` is protected: no direct pushes, no bypass, CI must pass, and every
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 `main`.** If `main` is checked out, create a branch from
76
- the latest origin/main first and say which branch you made. Reuse the
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 main is fixed through the `factory-resolve-conflicts` skill.** Its
116
- sweep runs after each merge into main and nightly, on every ready pull
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 main's copy,
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 visitor can see carries the
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 visitor 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>".>
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 visitor can see, or would make 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 visitor or a maintainer would not notice without
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
@@ -7,8 +7,8 @@
7
7
  "required": ["version", "repository"],
8
8
  "properties": {
9
9
  "version": {
10
- "const": 1,
11
- "description": "The shape of this file, not the factory's version. Must be 1."
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 none.",
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,34 +51,17 @@
51
51
  }
52
52
  ]
53
53
  },
54
- "before-commit": {
55
- "type": "array",
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
- "type": "array",
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"
79
62
  },
80
- "ci-review": {
81
- "$ref": "#/definitions/ci-review"
63
+ "pr-review": {
64
+ "$ref": "#/definitions/pr-review"
82
65
  },
83
66
  "site": {
84
67
  "$ref": "#/definitions/site"
@@ -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 role 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": "Plugins 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": "Plugins 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": "Plugins 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": "Plugins 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.",
@@ -251,7 +517,7 @@
251
517
  }
252
518
  }
253
519
  },
254
- "ci-review": {
520
+ "pr-review": {
255
521
  "type": ["object", "null"],
256
522
  "additionalProperties": false,
257
523
  "description": "The automated review of every pull request: on when this is written, even with nothing under it.",
@@ -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.",