@outerlayer/cli 0.40.0-next.20261116200629 → 0.40.0-next.20261116212619

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 (48) hide show
  1. package/README.md +7 -4
  2. package/dist/build-info.json +1 -1
  3. package/dist/{caller-YLCG35RW.js → caller-CRTXYQS6.js} +2 -2
  4. package/dist/{check-XF4J5PFS.js → check-XAP6HCDV.js} +10 -10
  5. package/dist/{chunk-KDLZOXBP.js → chunk-2QG2WHQI.js} +1 -1
  6. package/dist/{chunk-O7QTZ6FY.js → chunk-5DVAYNM5.js} +1 -1
  7. package/dist/{chunk-K4AQVH47.js → chunk-6QK75VD2.js} +2 -2
  8. package/dist/{chunk-JKOSEEDV.js → chunk-7CBNPW6A.js} +3 -3
  9. package/dist/{chunk-GH7RYZTX.js → chunk-DGGAQMSV.js} +1 -1
  10. package/dist/{chunk-IVRP4E3F.js → chunk-ECTZGGQK.js} +1 -1
  11. package/dist/{chunk-Y25XOGFX.js → chunk-EZHWM7GN.js} +3 -3
  12. package/dist/{chunk-OFEHPNPJ.js → chunk-GPROFAKS.js} +1 -1
  13. package/dist/{chunk-77FYM6CF.js → chunk-LIJQWC67.js} +1 -1
  14. package/dist/{chunk-2VYD47YW.js → chunk-P27TZI3C.js} +1 -1
  15. package/dist/{chunk-EEPR5MSY.js → chunk-QL5LCZBO.js} +8 -8
  16. package/dist/{chunk-YB7QOJJ6.js → chunk-S6EOMJPK.js} +3 -3
  17. package/dist/{chunk-3DKYI6V7.js → chunk-SGVQ25MY.js} +5 -6
  18. package/dist/{chunk-CYUAZGM5.js → chunk-SQTRQ7FW.js} +1 -1
  19. package/dist/{chunk-5EHW7SBY.js → chunk-Y3RV5MQ5.js} +3 -3
  20. package/dist/{chunk-MTZ43GKQ.js → chunk-Z5PJYTDX.js} +3 -3
  21. package/dist/{cli-E4FIPVXA.js → cli-P6D6V32C.js} +45 -45
  22. package/dist/{command-JOFIZTRB.js → command-YAQT6PDZ.js} +8 -8
  23. package/dist/{config-2FFE76CU.js → config-WQJ4G4RX.js} +1 -1
  24. package/dist/{container-start-PEWYWFZJ.js → container-start-OLNAXXIY.js} +7 -7
  25. package/dist/{doctor-IJUVLEOA.js → doctor-ELHDWI23.js} +7 -7
  26. package/dist/{find-unit-HCJCNGAO.js → find-unit-AN4NVRPI.js} +3 -3
  27. package/dist/{host-checks-IHDOXH4L.js → host-checks-RYP4O2UZ.js} +5 -5
  28. package/dist/index.js +1 -1
  29. package/dist/{init-IPCLZQTH.js → init-CWT6EH5O.js} +5 -5
  30. package/dist/{init-NMALA2L3.js → init-WIPXHMMD.js} +5 -5
  31. package/dist/{init-agent-O2INKCJ2.js → init-agent-O6I7H3YM.js} +5 -5
  32. package/dist/{init-cmd-EAIFTS3D.js → init-cmd-7QCIXIVX.js} +2 -2
  33. package/dist/{install-cmd-IGD4QKRJ.js → install-cmd-K5XY4AIM.js} +2 -2
  34. package/dist/{launch-agent-MAOBOT2E.js → launch-agent-CAM7STGX.js} +3 -3
  35. package/dist/{loop-W3SG6T77.js → loop-FK6QMKHB.js} +9 -9
  36. package/dist/{machine-2JEIPALV.js → machine-ZAZCD7GG.js} +5 -5
  37. package/dist/{runner-env-RFL275DT.js → runner-env-SXG27CAD.js} +3 -3
  38. package/dist/{runner-key-QXMG627U.js → runner-key-47XOJPYF.js} +5 -5
  39. package/dist/{setup-wiring-C7C2RHME.js → setup-wiring-GAOFBVEA.js} +7 -7
  40. package/dist/{status-AECB2USQ.js → status-GVCAMV7E.js} +5 -5
  41. package/dist/{update-steps-TLG25JY2.js → update-steps-7O5EHBP6.js} +6 -6
  42. package/dist/{work-claim-cmd-BXJ5RNWG.js → work-claim-cmd-DJXE5XDE.js} +1 -1
  43. package/dist/{work-proofs-cmd-VZM2CUGY.js → work-proofs-cmd-SPO6NUGT.js} +1 -1
  44. package/dist/{work-proofs-record-LN42LPZM.js → work-proofs-record-VLDSZSAT.js} +1 -1
  45. package/package.json +1 -1
  46. package/skill-pack/shipped.json +4 -1
  47. package/skill-pack/template/writing-specs/SKILL.md +95 -71
  48. package/skill-pack/template/writing-tests/SKILL.md +10 -18
