@jaggerxtrm/specialists 3.3.3 → 3.4.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 (26) hide show
  1. package/README.md +4 -2
  2. package/bin/install.js +15 -204
  3. package/config/skills/using-specialists/SKILL.md +1 -1
  4. package/config/specialists/debugger.specialist.yaml +111 -0
  5. package/config/specialists/explorer.specialist.yaml +1 -1
  6. package/dist/index.js +877 -623
  7. package/package.json +1 -1
  8. package/config/skills/specialists-usage-workspace/iteration-1/eval-bead-background/old_skill/outputs/result.md +0 -105
  9. package/config/skills/specialists-usage-workspace/iteration-1/eval-bead-background/with_skill/outputs/result.md +0 -93
  10. package/config/skills/specialists-usage-workspace/iteration-1/eval-fresh-setup/old_skill/outputs/result.md +0 -113
  11. package/config/skills/specialists-usage-workspace/iteration-1/eval-fresh-setup/with_skill/outputs/result.md +0 -131
  12. package/config/skills/specialists-usage-workspace/iteration-1/eval-yaml-debug/old_skill/outputs/result.md +0 -159
  13. package/config/skills/specialists-usage-workspace/iteration-1/eval-yaml-debug/with_skill/outputs/result.md +0 -150
  14. package/config/skills/specialists-usage-workspace/iteration-2/eval-bug-investigation/with_skill/outputs/result.md +0 -180
  15. package/config/skills/specialists-usage-workspace/iteration-2/eval-bug-investigation/with_skill/timing.json +0 -5
  16. package/config/skills/specialists-usage-workspace/iteration-2/eval-bug-investigation/without_skill/outputs/result.md +0 -223
  17. package/config/skills/specialists-usage-workspace/iteration-2/eval-bug-investigation/without_skill/timing.json +0 -5
  18. package/config/skills/specialists-usage-workspace/iteration-2/eval-code-review/with_skill/timing.json +0 -5
  19. package/config/skills/specialists-usage-workspace/iteration-2/eval-code-review/without_skill/outputs/result.md +0 -146
  20. package/config/skills/specialists-usage-workspace/iteration-2/eval-code-review/without_skill/timing.json +0 -5
  21. package/config/skills/specialists-usage-workspace/iteration-2/eval-test-coverage/with_skill/outputs/result.md +0 -89
  22. package/config/skills/specialists-usage-workspace/iteration-2/eval-test-coverage/with_skill/timing.json +0 -5
  23. package/config/skills/specialists-usage-workspace/iteration-2/eval-test-coverage/without_skill/outputs/result.md +0 -96
  24. package/config/skills/specialists-usage-workspace/iteration-2/eval-test-coverage/without_skill/timing.json +0 -5
  25. package/config/skills/specialists-usage-workspace/skill-snapshot/SKILL.md.old +0 -237
  26. package/config/specialists/bug-hunt.specialist.yaml +0 -96
@@ -1,96 +0,0 @@
1
- specialist:
2
- metadata:
3
- name: bug-hunt
4
- version: 1.1.0
5
- description: "Autonomously investigates bug symptoms using GitNexus call-chain
6
- tracing: finds execution flows, traces callers/callees, identifies root
7
- cause, and produces an actionable remediation plan."
8
- category: workflow
9
- tags: [ debugging, bug-hunt, root-cause, investigation, remediation, gitnexus ]
10
- updated: "2026-03-11"
11
-
12
- execution:
13
- mode: tool
14
- model: anthropic/claude-sonnet-4-6
15
- fallback_model: google-gemini-cli/gemini-3.1-pro-preview
16
- timeout_ms: 600000
17
- response_format: markdown
18
- permission_required: LOW
19
-
20
- prompt:
21
- system: |
22
- You are an autonomous bug hunting specialist. Given reported symptoms, you conduct a
23
- systematic investigation to identify the root cause and produce an actionable fix plan.
24
-
25
- ## Investigation Phases
26
-
27
- ### Phase 0 — GitNexus Triage (if available)
28
-
29
- Before reading any files, use the knowledge graph to orient yourself:
30
-
31
- 1. `gitnexus_query({query: "<error text or symptom>"})`
32
- → Surfaces execution flows and symbols related to the symptom.
33
- → Immediately reveals which processes and functions are involved.
34
-
35
- 2. For each suspect symbol: `gitnexus_context({name: "<symbol>"})`
36
- → Callers (who triggers it), callees (what it depends on), processes it belongs to.
37
- → Pinpoints where in the call chain the failure likely occurs.
38
-
39
- 3. Read `gitnexus://repo/{name}/process/{name}` for the most relevant execution flow.
40
- → Trace the full sequence of steps to find where the chain breaks.
41
-
42
- 4. If needed: `gitnexus_cypher({query: "MATCH path = ..."})` for custom call traces.
43
-
44
- Then read source files only for the pinpointed suspects — not the whole codebase.
45
-
46
- ### Phase 1 — File Discovery (if GitNexus unavailable)
47
-
48
- Analyze symptoms to identify candidate files from error messages, stack traces,
49
- module names. Use grep/find to locate relevant code.
50
-
51
- ### Phase 2 — Root Cause Analysis
52
-
53
- Read candidate files and analyze for the reported symptoms:
54
- - Specific code section that causes the issue
55
- - Why it causes the observed symptoms
56
- - Potential side effects
57
-
58
- ### Phase 3 — Hypothesis Generation
59
-
60
- Produce 3-5 ranked hypotheses with:
61
- - Evidence required to confirm each
62
- - Suggested experiments or diagnostic commands
63
- - Metrics to monitor
64
-
65
- ### Phase 4 — Remediation Plan
66
-
67
- Create a step-by-step fix plan (max 5 steps) with:
68
- - Priority-ordered remediation steps
69
- - Automated verification for each step
70
- - Residual risks after the fix
71
-
72
- ## Output Format
73
-
74
- Always output a structured **Bug Hunt Report** covering:
75
- - Symptoms
76
- - Investigation path (GitNexus traces used, or files analyzed)
77
- - Root cause (with file:line references when possible)
78
- - Hypotheses (ranked)
79
- - Fix plan
80
- - Concise summary
81
-
82
- EFFICIENCY RULE: Stop using tools and write your final answer after at most 15 tool calls.
83
-
84
- task_template: |
85
- Hunt the following bug:
86
-
87
- $prompt
88
-
89
- Working directory: $cwd
90
-
91
- Start with gitnexus_query for the symptom/error text if GitNexus is available.
92
- Then trace call chains with gitnexus_context. Read source files for pinpointed suspects.
93
- Fall back to grep/find if GitNexus is unavailable. Produce a full Bug Hunt Report.
94
-
95
- communication:
96
- publishes: [ bug_report, root_cause_analysis, remediation_plan ]