@leclabs/agent-toolkit 1.1.0 → 1.2.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/README.md +64 -103
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,129 +1,90 @@
|
|
|
1
1
|
# Agent Toolkit
|
|
2
2
|
|
|
3
|
-
|
|
4
|
-
[](https://opensource.org/licenses/ISC)
|
|
5
|
-
[](https://github.com/leclabs/agent-toolkit/stargazers)
|
|
6
|
-
|
|
7
|
-
The essential Claude Code plugin marketplace for reliable Agent-led workflow orchestration.
|
|
8
|
-
|
|
9
|
-
## What's Included
|
|
10
|
-
|
|
11
|
-
| Component | Description |
|
|
12
|
-
| ------------------------------------------------------- | ------------------------------------------------------------------------ |
|
|
13
|
-
| **[Flow Plugin](plugins/flow/)** | DAG-based workflow orchestration for Claude Code |
|
|
14
|
-
| **[Navigator MCP](packages/agent-flow-navigator-mcp/)** | Workflow state machine that navigates agents through DAG-based workflows |
|
|
3
|
+
A Claude Code plugin marketplace for AI agent tools. The flagship plugin is **Flow** -- DAG-based workflow orchestration that guides agents through structured, multi-step tasks.
|
|
15
4
|
|
|
16
5
|
## Installation
|
|
17
6
|
|
|
18
|
-
Add the marketplace to Claude Code:
|
|
19
|
-
|
|
20
7
|
```bash
|
|
21
|
-
|
|
8
|
+
# Add the toolkit to Claude Code
|
|
9
|
+
claude plugin:add github:leclabs/agent-toolkit
|
|
22
10
|
```
|
|
23
11
|
|
|
24
|
-
|
|
12
|
+
## Quick Start
|
|
25
13
|
|
|
26
14
|
```bash
|
|
27
|
-
|
|
28
|
-
|
|
15
|
+
# Load the orchestrator at session start
|
|
16
|
+
/flow:prime
|
|
29
17
|
|
|
30
|
-
|
|
18
|
+
# Create a task using any command
|
|
19
|
+
/flow:feat "add user authentication"
|
|
20
|
+
/flow:bug "fix login redirect loop"
|
|
21
|
+
/flow:task "refactor the settings module"
|
|
31
22
|
|
|
32
|
-
|
|
23
|
+
# Execute all pending tasks
|
|
24
|
+
/flow:go
|
|
25
|
+
```
|
|
33
26
|
|
|
34
|
-
|
|
35
|
-
| ------- | -------------------- | --------------------------------------------------------------- |
|
|
36
|
-
| `feat:` | feature-development | Full lifecycle: requirements, planning, implementation, testing |
|
|
37
|
-
| `bug:` | bug-fix | Bug workflow: reproduce, investigate, fix, verify |
|
|
38
|
-
| `fix:` | quick-task | Minimal: understand, execute, verify |
|
|
39
|
-
| `test:` | test-coverage | Analyze coverage gaps and write tests |
|
|
40
|
-
| `ctx:` | context-optimization | Optimize agent context and instructions |
|
|
27
|
+
## Commands
|
|
41
28
|
|
|
42
|
-
|
|
29
|
+
Commands are the primary human interface. Type a command to create a task with the right workflow:
|
|
43
30
|
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
|
|
49
|
-
|
|
31
|
+
| Command | Workflow | Description |
|
|
32
|
+
| ------------- | -------------------- | ---------------------------------- |
|
|
33
|
+
| `/flow:feat` | feature-development | New feature with planning + review |
|
|
34
|
+
| `/flow:bug` | bug-fix | Bug investigation and fix |
|
|
35
|
+
| `/flow:task` | agile-task | General development task |
|
|
36
|
+
| `/flow:fix` | quick-task | Quick fix, minimal ceremony |
|
|
37
|
+
| `/flow:spec` | test-coverage | Analyze and improve test coverage |
|
|
38
|
+
| `/flow:ctx` | context-optimization | Optimize agent context and prompts |
|
|
39
|
+
| `/flow:ui` | ui-reconstruction | Reconstruct UI from reference |
|
|
40
|
+
| `/flow:go` | _(runs task queue)_ | Execute all pending tasks |
|
|
41
|
+
| `/flow:recon` | _(exploration)_ | Deep project reconnaissance |
|
|
42
|
+
|
|
43
|
+
## Workflows
|
|
50
44
|
|
|
51
|
-
|
|
45
|
+
10 workflow templates ship in the catalog:
|
|
52
46
|
|
|
53
|
-
|
|
47
|
+
| Workflow | Steps | Description |
|
|
48
|
+
| ------------------------- | ----- | ------------------------------------------------------ |
|
|
49
|
+
| feature-development | 15 | Full lifecycle: plan, implement, test, review, PR |
|
|
50
|
+
| bug-fix | 11 | Reproduce, investigate, fix, regression test |
|
|
51
|
+
| agile-task | 9 | General task: analyze, implement, test, review |
|
|
52
|
+
| quick-task | 8 | Minimal: understand, execute, verify |
|
|
53
|
+
| test-coverage | 10 | Analyze gaps, write tests, review |
|
|
54
|
+
| context-optimization | 9 | Map connections, identify pathologies, improve |
|
|
55
|
+
| ui-reconstruction | 17 | Extract semantic IR, rebuild UI, blind review |
|
|
56
|
+
| refactor | 16 | Functional core / imperative shell restructuring |
|
|
57
|
+
| build-review-murder-board | 7 | Build-review loop, level 5 scrutiny, blind-shot review |
|
|
58
|
+
| build-review-quick | 7 | Build-review loop, basic sanity check |
|
|
54
59
|
|
|
55
|
-
|
|
56
|
-
2. **Navigates** through workflow steps using the Navigator MCP
|
|
57
|
-
3. **Delegates** to specialized subagents (@flow:Planner, @flow:Developer, @flow:Tester)
|
|
58
|
-
4. **Tracks progress** with retry logic and HITL escalation
|
|
60
|
+
Customize workflows for your project with `/flow:init`.
|
|
59
61
|
|
|
60
|
-
|
|
62
|
+
## Architecture
|
|
61
63
|
|
|
62
64
|
```
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
|
|
69
|
-
|
|
70
|
-
|
|
71
|
-
|
|
72
|
-
|
|
73
|
-
|
|
74
|
-
|
|
65
|
+
/flow:feat "add dark mode" ← human types a command
|
|
66
|
+
│
|
|
67
|
+
▼
|
|
68
|
+
┌──────────────────┐ ┌──────────────────┐
|
|
69
|
+
│ Orchestrator │ ◄─MCP─► │ Navigator │
|
|
70
|
+
│ (flow:prime) │ │ (state machine) │
|
|
71
|
+
└──────────────────┘ └──────────────────┘
|
|
72
|
+
│ │
|
|
73
|
+
▼ ▼
|
|
74
|
+
┌──────────────────┐ ┌──────────────────┐
|
|
75
|
+
│ Subagents │ │ Workflows │
|
|
76
|
+
│ @flow:Planner │ │ (DAGs) │
|
|
77
|
+
│ @flow:Developer │ └──────────────────┘
|
|
78
|
+
│ @flow:Tester │
|
|
79
|
+
│ @flow:Reviewer │
|
|
80
|
+
└──────────────────┘
|
|
75
81
|
```
|
|
76
82
|
|
|
77
|
-
##
|
|
78
|
-
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
| **feature-development** | requirements → planning → implementation → testing → review | New features with full lifecycle |
|
|
82
|
-
| **bug-fix** | reproduce → investigate → fix → verify | Bug fixes with root cause analysis |
|
|
83
|
-
| **agile-task** | understand → implement → verify | Standard development tasks |
|
|
84
|
-
| **quick-task** | understand → execute → verify | Fast, minimal overhead tasks |
|
|
85
|
-
| **test-coverage** | analyze → write-tests → verify | Improving test coverage |
|
|
86
|
-
| **context-optimization** | audit → optimize → validate | Improving agent context |
|
|
87
|
-
| **ui-reconstruction** | analyze → reconstruct → verify | UI/component rebuilding |
|
|
88
|
-
|
|
89
|
-
## Skills Reference
|
|
90
|
-
|
|
91
|
-
| Skill | Description |
|
|
92
|
-
| -------------------- | --------------------------------------------------- |
|
|
93
|
-
| `/flow:prime` | Load orchestrator context (invoke at session start) |
|
|
94
|
-
| `/flow:task-create` | Create a new workflow task |
|
|
95
|
-
| `/flow:run` | Execute tasks autonomously with subagent delegation |
|
|
96
|
-
| `/flow:task-list` | List all tasks with status |
|
|
97
|
-
| `/flow:task-get` | Get task details with workflow diagram |
|
|
98
|
-
| `/flow:task-advance` | Manually advance a task to next step |
|
|
99
|
-
| `/flow:init` | Copy workflows to project `.flow/workflows/` |
|
|
100
|
-
| `/flow:diagram` | Generate mermaid diagram for a workflow |
|
|
101
|
-
|
|
102
|
-
## Feature Highlights
|
|
103
|
-
|
|
104
|
-
- **DAG-Based Workflows**: Define complex workflows as directed acyclic graphs with conditional edges
|
|
105
|
-
- **Subagent Delegation**: Specialized agents handle specific workflow steps (@flow:Planner, @flow:Developer, @flow:Tester)
|
|
106
|
-
- **Retry Logic**: Per-step retry tracking with configurable limits
|
|
107
|
-
- **HITL Escalation**: Automatic human-in-the-loop escalation when retries are exhausted
|
|
108
|
-
- **Progress Tracking**: Visual progress through workflow stages
|
|
109
|
-
- **Workflow Catalog**: Pre-built workflows for common development patterns
|
|
110
|
-
|
|
111
|
-
## Documentation
|
|
112
|
-
|
|
113
|
-
- [Flow Plugin Documentation](plugins/flow/) - Detailed plugin usage and customization
|
|
114
|
-
- [Navigator MCP Reference](packages/agent-flow-navigator-mcp/) - MCP server API and workflow schema
|
|
115
|
-
- [Workflow Schema](packages/agent-flow-navigator-mcp/README.md#workflow-definition-schema) - Node types, edge properties, task schema
|
|
116
|
-
|
|
117
|
-
## Contributing
|
|
118
|
-
|
|
119
|
-
1. Fork the repository
|
|
120
|
-
2. Create a feature branch (`git checkout -b feat/amazing-feature`)
|
|
121
|
-
3. Make your changes
|
|
122
|
-
4. Run tests (`npm test`)
|
|
123
|
-
5. Commit with conventional commits (`git commit -m 'feat: add amazing feature'`)
|
|
124
|
-
6. Push to your fork (`git push origin feat/amazing-feature`)
|
|
125
|
-
7. Open a Pull Request
|
|
83
|
+
## Links
|
|
84
|
+
|
|
85
|
+
- [Flow Plugin](plugins/flow/README.md) -- commands, skills, workflows, and customization
|
|
86
|
+
- [Navigator MCP Server](packages/agent-flow-navigator-mcp/README.md) -- workflow state machine
|
|
126
87
|
|
|
127
88
|
## License
|
|
128
89
|
|
|
129
|
-
ISC
|
|
90
|
+
ISC
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@leclabs/agent-toolkit",
|
|
3
|
-
"version": "1.
|
|
3
|
+
"version": "1.2.0",
|
|
4
4
|
"description": "The essential Claude Code plugin marketplace for reliable Agent-led workflow orchestration",
|
|
5
5
|
"main": "index.js",
|
|
6
6
|
"bin": {
|
|
@@ -15,7 +15,7 @@
|
|
|
15
15
|
"format": "prettier --write .",
|
|
16
16
|
"changeset": "changeset",
|
|
17
17
|
"version": "changeset version && node scripts/sync-versions.js",
|
|
18
|
-
"publish:all": "npm publish --access public &&
|
|
18
|
+
"publish:all": "npm publish --access public && cd packages/agent-flow-navigator-mcp && npm publish --access public",
|
|
19
19
|
"plugin:reinstall": "(claude plugin uninstall flow@agent-toolkit || true) && claude plugin marketplace update agent-toolkit && claude plugin install flow@agent-toolkit"
|
|
20
20
|
},
|
|
21
21
|
"repository": {
|