@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.
Files changed (2) hide show
  1. package/README.md +64 -103
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -1,129 +1,90 @@
1
1
  # Agent Toolkit
2
2
 
3
- [![npm version](https://img.shields.io/npm/v/@leclabs/agent-toolkit)](https://www.npmjs.com/package/@leclabs/agent-toolkit)
4
- [![License: ISC](https://img.shields.io/badge/License-ISC-blue.svg)](https://opensource.org/licenses/ISC)
5
- [![GitHub stars](https://img.shields.io/github/stars/leclabs/agent-toolkit)](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
- claude plugin marketplace add https://github.com/leclabs/agent-toolkit
8
+ # Add the toolkit to Claude Code
9
+ claude plugin:add github:leclabs/agent-toolkit
22
10
  ```
23
11
 
24
- Install the Flow plugin:
12
+ ## Quick Start
25
13
 
26
14
  ```bash
27
- claude plugin install flow@agent-toolkit
28
- ```
15
+ # Load the orchestrator at session start
16
+ /flow:prime
29
17
 
30
- ## Quick Start
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
- Use prefix commands to create and execute workflow-tracked tasks:
23
+ # Execute all pending tasks
24
+ /flow:go
25
+ ```
33
26
 
34
- | Prefix | Workflow | Description |
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
- **Examples:**
29
+ Commands are the primary human interface. Type a command to create a task with the right workflow:
43
30
 
44
- ```
45
- feat: Add user authentication with OAuth2 support
46
- bug: Login button not responding on mobile devices
47
- fix: Update copyright year in footer
48
- test: Increase coverage for payment module
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
- ## How It Works
45
+ 10 workflow templates ship in the catalog:
52
46
 
53
- The Flow plugin provides DAG-based workflow orchestration. When you use a prefix command, it:
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
- 1. **Creates a task** with the appropriate workflow type
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
- ### Architecture
62
+ ## Architecture
61
63
 
62
64
  ```
63
- Orchestrator (Claude Code)
64
- │
65
- ├── /flow:task-create Create tasks with workflow metadata
66
- ├── /flow:run Execute tasks through workflow steps
67
- ├── /flow:task-list View all tasks and their status
68
- └── /flow:task-advance Manually advance tasks
69
- │
70
- ▼
71
- Navigator MCP Server
72
- ├── Workflow Store (Graph definitions)
73
- ├── Edge Evaluator (Conditional routing)
74
- └── Retry Tracking (Per-step retries with HITL escalation)
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
- ## Available Workflows
78
-
79
- | Workflow | Steps | Use Case |
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 License - see [LICENSE](LICENSE) for details.
90
+ ISC
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@leclabs/agent-toolkit",
3
- "version": "1.1.0",
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 && npm publish --access public --prefix packages/agent-flow-navigator-mcp",
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": {