@intentsolutionsio/sugar 2.0.0 → 2.0.3
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/README.md +28 -16
- package/agents/quality-guardian.md +3 -6
- package/agents/sugar-orchestrator.md +4 -8
- package/agents/task-planner.md +4 -8
- package/commands/sugar-thinking.md +139 -0
- package/hooks/hooks.json +45 -2
- package/package.json +1 -1
- package/skills/managing-autonomous-development/SKILL.md +3 -3
- package/skills/managing-autonomous-development/assets/README.md +1 -0
- package/skills/managing-autonomous-development/references/README.md +1 -0
- package/skills/managing-autonomous-development/scripts/README.md +1 -0
package/README.md
CHANGED
|
@@ -1,16 +1,18 @@
|
|
|
1
|
-
# Sugar
|
|
1
|
+
# Sugar - Claude Code Plugin
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
Autonomous issue resolution for AI-assisted development.
|
|
4
|
+
|
|
5
|
+
Persistent memory, cross-session context, and autonomous task execution for any AI coding CLI.
|
|
4
6
|
|
|
5
7
|
## What is Sugar?
|
|
6
8
|
|
|
7
|
-
Sugar is a
|
|
9
|
+
Sugar is a Claude Code plugin that brings persistent memory and autonomous development to your projects. Sugar provides:
|
|
8
10
|
|
|
11
|
+
- **🧠 Persistent Memory** - Cross-session context that survives restarts - decisions, preferences, error patterns, and more
|
|
12
|
+
- **🌐 Global Knowledge** - Project-independent memory for guidelines and standards available across all your work
|
|
9
13
|
- **🤖 Autonomous Task Execution** - Let AI handle complex, multi-step development work
|
|
10
|
-
- **📋
|
|
11
|
-
- **🎯 Intelligent Agent Orchestration** - Specialized agents for different development aspects
|
|
14
|
+
- **📋 Task Management** - Persistent SQLite-backed task tracking with rich metadata
|
|
12
15
|
- **🔍 Automatic Work Discovery** - Finds work from error logs, GitHub issues, and code quality metrics
|
|
13
|
-
- **👥 Team Collaboration** - Shared task queues with multi-project support
|
|
14
16
|
|
|
15
17
|
## Quick Start
|
|
16
18
|
|
|
@@ -29,12 +31,21 @@ Sugar is a premier Claude Code plugin that brings true autonomous development to
|
|
|
29
31
|
|
|
30
32
|
### Installation
|
|
31
33
|
|
|
32
|
-
Install the Sugar plugin via Claude Code:
|
|
34
|
+
Install the Sugar plugin via Claude Code using one of these methods:
|
|
33
35
|
|
|
36
|
+
**Option 1: Direct Repository Installation (Recommended)**
|
|
37
|
+
```
|
|
38
|
+
/plugin install roboticforce/sugar
|
|
34
39
|
```
|
|
40
|
+
|
|
41
|
+
**Option 2: Register Sugar Marketplace First**
|
|
42
|
+
```
|
|
43
|
+
/plugin marketplace add roboticforce/sugar
|
|
35
44
|
/plugin install sugar
|
|
36
45
|
```
|
|
37
46
|
|
|
47
|
+
**Note**: The plugin is available from the `roboticforce/sugar` GitHub repository. If you get "Plugin not found in any marketplace", use the direct installation method above.
|
|
48
|
+
|
|
38
49
|
### Basic Usage
|
|
39
50
|
|
|
40
51
|
#### Create Tasks
|
|
@@ -62,6 +73,7 @@ Install the Sugar plugin via Claude Code:
|
|
|
62
73
|
- `/sugar-review` - Review and manage pending tasks
|
|
63
74
|
- `/sugar-run` - Start autonomous execution mode
|
|
64
75
|
- `/sugar-analyze` - Analyze codebase for potential work
|
|
76
|
+
- `/sugar-thinking` - View Claude's thinking logs for tasks *(New in v3.4)*
|
|
65
77
|
|
|
66
78
|
### Specialized Agents
|
|
67
79
|
|
|
@@ -144,23 +156,23 @@ sugar:
|
|
|
144
156
|
|
|
145
157
|
## Documentation
|
|
146
158
|
|
|
147
|
-
- [Complete Documentation](https://github.com/
|
|
148
|
-
- [Quick Start Guide](https://github.com/
|
|
149
|
-
- [CLI Reference](https://github.com/
|
|
150
|
-
- [GitHub Integration](https://github.com/
|
|
159
|
+
- [Complete Documentation](https://github.com/roboticforce/sugar/tree/main/docs)
|
|
160
|
+
- [Quick Start Guide](https://github.com/roboticforce/sugar/blob/main/docs/user/quick-start.md)
|
|
161
|
+
- [CLI Reference](https://github.com/roboticforce/sugar/blob/main/docs/user/cli-reference.md)
|
|
162
|
+
- [GitHub Integration](https://github.com/roboticforce/sugar/blob/main/docs/user/github-integration.md)
|
|
151
163
|
|
|
152
164
|
## Support
|
|
153
165
|
|
|
154
|
-
- **Issues**: [GitHub Issues](https://github.com/
|
|
155
|
-
- **Discussions**: [GitHub Discussions](https://github.com/
|
|
156
|
-
- **Documentation**: [
|
|
166
|
+
- **Issues**: [GitHub Issues](https://github.com/roboticforce/sugar/issues)
|
|
167
|
+
- **Discussions**: [GitHub Discussions](https://github.com/roboticforce/sugar/discussions)
|
|
168
|
+
- **Documentation**: [sugar.roboticforce.io](https://sugar.roboticforce.io/)
|
|
157
169
|
|
|
158
170
|
## License
|
|
159
171
|
|
|
160
|
-
MIT License - see [LICENSE](https://github.com/
|
|
172
|
+
MIT License - see [LICENSE](https://github.com/roboticforce/sugar/blob/main/LICENSE)
|
|
161
173
|
|
|
162
174
|
---
|
|
163
175
|
|
|
164
|
-
**Sugar
|
|
176
|
+
**Sugar** - Autonomous issue resolution for AI-assisted development.
|
|
165
177
|
|
|
166
178
|
⚠️ **Disclaimer**: Sugar is an independent third-party tool. "Claude," "Claude Code," and related marks are trademarks of Anthropic, Inc. Sugar is not affiliated with, endorsed by, or sponsored by Anthropic, Inc.
|
|
@@ -1,13 +1,10 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: quality-guardian
|
|
3
3
|
description: Code quality, testing, and validation enforcement specialist
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
- testing
|
|
7
|
-
- validation
|
|
8
|
-
- security-review
|
|
9
|
-
- best-practices
|
|
4
|
+
type: specialist
|
|
5
|
+
expertise: ["code-quality", "testing", "validation", "security-review", "best-practices"]
|
|
10
6
|
---
|
|
7
|
+
|
|
11
8
|
# Quality Guardian Agent
|
|
12
9
|
|
|
13
10
|
You are the Quality Guardian, the enforcer of code quality, testing standards, and validation practices in Sugar's autonomous development system. Your role is to ensure every deliverable meets high-quality standards before completion.
|
|
@@ -1,14 +1,10 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: sugar-orchestrator
|
|
3
|
-
description:
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
expertise:
|
|
7
|
-
- task-management
|
|
8
|
-
- workflow-orchestration
|
|
9
|
-
- agent-coordination
|
|
10
|
-
- autonomous-execution
|
|
3
|
+
description: Coordinates Sugar's autonomous development workflows with strategic oversight
|
|
4
|
+
type: coordinator
|
|
5
|
+
expertise: ["task-management", "workflow-orchestration", "agent-coordination", "autonomous-execution"]
|
|
11
6
|
---
|
|
7
|
+
|
|
12
8
|
# Sugar Orchestrator Agent
|
|
13
9
|
|
|
14
10
|
You are the Sugar Orchestrator, the primary coordination agent for Sugar's autonomous development system. Your role is to manage complex development workflows, coordinate specialized agents, and ensure high-quality autonomous execution.
|
package/agents/task-planner.md
CHANGED
|
@@ -1,14 +1,10 @@
|
|
|
1
1
|
---
|
|
2
2
|
name: task-planner
|
|
3
|
-
description:
|
|
4
|
-
|
|
5
|
-
|
|
6
|
-
expertise:
|
|
7
|
-
- strategic-planning
|
|
8
|
-
- task-decomposition
|
|
9
|
-
- requirements-analysis
|
|
10
|
-
- architecture-planning
|
|
3
|
+
description: Strategic task planning and breakdown specialist for complex development work
|
|
4
|
+
type: specialist
|
|
5
|
+
expertise: ["strategic-planning", "task-decomposition", "requirements-analysis", "architecture-planning"]
|
|
11
6
|
---
|
|
7
|
+
|
|
12
8
|
# Task Planner Agent
|
|
13
9
|
|
|
14
10
|
You are the Task Planner, a specialized agent focused on strategic planning and task breakdown for Sugar's autonomous development system. Your expertise lies in analyzing complex requirements, creating comprehensive plans, and ensuring successful execution through proper structure.
|
|
@@ -0,0 +1,139 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: sugar-thinking
|
|
3
|
+
description: View Claude's thinking logs for task execution
|
|
4
|
+
usage: /sugar-thinking [TASK_ID] [OPTIONS]
|
|
5
|
+
examples:
|
|
6
|
+
- /sugar-thinking task-abc123
|
|
7
|
+
- /sugar-thinking --list
|
|
8
|
+
- /sugar-thinking task-abc123 --stats
|
|
9
|
+
---
|
|
10
|
+
|
|
11
|
+
# Sugar Thinking Command
|
|
12
|
+
|
|
13
|
+
View Claude's thinking logs for task execution, providing visibility into Claude's reasoning process during autonomous task execution.
|
|
14
|
+
|
|
15
|
+
## Usage
|
|
16
|
+
|
|
17
|
+
```
|
|
18
|
+
/sugar-thinking [TASK_ID] [OPTIONS]
|
|
19
|
+
```
|
|
20
|
+
|
|
21
|
+
## Description
|
|
22
|
+
|
|
23
|
+
The `sugar-thinking` command allows you to view the captured thinking blocks from Claude's execution of tasks. This provides critical visibility into how Claude approaches problems and makes decisions during autonomous development.
|
|
24
|
+
|
|
25
|
+
## Arguments
|
|
26
|
+
|
|
27
|
+
- `TASK_ID` - Task ID to view thinking for (required unless using `--list`)
|
|
28
|
+
|
|
29
|
+
## Options
|
|
30
|
+
|
|
31
|
+
- `--list, -l` - List all available thinking logs
|
|
32
|
+
- `--stats, -s` - Show thinking statistics only (blocks count, characters, tools considered)
|
|
33
|
+
|
|
34
|
+
## Examples
|
|
35
|
+
|
|
36
|
+
### View Full Thinking Log
|
|
37
|
+
|
|
38
|
+
```
|
|
39
|
+
/sugar-thinking task-abc123
|
|
40
|
+
```
|
|
41
|
+
|
|
42
|
+
Shows the complete thinking log with timestamped thinking blocks.
|
|
43
|
+
|
|
44
|
+
### View Statistics Only
|
|
45
|
+
|
|
46
|
+
```
|
|
47
|
+
/sugar-thinking task-abc123 --stats
|
|
48
|
+
```
|
|
49
|
+
|
|
50
|
+
Shows summary statistics including:
|
|
51
|
+
- Total thinking blocks captured
|
|
52
|
+
- Total characters
|
|
53
|
+
- Average thinking block length
|
|
54
|
+
- Tools considered during thinking
|
|
55
|
+
- Timing information
|
|
56
|
+
|
|
57
|
+
### List All Thinking Logs
|
|
58
|
+
|
|
59
|
+
```
|
|
60
|
+
/sugar-thinking --list
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
Lists all available thinking logs sorted by modification time (newest first).
|
|
64
|
+
|
|
65
|
+
## Output Format
|
|
66
|
+
|
|
67
|
+
### Full Log
|
|
68
|
+
|
|
69
|
+
```markdown
|
|
70
|
+
# Thinking Log: Implement user authentication
|
|
71
|
+
|
|
72
|
+
**Task ID:** abc123
|
|
73
|
+
**Started:** 2026-01-07T10:30:00
|
|
74
|
+
|
|
75
|
+
---
|
|
76
|
+
|
|
77
|
+
## 10:30:05
|
|
78
|
+
|
|
79
|
+
First, I need to understand the current authentication system...
|
|
80
|
+
|
|
81
|
+
---
|
|
82
|
+
|
|
83
|
+
## 10:30:12
|
|
84
|
+
|
|
85
|
+
*Considering tool: `Read`*
|
|
86
|
+
|
|
87
|
+
I should read the existing auth module to see what's already implemented...
|
|
88
|
+
|
|
89
|
+
---
|
|
90
|
+
|
|
91
|
+
## Summary
|
|
92
|
+
|
|
93
|
+
- **Total thinking blocks:** 15
|
|
94
|
+
- **Total characters:** 3,247
|
|
95
|
+
- **Average length:** 216 chars
|
|
96
|
+
- **Tools considered:** Read, Write, Bash
|
|
97
|
+
|
|
98
|
+
**Completed:** 2026-01-07T10:35:42
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
### Statistics
|
|
102
|
+
|
|
103
|
+
```
|
|
104
|
+
📊 Thinking Statistics for: Implement user authentication
|
|
105
|
+
Task ID: abc123
|
|
106
|
+
============================================================
|
|
107
|
+
|
|
108
|
+
Thinking Blocks: 15
|
|
109
|
+
Total Characters: 3,247
|
|
110
|
+
Average Length: 216 chars
|
|
111
|
+
Tools Considered: Read, Write, Bash
|
|
112
|
+
First Thinking: 2026-01-07T10:30:05
|
|
113
|
+
Last Thinking: 2026-01-07T10:35:40
|
|
114
|
+
|
|
115
|
+
Full log: .sugar/thinking/abc123.md
|
|
116
|
+
```
|
|
117
|
+
|
|
118
|
+
## Use Cases
|
|
119
|
+
|
|
120
|
+
1. **Debugging Failed Tasks**: Understand why a task succeeded or failed by reviewing Claude's reasoning
|
|
121
|
+
2. **Learning from Claude**: Study how Claude approaches different types of problems
|
|
122
|
+
3. **Verification**: Confirm Claude is following expected strategies and approaches
|
|
123
|
+
4. **Pattern Analysis**: Track thinking patterns across tasks to improve prompts
|
|
124
|
+
|
|
125
|
+
## Configuration
|
|
126
|
+
|
|
127
|
+
Thinking capture is enabled by default. To disable, add to `.sugar/config.yaml`:
|
|
128
|
+
|
|
129
|
+
```yaml
|
|
130
|
+
sugar:
|
|
131
|
+
executor:
|
|
132
|
+
thinking_capture: false
|
|
133
|
+
```
|
|
134
|
+
|
|
135
|
+
## Related Commands
|
|
136
|
+
|
|
137
|
+
- `/sugar-status` - View overall system status
|
|
138
|
+
- `/sugar-view` - View task details
|
|
139
|
+
- `/sugar-task-type` - Manage task type configurations
|
package/hooks/hooks.json
CHANGED
|
@@ -1,4 +1,47 @@
|
|
|
1
1
|
{
|
|
2
|
-
"
|
|
3
|
-
|
|
2
|
+
"hooks": {
|
|
3
|
+
"PreToolUse": [
|
|
4
|
+
{
|
|
5
|
+
"matcher": "Bash",
|
|
6
|
+
"hooks": [
|
|
7
|
+
{
|
|
8
|
+
"type": "command",
|
|
9
|
+
"command": "echo '{\"decision\": \"approve\"}'"
|
|
10
|
+
}
|
|
11
|
+
]
|
|
12
|
+
}
|
|
13
|
+
],
|
|
14
|
+
"PostToolUse": [
|
|
15
|
+
{
|
|
16
|
+
"matcher": "Bash",
|
|
17
|
+
"description": "Suggest task creation when errors are detected",
|
|
18
|
+
"hooks": [
|
|
19
|
+
{
|
|
20
|
+
"type": "command",
|
|
21
|
+
"command": "if echo \"$CLAUDE_TOOL_OUTPUT\" | grep -qiE 'error|exception|fail|bug|crash'; then echo 'Error detected! Consider creating a Sugar task to fix this with /sugar-task' >&2; fi; exit 0"
|
|
22
|
+
}
|
|
23
|
+
]
|
|
24
|
+
},
|
|
25
|
+
{
|
|
26
|
+
"matcher": "Bash",
|
|
27
|
+
"description": "Suggest task update after git commits",
|
|
28
|
+
"hooks": [
|
|
29
|
+
{
|
|
30
|
+
"type": "command",
|
|
31
|
+
"command": "if echo \"$CLAUDE_TOOL_INPUT\" | grep -q 'git commit'; then echo 'Code committed! If this completes a Sugar task, use: sugar update TASK_ID --status completed' >&2; fi; exit 0"
|
|
32
|
+
}
|
|
33
|
+
]
|
|
34
|
+
}
|
|
35
|
+
],
|
|
36
|
+
"Notification": [
|
|
37
|
+
{
|
|
38
|
+
"hooks": [
|
|
39
|
+
{
|
|
40
|
+
"type": "command",
|
|
41
|
+
"command": "echo 'Sugar notification hook'"
|
|
42
|
+
}
|
|
43
|
+
]
|
|
44
|
+
}
|
|
45
|
+
]
|
|
46
|
+
}
|
|
4
47
|
}
|
package/package.json
CHANGED
|
@@ -6,7 +6,7 @@ allowed-tools: Read, Write, Edit, Grep, Glob, Bash(cmd:*)
|
|
|
6
6
|
version: 1.0.0
|
|
7
7
|
author: Steven Leggett <contact@roboticforce.io>
|
|
8
8
|
license: MIT
|
|
9
|
-
|
|
9
|
+
compatibility: Designed for Claude Code, also compatible with Codex and OpenClaw
|
|
10
10
|
tags: [devops, workflow, autonomous-development]
|
|
11
11
|
---
|
|
12
12
|
# Managing Autonomous Development
|
|
@@ -61,5 +61,5 @@ Manage Sugar's autonomous development workflows: create development tasks, check
|
|
|
61
61
|
## Resources
|
|
62
62
|
|
|
63
63
|
- Sugar plugin documentation: https://github.com/roboticforce/sugar
|
|
64
|
-
- Task automation patterns:
|
|
65
|
-
- Autonomous development best practices:
|
|
64
|
+
- Task automation patterns:
|
|
65
|
+
- Autonomous development best practices: best-practices/
|