@@ -1,22 +1,22 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- export { LAPSED_REASON, RunnerStartError, applyComments, endWhenStartFails, fleetKeepalive, leaseTimeLeftFor, listJobFiles, logUnusableHelper, prepareSession, probeBuild, probeCredentials, provisionsBesideOthers, requestStop, runnerProcessState, runtimeOf, sampleUsage, start, tick, watchTick } from './chunk-EEPR5MSY.js';
3
+ export { LAPSED_REASON, RunnerStartError, applyComments, endWhenStartFails, fleetKeepalive, leaseTimeLeftFor, listJobFiles, logUnusableHelper, prepareSession, probeBuild, probeCredentials, provisionsBesideOthers, requestStop, runnerProcessState, runtimeOf, sampleUsage, start, tick, watchTick } from './chunk-QL5LCZBO.js';
4
4
  import './chunk-7VW73CPS.js';
5
5
  import './chunk-E7R2GIAW.js';
6
- import './chunk-YB7QOJJ6.js';
7
- import './chunk-KDLZOXBP.js';
6
+ import './chunk-S6EOMJPK.js';
7
+ import './chunk-2QG2WHQI.js';
8
8
  import './chunk-TXKHD4Q6.js';
9
9
  import './chunk-ALJMNIHW.js';
10
10
  import './chunk-XYJHIH4N.js';
11
- import './chunk-MTZ43GKQ.js';
11
+ import './chunk-Z5PJYTDX.js';
12
12
  import './chunk-F5DIRRMG.js';
13
- import './chunk-Y25XOGFX.js';
13
+ import './chunk-EZHWM7GN.js';
14
14
  import './chunk-PM3PXJGE.js';
15
15
  import './chunk-46D7LPS3.js';
16
16
  import './chunk-I3LTIAOR.js';
17
17
  import './chunk-2PGI6RDE.js';
18
- import './chunk-O7QTZ6FY.js';
19
- import './chunk-OFEHPNPJ.js';
18
+ import './chunk-5DVAYNM5.js';
19
+ import './chunk-GPROFAKS.js';
20
20
  import './chunk-UU3A53VB.js';
21
21
  import './chunk-FVTNWJPF.js';
22
22
  import './chunk-MDWAL6FD.js';
@@ -27,7 +27,7 @@ import './chunk-C2PZOLN7.js';
27
27
  import './chunk-B4XB5QFD.js';
28
28
  import './chunk-DIF5NMRF.js';
29
29
  import './chunk-TQMI335S.js';
30
- import './chunk-2VYD47YW.js';
30
+ import './chunk-P27TZI3C.js';
31
31
  import './chunk-NN33FYXG.js';
32
32
  import './chunk-BQUUKECC.js';
33
33
  import './chunk-5IDATPRL.js';
@@ -41,7 +41,7 @@ import './chunk-FJGYU2EK.js';
41
41
  import './chunk-2EDRIMMQ.js';
42
42
  import './chunk-A7M4QXVX.js';
43
43
  import './chunk-4OLHKE6K.js';
44
- import './chunk-3DKYI6V7.js';
44
+ import './chunk-SGVQ25MY.js';
45
45
  import './chunk-WTX57JCA.js';
46
46
  import './chunk-BKN5HQCX.js';
47
47
  import './chunk-47NQTKLX.js';
@@ -1,12 +1,12 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- export { describeMachineDocker, detectMachine, microVmArchSupported, microVmAssetsPinned, reachDockerStep, supportsContainerBuilds, supportsMicroVmBuilds } from './chunk-Y25XOGFX.js';
3
+ export { describeMachineDocker, detectMachine, microVmArchSupported, microVmAssetsPinned, reachDockerStep, supportsContainerBuilds, supportsMicroVmBuilds } from './chunk-EZHWM7GN.js';
4
4
  import './chunk-PM3PXJGE.js';
5
5
  import './chunk-46D7LPS3.js';
6
6
  import './chunk-I3LTIAOR.js';
7
7
  import './chunk-2PGI6RDE.js';
8
- import './chunk-O7QTZ6FY.js';
9
- import './chunk-OFEHPNPJ.js';
8
+ import './chunk-5DVAYNM5.js';
9
+ import './chunk-GPROFAKS.js';
10
10
  import './chunk-UU3A53VB.js';
11
11
  import './chunk-FVTNWJPF.js';
12
12
  import './chunk-MDWAL6FD.js';
@@ -17,7 +17,7 @@ import './chunk-C2PZOLN7.js';
17
17
  import './chunk-B4XB5QFD.js';
18
18
  import './chunk-DIF5NMRF.js';
19
19
  import './chunk-TQMI335S.js';
20
- import './chunk-2VYD47YW.js';
20
+ import './chunk-P27TZI3C.js';
21
21
  import './chunk-NN33FYXG.js';
22
22
  import './chunk-BQUUKECC.js';
23
23
  import './chunk-5IDATPRL.js';
