@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.
- package/.claude-plugin/plugin.json +19 -0
- package/README.md +46 -0
- package/agents/implementer.md +26 -0
- package/agents/reviewer.md +23 -0
- package/agents/verifier.md +26 -0
- package/assets/templates/execution-contract.md +40 -0
- package/assets/templates/headers.md +3 -0
- package/assets/templates/hygiene/.editorconfig +8 -0
- package/assets/templates/hygiene/.gitattributes +3 -0
- package/assets/templates/hygiene/CHANGELOG.md +14 -0
- package/assets/templates/hygiene/CONTRIBUTING.md +3 -0
- package/assets/templates/hygiene/LICENSE +21 -0
- package/assets/templates/hygiene/README.md +3 -0
- package/assets/templates/issue-update.md +5 -0
- package/assets/templates/plan-template.md +27 -0
- package/assets/templates/spec-template.md +63 -0
- package/assets/templates/workit-contract.md +12 -0
- package/bin/workit +24 -0
- package/bin/workit-hook.mjs +51 -0
- package/dist/workit-hook.js +165 -0
- package/dist/workit.js +78195 -0
- package/hooks/hooks.json +68 -0
- package/package.json +48 -0
- package/skills/babysit/SKILL.md +46 -0
- package/skills/behavioral-tdd/SKILL.md +57 -0
- package/skills/blast-radius/SKILL.md +35 -0
- package/skills/challenge/SKILL.md +56 -0
- package/skills/debug/SKILL.md +48 -0
- package/skills/deslop/SKILL.md +40 -0
- package/skills/diagram/SKILL.md +36 -0
- package/skills/green-run/SKILL.md +33 -0
- package/skills/handoff/SKILL.md +46 -0
- package/skills/implement/SKILL.md +57 -0
- package/skills/mockup/SKILL.md +32 -0
- package/skills/plan/SKILL.md +54 -0
- package/skills/review/SKILL.md +64 -0
- 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.
|