@brainervirus/workit-claude-code 2.6.0

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 (37) hide show
  1. package/.claude-plugin/plugin.json +19 -0
  2. package/README.md +46 -0
  3. package/agents/implementer.md +26 -0
  4. package/agents/reviewer.md +23 -0
  5. package/agents/verifier.md +26 -0
  6. package/assets/templates/execution-contract.md +40 -0
  7. package/assets/templates/headers.md +3 -0
  8. package/assets/templates/hygiene/.editorconfig +8 -0
  9. package/assets/templates/hygiene/.gitattributes +3 -0
  10. package/assets/templates/hygiene/CHANGELOG.md +14 -0
  11. package/assets/templates/hygiene/CONTRIBUTING.md +3 -0
  12. package/assets/templates/hygiene/LICENSE +21 -0
  13. package/assets/templates/hygiene/README.md +3 -0
  14. package/assets/templates/issue-update.md +5 -0
  15. package/assets/templates/plan-template.md +27 -0
  16. package/assets/templates/spec-template.md +63 -0
  17. package/assets/templates/workit-contract.md +12 -0
  18. package/bin/workit +24 -0
  19. package/bin/workit-hook.mjs +51 -0
  20. package/dist/workit-hook.js +165 -0
  21. package/dist/workit.js +78195 -0
  22. package/hooks/hooks.json +68 -0
  23. package/package.json +48 -0
  24. package/skills/babysit/SKILL.md +46 -0
  25. package/skills/behavioral-tdd/SKILL.md +57 -0
  26. package/skills/blast-radius/SKILL.md +35 -0
  27. package/skills/challenge/SKILL.md +56 -0
  28. package/skills/debug/SKILL.md +48 -0
  29. package/skills/deslop/SKILL.md +40 -0
  30. package/skills/diagram/SKILL.md +36 -0
  31. package/skills/green-run/SKILL.md +33 -0
  32. package/skills/handoff/SKILL.md +46 -0
  33. package/skills/implement/SKILL.md +57 -0
  34. package/skills/mockup/SKILL.md +32 -0
  35. package/skills/plan/SKILL.md +54 -0
  36. package/skills/review/SKILL.md +64 -0
  37. package/skills/steer/SKILL.md +48 -0