@@ -31,7 +31,7 @@ import './chunk-FJGYU2EK.js';
31
31
  import './chunk-2EDRIMMQ.js';
32
32
  import './chunk-A7M4QXVX.js';
33
33
  import './chunk-4OLHKE6K.js';
34
- import './chunk-3DKYI6V7.js';
34
+ import './chunk-SGVQ25MY.js';
35
35
  import './chunk-WTX57JCA.js';
36
36
  import './chunk-BKN5HQCX.js';
37
37
  import './chunk-47NQTKLX.js';
@@ -1,8 +1,8 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- export { RunnerEnvError, credentialFromStdin, hasStoredCredential, isAgentName, restartForCredential, storeAgentCredential, storedCredentialVariables } from './chunk-O7QTZ6FY.js';
4
- import './chunk-OFEHPNPJ.js';
5
- import './chunk-3DKYI6V7.js';
3
+ export { RunnerEnvError, credentialFromStdin, hasStoredCredential, isAgentName, restartForCredential, storeAgentCredential, storedCredentialVariables } from './chunk-5DVAYNM5.js';
4
+ import './chunk-GPROFAKS.js';
5
+ import './chunk-SGVQ25MY.js';
6
6
  import './chunk-WTX57JCA.js';
7
7
  import './chunk-BKN5HQCX.js';
8
8
  import './chunk-47NQTKLX.js';
@@ -1,12 +1,12 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- import { readConfigObject, RunnerInitError } from './chunk-Y25XOGFX.js';
3
+ import { readConfigObject, RunnerInitError } from './chunk-EZHWM7GN.js';
4
4
  import './chunk-PM3PXJGE.js';
5
5
  import './chunk-46D7LPS3.js';
6
6
  import './chunk-I3LTIAOR.js';
7
7
  import './chunk-2PGI6RDE.js';
8
- import './chunk-O7QTZ6FY.js';
9
- import './chunk-OFEHPNPJ.js';
8
+ import './chunk-5DVAYNM5.js';
9
+ import './chunk-GPROFAKS.js';
10
10
  import './chunk-UU3A53VB.js';
11
11
  import './chunk-FVTNWJPF.js';
12
12
  import './chunk-MDWAL6FD.js';
@@ -17,7 +17,7 @@ import './chunk-C2PZOLN7.js';
17
17
  import './chunk-B4XB5QFD.js';
18
18
  import './chunk-DIF5NMRF.js';
19
19
  import './chunk-TQMI335S.js';
20
- import './chunk-2VYD47YW.js';
20
+ import './chunk-P27TZI3C.js';
21
21
  import './chunk-NN33FYXG.js';
22
22
  import './chunk-BQUUKECC.js';
23
23
  import './chunk-5IDATPRL.js';
@@ -31,7 +31,7 @@ import './chunk-FJGYU2EK.js';
31
31
  import { getJson } from './chunk-2EDRIMMQ.js';
32
32
  import './chunk-A7M4QXVX.js';
33
33
  import './chunk-4OLHKE6K.js';
34
- import { runnerCredentialProblem } from './chunk-3DKYI6V7.js';
34
+ import { runnerCredentialProblem } from './chunk-SGVQ25MY.js';
35
35
  import './chunk-WTX57JCA.js';
36
36
  import './chunk-BKN5HQCX.js';
37
37
  import './chunk-47NQTKLX.js';
@@ -1,16 +1,16 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- import { runInitCommand } from './chunk-CYUAZGM5.js';
4
- import './chunk-JKOSEEDV.js';
3
+ import { runInitCommand } from './chunk-SQTRQ7FW.js';
4
+ import './chunk-7CBNPW6A.js';
5
5
  import './chunk-4KCWAP5L.js';
6
6
  import { currentBranch, openSetupPullRequest, setupPullRequestUrl, setupBranchPushed, setupMerged, setupBaseBranch, markSetupInstalled, setupInstalled } from './chunk-T26E7YR6.js';
7
- import { detectMachine, supportsMicroVmBuilds, supportsContainerBuilds, reachDockerStep, describeMachineDocker } from './chunk-Y25XOGFX.js';
7
+ import { detectMachine, supportsMicroVmBuilds, supportsContainerBuilds, reachDockerStep, describeMachineDocker } from './chunk-EZHWM7GN.js';
8
8
  import './chunk-PM3PXJGE.js';
9
9
  import './chunk-46D7LPS3.js';
10
10
  import './chunk-I3LTIAOR.js';
11
11
  import './chunk-2PGI6RDE.js';
12
- import './chunk-O7QTZ6FY.js';
13
- import './chunk-OFEHPNPJ.js';
12
+ import './chunk-5DVAYNM5.js';
13
+ import './chunk-GPROFAKS.js';
14
14
  import './chunk-UU3A53VB.js';
15
15
  import './chunk-FVTNWJPF.js';
16
16
  import './chunk-MDWAL6FD.js';
@@ -21,7 +21,7 @@ import './chunk-C2PZOLN7.js';
21
21
  import './chunk-B4XB5QFD.js';
