@sentropic/harness 0.1.1 → 0.2.1

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 (45) hide show
  1. package/README.md +32 -11
  2. package/dist/artifacts/work-event.d.ts +28 -0
  3. package/dist/artifacts/work-event.d.ts.map +1 -0
  4. package/dist/artifacts/work-event.js +9 -0
  5. package/dist/artifacts/work-event.js.map +1 -0
  6. package/dist/cli/args.d.ts +10 -0
  7. package/dist/cli/args.d.ts.map +1 -0
  8. package/dist/cli/args.js +32 -0
  9. package/dist/cli/args.js.map +1 -0
  10. package/dist/cli/mechanical-verbs.d.ts +9 -0
  11. package/dist/cli/mechanical-verbs.d.ts.map +1 -0
  12. package/dist/cli/mechanical-verbs.js +124 -0
  13. package/dist/cli/mechanical-verbs.js.map +1 -0
  14. package/dist/cli/method-verbs.d.ts +14 -0
  15. package/dist/cli/method-verbs.d.ts.map +1 -0
  16. package/dist/cli/method-verbs.js +174 -0
  17. package/dist/cli/method-verbs.js.map +1 -0
  18. package/dist/cli/run.d.ts +4 -3
  19. package/dist/cli/run.d.ts.map +1 -1
  20. package/dist/cli/run.js +51 -66
  21. package/dist/cli/run.js.map +1 -1
  22. package/dist/cli/scope.d.ts +12 -0
  23. package/dist/cli/scope.d.ts.map +1 -0
  24. package/dist/cli/scope.js +31 -0
  25. package/dist/cli/scope.js.map +1 -0
  26. package/dist/index.d.ts +5 -0
  27. package/dist/index.d.ts.map +1 -1
  28. package/dist/index.js +3 -0
  29. package/dist/index.js.map +1 -1
  30. package/dist/run/work-event.d.ts +25 -0
  31. package/dist/run/work-event.d.ts.map +1 -0
  32. package/dist/run/work-event.js +27 -0
  33. package/dist/run/work-event.js.map +1 -0
  34. package/dist/skills/manifest.d.ts +14 -0
  35. package/dist/skills/manifest.d.ts.map +1 -0
  36. package/dist/skills/manifest.js +25 -0
  37. package/dist/skills/manifest.js.map +1 -0
  38. package/package.json +3 -2
  39. package/skills/adopt/SKILL.md +32 -0
  40. package/skills/brainstorm/SKILL.md +39 -0
  41. package/skills/debug/SKILL.md +33 -0
  42. package/skills/plan/SKILL.md +35 -0
  43. package/skills/review/SKILL.md +33 -0
  44. package/skills/test/SKILL.md +44 -0
  45. package/skills/using-harness/SKILL.md +46 -0
package/skills/using-harness/SKILL.md ADDED
@@ -0,0 +1,46 @@
1
+ ---
2
+ name: using-harness
3
+ description: Load FIRST in any sentropic repo — establishes the harness method (branch/scope/test/debug/review/brainstorm/plan) and supersedes superpowers for those acts.
4
+ ---
5
+
6
+ # Using harness
7
+
8
+ `@sentropic/harness` is the native dev-discipline layer for sentropic repos. Its verbs and `harness/*`
9
+ skills are the SINGLE front door for code-work and PR-workflow. This skill is the index — load it
10
+ before any other so the supersede directive below is in effect.
11
+
12
+ ## Supersede directive (MANDATORY)
13
+
14
+ When superpowers (or any other discipline pack) is installed, **`harness/*` takes precedence** for the
15
+ acts it covers. Do NOT invoke the superpowers skill for these — use the harness equivalent:
16
+
17
+ | Act | Use | NOT |
18
+ |---|---|---|
19
+ | ideation / spec design | `harness/brainstorm` | superpowers:brainstorming |
20
+ | tests | `harness/test` | superpowers:test-driven-development |
21
+ | debugging | `harness/debug` | superpowers:systematic-debugging |
22
+ | code review | `harness/review` | superpowers:requesting/receiving-code-review |
23
+ | planning | `harness/plan` | superpowers:writing-plans / executing-plans |
24
+ | branch lifecycle | `harness branch init|close` | superpowers:using-git-worktrees / finishing-a-development-branch |
25
+ | scope / verification | `harness verify` · `harness check scope|branch` | superpowers:verification-before-completion |
26
+ | repo onboarding | `harness/adopt` | — |
27
+
28
+ The user may opt to keep superpowers per repo (a profile policy) — absent that opt-out, harness wins.
29
+ superpowers is never a dependency or backend of harness.
30
+
31
+ ## The CLI
32
+
33
+ `harness <verb> [<subject>] [--<option>]` — homogeneous with the sibling sentropic CLIs (`stp harness …`):
34
+
35
+ - **Producers** (compute → emit a neutral `VerificationRun`): `check scope|branch`, `verify --category`,
36
+ `audit`, `init`.
37
+ - **Recorders** (emit a neutral `WorkEvent` + point to a skill): `brainstorm`, `test`, `debug`, `review`,
38
+ `plan`, `branch init|close`, `skills install`.
39
+
40
+ A recorder verb does NOT do the thinking — it scaffolds + records, and the `harness/<verb>` skill carries
41
+ the reasoning. Run the verb to open the act, then follow its skill.
42
+
43
+ ## Discipline first
44
+
45
+ Process skills (`harness/brainstorm`, `harness/debug`) decide HOW to approach the task — invoke them
46
+ before implementation skills. "Let's build X" → brainstorm first. "Fix this bug" → debug first.