@@ -0,0 +1,64 @@
1
+ ---
2
+ name: review
3
+ description: Use when policy requires fresh-context review of a candidate or when an independent correctness and regression check is requested
4
+ ---
5
+
6
+ # Review a candidate
7
+
8
+ Review the real candidate in a stable context. A review is evidence about the
9
+ current candidate, not an author's success summary.
10
+
11
+
12
+ ## Method
13
+
14
+ 1. Pin or identify the candidate revision before reading conclusions. Inspect the
15
+ task objective, scope, constraints, accepted decisions, changed files, and
16
+ actual checks through shared `task`, `evidence`, and `policy` operations.
17
+ 2. Examine intent, correctness, regression risk, security or data consequences,
18
+ and project standards. Use the actual diff and check output; do not infer
19
+ evidence from a claim.
20
+ 3. Record each concern as a `finding` claim with its affected scope and candidate.
21
+ Investigate it: reproduce or trace the consequence, then fix in scope, dismiss
22
+ with evidence, defer with a reason, or ask the user about a real tradeoff.
23
+ 4. Reconcile conclusions when the candidate changes. Run one substantive review
24
+ and targeted rechecks; do not cycle reviewers indefinitely.
25
+
26
+ If the required independent context is unavailable, record the review method as
27
+ `unavailable` and preserve the gap. Same-session self-review is not independent
28
+ review and must not be relabeled as verified.
29
+
30
+ Use shared `evidence` and `finding` operations. Do not create a parallel review
31
+ lifecycle, universal review panel, or direct metadata files.
32
+
33
+ ## Two axes, pinned
34
+
35
+ Pin the fixed point first (`git diff <base>...HEAD` plus log); review that
36
+ candidate only. Judge on two axes, never merged or reranked:
37
+
38
+ - **Standards:** repo standards plus a smell baseline (mysterious name, long
39
+ method, duplicated logic, refused bequest, and kin); repo rules override
40
+ the baseline; judgement calls only, never tooling-enforced nits.
41
+ - **Spec:** does the diff implement the originating spec/requirement
42
+ faithfully — missing, creep, or wrong, quoting the spec line.
43
+
44
+ Every finding needs proof: the changed hunk, a failing/passing test ref, or
45
+ a before/after. Causal disposition decides the outcome: introduced or
46
+ worsened behavior gets fixed; pre-existing issues become follow-ups;
47
+ inconclusive claims escalate, never silently pass.
48
+
49
+ ## Common mistakes
50
+
51
+ | Mistake | Correction |
52
+ | --- | --- |
53
+ | Reviewing the summary instead of the candidate | Start from the stable candidate and real refs. |
54
+ | Treating every comment as a defect | Investigate the claim and consequence first. |
55
+ | Calling self-review independent | Preserve an unavailable capability gap. |
56
+
57
+
58
+ ## In Claude Code
59
+
60
+ Workit operations (`task`, `evidence`, `policy`, `decision`, …) run through
61
+ the `workit` CLI on the Bash tool: `workit <family> <action> --json`
62
+ (`workit --help` lists the verbs). The plugin's `verifier`, `reviewer`
63
+ and `implementer` agents take independent verification, fresh-context
64
+ review and isolated implementation.
@@ -0,0 +1,48 @@
1
+ ---
2
+ name: steer
3
+ description: Use when new instructions, interruptions, or forgotten items change substantial ongoing work
4
+ ---
5
+
6
+ # Steer without forced lifecycle
7
+
8
+ Classify new input as a quick question, a same-task adjustment, or a separate
9
+ request. Preserve continuity when it helps; do not manufacture task mutations.
10
+
11
+ ## Method
12
+
13
+ 1. Answer a quick question from current context. Do not pause, resume, create,
14
+ assess, or close a task just to answer it.
15
+ 2. For a same-task adjustment, update only affected constraints and next actions.
16
+ Keep an existing checkpoint when it helps; reassess policy only when evidence
17
+ or constraints changed enough to affect a rule.
18
+ 3. For a separate request, do not silently resume an old objective. Park a
19
+ concise checkpoint only when substantial work needs to continue later. Start
20
+ a distinct tracked record only if the new work benefits from continuity,
21
+ dependencies, coordination, or durable decisions. For work spanning repos,
22
+ checkpoint each unfinished item with its checkout, branch, requested
23
+ deliverables, and delivery endpoint. Keep explicitly held items parked with
24
+ their resume condition until the user resumes them. A conversational
25
+ checkpoint is sufficient when no task record is needed.
26
+ 4. Before resuming a named tracked task, reconcile its checkout, branch, dirty
27
+ state, current policy, stale evidence, uncertain effects, and ownership. Do
28
+ not change branches, stash, fetch large histories, or seize ownership just
29
+ to display a history choice.
30
+ 5. Continue to the user's authorized endpoint with applicable checks. Ask only
31
+ about consequential choices the code and available context cannot resolve.
32
+
33
+ ## Common mistakes
34
+
35
+ | Mistake | Correction |
36
+ | --- | --- |
37
+ | Treating a quick question as interruption | Answer without changing task state. |
38
+ | Auto-resuming an old objective | Wait for the user's direction to resume it. |
39
+ | Rebuilding continuity from a transcript | Keep a compact checkpoint with evidence and next action. |
40
+
41
+
42
+ ## In Claude Code
43
+
44
+ Workit operations (`task`, `evidence`, `policy`, `decision`, …) run through
45
+ the `workit` CLI on the Bash tool: `workit <family> <action> --json`
46
+ (`workit --help` lists the verbs). The plugin's `verifier`, `reviewer`
47
+ and `implementer` agents take independent verification, fresh-context
48
+ review and isolated implementation.