22
22
  import './chunk-DIF5NMRF.js';
23
23
  import './chunk-TQMI335S.js';
24
- import './chunk-2VYD47YW.js';
24
+ import './chunk-P27TZI3C.js';
25
25
  import './chunk-NN33FYXG.js';
26
26
  import './chunk-BQUUKECC.js';
27
27
  import './chunk-5IDATPRL.js';
@@ -36,7 +36,7 @@ import './chunk-2EDRIMMQ.js';
36
36
  import './chunk-A7M4QXVX.js';
37
37
  import './chunk-4OLHKE6K.js';
38
38
  import './chunk-BXDQFZAO.js';
39
- import { defaultRunnerConfigPath } from './chunk-3DKYI6V7.js';
39
+ import { defaultRunnerConfigPath } from './chunk-SGVQ25MY.js';
40
40
  import './chunk-WTX57JCA.js';
41
41
  import './chunk-BKN5HQCX.js';
42
42
  import './chunk-47NQTKLX.js';
@@ -1,12 +1,12 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- import { isReadable, LEASE_SECONDS, ALREADY_RELEASED, RENEW_INTERVAL_SECONDS } from './chunk-Y25XOGFX.js';
3
+ import { isReadable, LEASE_SECONDS, ALREADY_RELEASED, RENEW_INTERVAL_SECONDS } from './chunk-EZHWM7GN.js';
4
4
  import './chunk-PM3PXJGE.js';
5
5
  import './chunk-46D7LPS3.js';
6
6
  import './chunk-I3LTIAOR.js';
7
7
  import './chunk-2PGI6RDE.js';
8
- import './chunk-O7QTZ6FY.js';
9
- import './chunk-OFEHPNPJ.js';
8
+ import './chunk-5DVAYNM5.js';
9
+ import './chunk-GPROFAKS.js';
10
10
  import './chunk-UU3A53VB.js';
11
11
  import './chunk-FVTNWJPF.js';
12
12
  import './chunk-MDWAL6FD.js';
@@ -17,7 +17,7 @@ import './chunk-C2PZOLN7.js';
17
17
  import { jobStateFormatOf } from './chunk-B4XB5QFD.js';
18
18
  import { pullInstruction } from './chunk-DIF5NMRF.js';
19
19
  import './chunk-TQMI335S.js';
20
- import './chunk-2VYD47YW.js';
20
+ import './chunk-P27TZI3C.js';
21
21
  import './chunk-NN33FYXG.js';
22
22
  import './chunk-BQUUKECC.js';
23
23
  import './chunk-5IDATPRL.js';
@@ -31,7 +31,7 @@ import './chunk-FJGYU2EK.js';
31
31
  import './chunk-2EDRIMMQ.js';
32
32
  import './chunk-A7M4QXVX.js';
33
33
  import './chunk-4OLHKE6K.js';
34
- import './chunk-3DKYI6V7.js';
34
+ import './chunk-SGVQ25MY.js';
35
35
  import { formatBytes } from './chunk-WTX57JCA.js';
36
36
  import './chunk-BKN5HQCX.js';
37
37
  import './chunk-47NQTKLX.js';
@@ -1,13 +1,13 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- export { readOwnContainer, renderUpdateSteps, runUpdateSteps } from './chunk-KDLZOXBP.js';
4
- import './chunk-Y25XOGFX.js';
3
+ export { readOwnContainer, renderUpdateSteps, runUpdateSteps } from './chunk-2QG2WHQI.js';
4
+ import './chunk-EZHWM7GN.js';
5
5
  import './chunk-PM3PXJGE.js';
6
6
  import './chunk-46D7LPS3.js';
7
7
  import './chunk-I3LTIAOR.js';
8
8
  import './chunk-2PGI6RDE.js';
9
- import './chunk-O7QTZ6FY.js';
10
- import './chunk-OFEHPNPJ.js';
9
+ import './chunk-5DVAYNM5.js';
10
+ import './chunk-GPROFAKS.js';
11
11
  import './chunk-UU3A53VB.js';
12
12
  import './chunk-FVTNWJPF.js';
13
13
  import './chunk-MDWAL6FD.js';
@@ -18,7 +18,7 @@ import './chunk-C2PZOLN7.js';
18
18
  import './chunk-B4XB5QFD.js';
19
19
  import './chunk-DIF5NMRF.js';
20
20
  import './chunk-TQMI335S.js';
21
- import './chunk-2VYD47YW.js';
21
+ import './chunk-P27TZI3C.js';
22
22
  import './chunk-NN33FYXG.js';
23
23
  import './chunk-BQUUKECC.js';
24
24
  import './chunk-5IDATPRL.js';
@@ -32,7 +32,7 @@ import './chunk-FJGYU2EK.js';
32
32
  import './chunk-2EDRIMMQ.js';
33
33
  import './chunk-A7M4QXVX.js';
34
34
  import './chunk-4OLHKE6K.js';
35
- import './chunk-3DKYI6V7.js';
35
+ import './chunk-SGVQ25MY.js';
36
36
  import './chunk-WTX57JCA.js';
37
37
  import './chunk-BKN5HQCX.js';
38
38
  import './chunk-47NQTKLX.js';
@@ -5,7 +5,7 @@ import { resolveCredentials, WorkCommandError, parsePositiveInt, postJson, envir
5
5
  export { WorkCommandError } from './chunk-2EDRIMMQ.js';
6
6
  import './chunk-A7M4QXVX.js';
7
7
  import './chunk-4OLHKE6K.js';
8
- import { defaultRunnerConfigPath } from './chunk-3DKYI6V7.js';
8
+ import { defaultRunnerConfigPath } from './chunk-SGVQ25MY.js';
9
9
  import './chunk-WTX57JCA.js';
10
10
  import './chunk-BKN5HQCX.js';
11
11
  import './chunk-47NQTKLX.js';
@@ -1,6 +1,6 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- export { classifyProofs, classifyProofsAt, otherPullRequestHeads, renderProofRow, resolveProofsItem, runWorkProofs, runWorkProofsCommand } from './chunk-5EHW7SBY.js';
3
+ export { classifyProofs, classifyProofsAt, otherPullRequestHeads, renderProofRow, resolveProofsItem, runWorkProofs, runWorkProofsCommand } from './chunk-Y3RV5MQ5.js';
4
4
  import './chunk-46D7LPS3.js';
5
5
  import './chunk-2EDRIMMQ.js';
6
6
  import './chunk-A7M4QXVX.js';
@@ -1,6 +1,6 @@
1
1
  #!/usr/bin/env node
2
2
  import { createRequire } from 'node:module';
3
- import { resolveProofsItem, ownPullRequest, otherPullRequestHeads, testProofMode, classifyProofsAt, runWorkProofs, proofsCommentId, testFilesOf, freshXmlFiles, joinResults, testSelectors, kindProblem, renderProofRow, proofsCommentBody } from './chunk-5EHW7SBY.js';
3
+ import { resolveProofsItem, ownPullRequest, otherPullRequestHeads, testProofMode, classifyProofsAt, runWorkProofs, proofsCommentId, testFilesOf, freshXmlFiles, joinResults, testSelectors, kindProblem, renderProofRow, proofsCommentBody } from './chunk-Y3RV5MQ5.js';
4
4
  import { runWorkComment } from './chunk-MEB2YICZ.js';
5
5
  import { runEmitDemo, planScreenshots, chapterPassed, readStill } from './chunk-NFFFLKX4.js';
6
6
  import { readNewestDemo } from './chunk-ER6KQCVJ.js';
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@outerlayer/cli",
3
- "version": "0.40.0-next.20261116200629",
3
+ "version": "0.40.0-next.20261116212619",
4
4
  "description": "OuterLayer CLI — commands: setup, init, claude, opencode, codex, connect, doctor, login, logout, sync, daemon (alias: watch), emit, demo, findings, work, run, spec, runner, hooks, mcp, context. Capture and sync coding-agent sessions, and record proof of factory work.",
5
5
  "license": "Apache-2.0",
6
6
  "author": "Magu Studios, Inc.",
@@ -97,17 +97,20 @@
97
97
  ],
98
98
  ".outerlayer/skills/writing-specs/SKILL.md": [
99
99
  "78ffced3b8f3e34306968c69c467292adbc2d609fac20a6778f8bd4a62fbe117",
100
+ "a5577a927fe1864047ec15de8cf5b13084442312b10c9d0db93c13accdd6bdbf",
100
101
  "a956aac4249118a058c4327c5751472883588720950d4a96f80c7e91f454bef9",
101
102
  "b528f1aefb2aebe98c5130f71030e90b27118c4bb008af5965b877f330dd4507",
102
103
  "d9423f48add241b2cf23bf49b467858355882727a08e068937a07571399555d8",
103
104
  "dbadb39cba5dae936e7c4b97cb852c59072e4a60e44caec01b128a045c1be090",
104
105
  "e50baa6d7c5145b9b0bddd9827de0659af54b81ee1238fb2dd1b74f2c58cf41c",
105
- "eb8aa95f5e76a46ae9bf340989fb40e470fd750ded791ba80b5f8c5c325513e5"
106
+ "eb8aa95f5e76a46ae9bf340989fb40e470fd750ded791ba80b5f8c5c325513e5",
107
+ "f4a43642ee302633c3c7a37c837961a2dd11ab6f14af0bb531c782fe0bd1faad"
106
108
  ],
107
109
  ".outerlayer/skills/writing-specs/references/agents-snippet.md": [
108
110
  "fc47325f27cfce406a14ad71009d3687d3720deb572d40936e29fd091ca6c71d"
109
111
  ],
110
112
  ".outerlayer/skills/writing-tests/SKILL.md": [
113
+ "0f9e4d0d90d100ab6f0227ae9f282f953ca50ab7f92083c545463a0c2cb41e23",
111
114
  "2f9f1680428c088765a1c6541ae021e98d50852a5414e0a2c9b3735f8ccb3942",
112
115
  "b00f5970b568159ca0bfbc75c3834938749ad5e2e73a80769d88bbe3c8c26737"
113
116
  ],
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: writing-specs
3
- description: Describes how to write a feature spec before implementation begins - problem framing, goals and non-goals, assumptions, acceptance criteria in Given/When/Then, and the docs verdict. Use when asked to "write a spec", "spec this out", "write a PRD", "draft acceptance criteria", or when shaping the issue for a new feature.
3
+ description: Describes how to write a feature spec before implementation begins - the problem, the goals and what is out of scope, assumptions, acceptance criteria in Given/When/Then, and the docs verdict. Use when asked to "write a spec", "spec this out", "write a PRD", "draft acceptance criteria", or when shaping the issue for a new feature.
4
4
  ---
5
5
 
6
6
  # Writing Specs
@@ -14,75 +14,101 @@ once and keep to it. The body also records the docs verdict
14
14
  with a one-line reason. Planning scratch is local and disposable. Nothing
15
15
  durable belongs there.
16
16
 
17
- ## Lead with a summary block
17
+ ## The shape of a spec
18
18
 
19
- A spec is triaged before it is read. Someone lands on it and needs, within
20
- thirty seconds: what this is, what blocks it, roughly how big, and what is
21
- deliberately not in it. Prose cannot answer that, however good it is. So every
22
- issue-body spec opens with a block that does, before the problem statement:
19
+ A spec has two parts. The first part is for any reader: a teammate, a manager
20
+ or a customer. Write it in product words. Put no file path, function name or
21
+ other code name in it. The second part, "Notes for the builder", is for
22
+ whoever builds the change. It holds the paths and the design.
23
23
 
24
- - **In one line**: what changes, in a sentence.
25
- - **Blocked by / blocks**: issue references, and any step that is a person
26
- doing a thing rather than a merge, such as a provider setting, an approval or
27
- a credential. Those silently become the critical path.
28
- - **Size**: small, medium or big. Not an estimate and not a commitment.
29
- - **Not in scope**: the neighbouring work this will be confused with, and where
30
- it lives instead.
31
- - **Criteria count**, so a reader knows the shape before scrolling.
32
- - **The invariants to defend in review**: the handful of things a well-meaning
33
- reviewer will try to negotiate away.
24
+ Use these headings, with these words, in this order. Leave out a heading that
25
+ has nothing real under it. Never rename one. A reader who has seen one spec
26
+ then finds the same thing in the same place in the next.
34
27
 
35
- Then give the reason for the single decision most likely to be reopened. If it
36
- took research to settle, the summary is where the finding goes. A reader who
37
- has to reconstruct it will re-litigate it.
28
+ For any reader:
38
29
 
39
- Regenerate the block whenever the body is amended. A spec edited in place under
40
- a summary that no longer matches it is worse than one with no summary.
30
+ 1. `## Summary`
31
+ 2. `## Problem`
32
+ 3. `## What done looks like`
33
+ 4. `## Out of scope`
34
+ 5. `## Constraints`
35
+ 6. `## Acceptance criteria`
41
36
 
42
- ## Problem before solution
37
+ For the builder, under `## Notes for the builder`:
38
+
39
+ 7. `### Why this approach`
40
+ 8. `### Design`
41
+ 9. `### Assumptions`
42
+ 10. `### Earlier solutions`
43
+ 11. `### Hidden work`
44
+
45
+ ## Summary
46
+
47
+ A person sorts a spec before reading it. The summary tells them in thirty
48
+ seconds what this is, how big it is and what it waits on. It is a list with
49
+ these labels:
50
+
51
+ - **What changes**: one or two sentences.
52
+ - **Size**: small, medium or big, then the number of criteria. Not an
53
+ estimate and not a commitment.
54
+ - **Waits on**: issue references, and any step that is a person doing a thing
55
+ rather than a merge, such as a provider setting, an approval or a
56
+ credential. Everything else waits on those steps, and nobody sees them.
57
+ - **Docs**: the docs verdict with its reason.
58
+
59
+ Write the summary again whenever the body is amended. A summary that no
60
+ longer matches its spec is worse than none.
61
+
62
+ ## Problem
43
63
 
44
64
  Open with the pain: who hits it, when, and what it costs them. A concrete
45
65
  scenario beats an abstract claim, and data beats both. "The app can't do X" is
46
66
  a solution in disguise. If the problem statement already names the feature, the
47
- problem has not been framed. Everything after this paragraph is judged by
48
- whether it relieves the stated pain.
67
+ problem is not stated yet.
68
+
69
+ ## What done looks like
70
+
71
+ State the outcomes: results that can fail, not hopes.
72
+
73
+ ## Out of scope
74
+
75
+ Name the neighbouring work that a reader will expect here, and where it lives
76
+ instead. State it once, in this section only. An exclusion left unstated
77
+ returns as extra work in review, or as a guess by whoever implements. Say
78
+ whether each one is deferred or dropped.
79
+
80
+ ## Constraints
49
81
 
50
- ## Goals and non-goals
82
+ List the few rules of this change that a reviewer may ask to relax, and must
83
+ not. Write each in product words: "a hidden tab sends no request", not the
84
+ name of the function that makes it so.
51
85
 
52
- State what done looks like: outcomes that can fail, not aspirations. Spend
53
- equal care on non-goals. An exclusion left unstated does not stay excluded. It
54
- returns as scope creep in review, or as a guess by whoever implements. "Deferred,
55
- not dropped" is a valid non-goal. Say which one it is, so the reader knows
56
- whether to expect it later.
86
+ ## Notes for the builder
57
87
 
58
- ## Alternatives and assumptions
88
+ Add a heading here only when there is something real to put under it.
59
89
 
60
- Name the alternatives considered and why each lost. Without the rejection
61
- reasons, a later reader can only blindly accept the design or blindly reopen it.
62
- Label assumptions as assumptions, each with its blast radius: "we assume X; if
63
- wrong, Y changes." An assumption stated as fact is the spec's most durable lie.
90
+ **Why this approach.** Give the reason for the decision most likely to be
91
+ reopened. Name the alternatives considered and why each lost. Without those
92
+ reasons, a later reader can only accept the design blindly or reopen it.
64
93
 
65
- ## Prior art and rabbit holes
94
+ **Design.** The paths, functions and data the change touches.
66
95
 
67
- Two sections that earn their place only when there is something real to put in
68
- them, and are lost forever when there is and they are missing.
96
+ **Assumptions.** Label each as an assumption, with what changes if it is
97
+ wrong: "we assume X; if wrong, Y changes." An assumption stated as fact
98
+ misleads every later reader.
69
99
 
70
- **Prior art.** How others solved this, and what they settled on. Where it came
71
- from research, name the source. A team that cannot see the prior art re-derives
72
- a solved problem later, or reopens a decision already made against evidence.
100
+ **Earlier solutions.** How others solved this, and what they settled on. Name
101
+ the source. A team that cannot see them solves the same problem again later.
73
102
 
74
- **Rabbit holes.** The specific places this eats a week if nobody is warned. It
75
- differs from its neighbours. Non-goals say what we will not build. Assumptions
76
- say what might be wrong. A rabbit hole says this part looks small and is not.
77
- Name it, and say what the cheap escape is.
103
+ **Hidden work.** The specific places where this takes a week if nobody is
104
+ warned: a part that looks small and is not. Name it, and say what the cheap
105
+ way out is.
78
106
 
79
- ## Weight matches ambiguity
107
+ ## Match the length to the uncertainty
80
108
 
81
- Scale the document to the uncertainty, not to a template. A bounded change earns
82
- a paragraph and a handful of criteria. A full spec is for genuine ambiguity in
83
- the problem or the solution. Never fill a section for completeness. An empty
84
- section costs the reader more than its absence, and padding dilutes the intent
85
- it surrounds.
109
+ A small, clear change needs a summary, a problem and a few criteria. A full
110
+ spec is for real uncertainty about the problem or the solution. Padding hides
111
+ the intent it surrounds.
86
112
 
87
113
  ## Writing criteria
88
114
 
@@ -94,9 +120,9 @@ implementing. Never write them by reading the finished implementation back.
94
120
  - **An observable, pass/fail Then.** If no test could fail it, it promises
95
121
  nothing. Ban vague adjectives such as "fast", "gracefully" and "user-friendly".
96
122
  State the number or the behavior instead.
97
- - **Declarative wording.** Litmus: would this sentence change if the
123
+ - **Say what happens, not how.** Check: would this sentence change if the
98
124
  implementation did? "When Bob logs in", not "when Bob clicks Submit on
99
- /login". Declarative criteria survive refactors and read as product truth.
125
+ /login". A criterion written this way stays true when the code changes.
100
126
  - **Every promised error path gets its own criterion.** An unstated edge case
101
127
  is not left open. It is guessed at during implementation.
102
128
  - **`(proof: ...)` between the id and Given** on every criterion whose outcome
@@ -107,9 +133,9 @@ implementing. Never write them by reading the finished implementation back.
107
133
 
108
134
  ## The docs verdict
109
135
 
110
- Every feature spec declares a docs verdict with a one-line reason. It is
111
- decided when the spec is written, and decided again from the finished change
112
- before the pull request opens.
136
+ Every feature spec declares a docs verdict with a one-line reason, on the
137
+ **Docs** line of its summary. It is decided when the spec is written, and
138
+ decided again from the finished change before the pull request opens.
113
139
 
114
140
  The verdict is `docs-required` when the change alters what a user sees or does.
115
141
  Judge it against the repository's own docs: a `README.md`, a `docs/`
@@ -125,34 +151,32 @@ A verdict reversed when the change is finished is not a fault. The gap
125
151
  between the two calls is the useful signal, so state it rather than quietly
126
152
  adopting the later one.
127
153
 
128
- ## Honest limits
154
+ ## Known limits
129
155
 
130
- A criterion may carry prose admitting what it does not cover. Useful idioms:
131
- **Knowingly accepted gap:** with the reason and the path to closing it, and
132
- **TODO:** for deferred-not-dropped scope. When part of a promise is a
133
- performance target or a judgment call no test can assert, say what the bound
134
- tests prove and what they do not. A spec claiming more than its tests prove is
135
- the more dangerous artifact. Write the limit down instead.
156
+ A criterion may carry prose that says what it does not cover. Useful labels:
157
+ **Known gap:** with the reason and how it will be closed, and **TODO:** for
158
+ work that is deferred, not dropped. When part of a promise is a performance
159
+ target or a judgment call no test can assert, say what the tests prove and
160
+ what they do not. A spec that claims more than its tests prove is worse than
161
+ one that states its limit. Write the limit down.
136
162
 
137
163
  ## Amendments
138
164
 
139
165
  When implementation shows the spec was wrong, amend the issue in place and note
140
- the owner's ruling in the body. Retire a criterion by deleting the line and its
141
- test citation together. Never renumber ids.
166
+ the owner's ruling in the body. Retire a criterion by deleting its line. Never
167
+ renumber ids.
142
168
 
143
169
  ## The reader test
144
170
 
145
171
  Before calling a spec done, hand it to a fresh agent with no conversation
146
172
  context and ask: what would you build, what is ambiguous, what would you have to
147
- guess? Whatever the cold reader gets wrong is a bug in the spec, not in the
173
+ guess? Whatever that reader gets wrong is a bug in the spec, not in the
148
174
  reader. Fix the wording, then get the owner's sign-off before any
149
175
  implementation.
150
176
 
151
- This is the only rule here that catches what the author cannot see, so it is
152
- the one most often skipped. Re-reading your own spec does not satisfy it. Run it
153
- against the issue body as published, not the draft in the working tree. A spec
154
- whose design lives in links the reader cannot follow fails this test, and that
155
- failure is invisible to whoever wrote it.
177
+ Re-reading your own spec does not satisfy this. Run it against the issue body
178
+ as published, not the draft in the working tree. A spec whose design lives in
179
+ links the reader cannot follow fails this test.
156
180
 
157
181
  ## Writing rules for the instructions file
158
182
 
@@ -1,6 +1,6 @@
1
1
  ---
2
2
  name: writing-tests
3
- description: Writes and reviews tests that catch a specific bug - assertion strength, the seam each test binds at, writing a test from an acceptance criterion, and checking by mutation that a test would notice a break. Use when writing or changing any test, when writing the test for a criterion, when reviewing whether a test proves anything, or when a mutation tool reports survivors.
3
+ description: Writes and reviews tests that catch a specific bug - assertion strength, the seam each test binds at, writing a test from an acceptance criterion, and checking that a test would notice a break. Use when writing or changing any test, when writing the test for a criterion, or when reviewing whether a test proves anything.
4
4
  ---
5
5
 
6
6
  # Writing tests
@@ -68,9 +68,8 @@ drop it.
68
68
  ## Write a test from its criterion
69
69
 
70
70
  When a spec has acceptance criteria, the criteria judge finds the test that
71
- proves each one by reading the tests and the code they run. A test needs no
72
- comment or title that names a criterion's id. Name the test for the behavior
73
- it checks, so someone reading a failure knows what broke:
71
+ proves each one by reading the tests and the code they run. Name the test
72
+ for the behavior it checks, so someone reading a failure knows what broke:
74
73
 
75
74
  ```ts
76
75
  it("refuses a password reset for an unknown address without saying so", () => {
@@ -85,24 +84,17 @@ behavior is absent, not because of a typo or a missing import.
85
84
  A criterion with a proof form such as `(proof: screenshot)` is proven by the
86
85
  evidence a reviewer sees, not by a test. It may still have one.
87
86
 
88
- ## Mutation: prove the test would notice
87
+ ## Check that the test would notice
89
88
 
90
89
  A green suite proves the tests run, not that they would catch a bug. Check
91
90
  the code the change adds or alters.
92
91
 
93
- **By hand.** For every condition, guard, limit and assignment the change
94
- adds, break it: invert it, widen it, drop half of an `and`, ignore the field.
95
- Run the one test file that should catch it. If nothing fails, write the
96
- assertion that would. Then take each criterion and break the production code
97
- it describes. Its test must fail. A test bound to a criterion that survives
98
- the break is not coverage.
99
-
100
- **With a tool.** Mutation testing is optional. Where the repository has a
101
- mutation tool, run it over the changed lines only. Each mutant that survives
102
- is a test still to write, not a score to accept. Two mutants are equivalent
103
- only when no observable output can differ; say why when you claim it. Hand
104
- breaks still matter for files the tool does not mutate, such as SQL, shell
105
- scripts, markup and configuration.
92
+ For every condition, guard, limit and assignment the change adds, break it:
93
+ invert it, widen it, drop half of an `and`, ignore the field. Run the one
94
+ test file that should catch it. If nothing fails, write the assertion that
95
+ would. Then take each criterion and break the production code it describes.
96
+ Its test must fail. A test bound to a criterion that survives the break is
97
+ not coverage.
106
98
 
107
99
  ## The repository's own rules
108
100