@leclabs/agent-toolkit 1.1.0 → 1.3.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 +91 -102
  2. package/package.json +5 -3
package/README.md CHANGED
@@ -1,129 +1,118 @@
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)
3
+ A Claude Code plugin marketplace for AI agent tools. The flagship plugin is **Flow** -- a stateless state-machine for Agents.
6
4
 
7
- The essential Claude Code plugin marketplace for reliable Agent-led workflow orchestration.
5
+ ## Installation
8
6
 
9
- ## What's Included
7
+ ```bash
8
+ # Add the toolkit to Claude Code
9
+ claude plugin marketplace add leclabs/agent-toolkit
10
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 |
11
+ claude plugin install flow@agent-toolkit
12
+ ```
15
13
 
16
- ## Installation
14
+ ```mermaid
15
+ flowchart TD
16
+ start(("Start"))
17
+ work["Do Work<br/><small>Developer</small>"]
18
+ check{"Check"}
19
+ end_success[["Done"]]
20
+ hitl_blocked{{"Blocked"}}
21
+
22
+ start --> work
23
+ work --> check
24
+ check -->|passed| end_success
25
+ check -->|failed| work
26
+ check -->|failed| hitl_blocked
27
+ hitl_blocked -->|passed| work
28
+
29
+ classDef startStep fill:#90EE90,stroke:#228B22
30
+ classDef successStep fill:#87CEEB,stroke:#4169E1
31
+ classDef hitlStep fill:#FFB6C1,stroke:#DC143C
32
+ classDef gateStep fill:#E6E6FA,stroke:#9370DB
33
+ classDef currentStep fill:#FFD700,stroke:#FF8C00,stroke-width:3px
34
+ class start startStep
35
+ class end_success successStep
36
+ class hitl_blocked hitlStep
37
+ class check gateStep
38
+ ```
17
39
 
18
- Add the marketplace to Claude Code:
40
+ ## Quick Start
19
41
 
20
42
  ```bash
21
- claude plugin marketplace add https://github.com/leclabs/agent-toolkit
22
- ```
43
+ # Load the orchestrator at session start
44
+ /flow:prime
23
45
 
24
- Install the Flow plugin:
46
+ # Create a task using any command
47
+ /flow:feat "add user authentication"
48
+ /flow:bug "fix login redirect loop"
49
+ /flow:task "refactor the settings module"
25
50
 
26
- ```bash
27
- claude plugin install flow@agent-toolkit
51
+ # Execute all pending tasks
52
+ /flow:go
28
53
  ```
29
54
 
30
- ## Quick Start
55
+ ## Commands
31
56
 
32
- Use prefix commands to create and execute workflow-tracked tasks:
57
+ Commands are the primary human interface. Type a command to create a task with the right workflow:
33
58
 
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 |
59
+ | Command | Workflow | Description |
60
+ | ------------- | -------------------- | ---------------------------------- |
61
+ | `/flow:feat` | feature-development | New feature with planning + review |
62
+ | `/flow:bug` | bug-fix | Bug investigation and fix |
63
+ | `/flow:task` | agile-task | General development task |
64
+ | `/flow:fix` | quick-task | Quick fix, minimal ceremony |
65
+ | `/flow:spec` | test-coverage | Analyze and improve test coverage |
66
+ | `/flow:ctx` | context-optimization | Optimize agent context and prompts |
67
+ | `/flow:ui` | ui-reconstruction | Reconstruct UI from reference |
68
+ | `/flow:go` | _(runs task queue)_ | Execute all pending tasks |
69
+ | `/flow:recon` | _(exploration)_ | Deep project reconnaissance |
41
70
 
42
- **Examples:**
71
+ ## Workflows
43
72
 
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
- ```
50
-
51
- ## How It Works
73
+ 10 workflow templates ship in the catalog:
52
74
 
53
- The Flow plugin provides DAG-based workflow orchestration. When you use a prefix command, it:
75
+ | Workflow | Steps | Description |
76
+ | ------------------------- | ----- | ------------------------------------------------------ |
77
+ | feature-development | 15 | Full lifecycle: plan, implement, test, review, PR |
78
+ | bug-fix | 11 | Reproduce, investigate, fix, regression test |
79
+ | agile-task | 9 | General task: analyze, implement, test, review |
80
+ | quick-task | 8 | Minimal: understand, execute, verify |
81
+ | test-coverage | 10 | Analyze gaps, write tests, review |
82
+ | context-optimization | 9 | Map connections, identify pathologies, improve |
83
+ | ui-reconstruction | 17 | Extract semantic IR, rebuild UI, blind review |
84
+ | refactor | 16 | Functional core / imperative shell restructuring |
85
+ | build-review-murder-board | 7 | Build-review loop, level 5 scrutiny, blind-shot review |
86
+ | build-review-quick | 7 | Build-review loop, basic sanity check |
54
87
 
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
88
+ Customize workflows for your project with `/flow:init`.
59
89
 
60
- ### Architecture
90
+ ## Architecture
61
91
 
62
92
  ```
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)
93
+ /flow:feat "add dark mode" ← human types a command
94
+ │
95
+ ▼
96
+ ┌──────────────────┐ ┌──────────────────┐
97
+ │ Orchestrator │ ◄─MCP─► │ Navigator │
98
+ │ (flow:prime) │ │ (state machine) │
99
+ └──────────────────┘ └──────────────────┘
100
+ │ │
101
+ ▼ ▼
102
+ ┌──────────────────┐ ┌──────────────────┐
103
+ │ Subagents │ │ Workflows │
104
+ │ @flow:Planner │ │ (DAGs) │
105
+ │ @flow:Developer │ └──────────────────┘
106
+ │ @flow:Tester │
107
+ │ @flow:Reviewer │
108
+ └──────────────────┘
75
109
  ```
76
110
 
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
111
+ ## Links
112
+
113
+ - [Flow Plugin](plugins/flow/README.md) -- commands, skills, workflows, and customization
114
+ - [Navigator MCP Server](packages/agent-flow-navigator-mcp/README.md) -- workflow state machine
126
115
 
127
116
  ## License
128
117
 
129
- ISC License - see [LICENSE](LICENSE) for details.
118
+ 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.3.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,8 +15,10 @@
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",
19
- "plugin:reinstall": "(claude plugin uninstall flow@agent-toolkit || true) && claude plugin marketplace update agent-toolkit && claude plugin install flow@agent-toolkit"
18
+ "release": "npm whoami --registry https://registry.npmjs.org/ || (echo '\\nAuth failed. Run: npm config set //registry.npmjs.org/:_authToken=YOUR_TOKEN' && exit 1) && npm publish --access public && cd packages/agent-flow-navigator-mcp && npm publish --access public",
19
+ "dev:setup": "npm run dev:setup:mcp && npm run dev:setup:plugin",
20
+ "dev:setup:mcp": "npm link --prefix packages/agent-flow-navigator-mcp && npm link @leclabs/agent-flow-navigator-mcp",
21
+ "dev:setup:plugin": "(claude plugin uninstall flow@agent-toolkit || true) && (claude plugin marketplace remove agent-toolkit || true) && claude plugin marketplace add $(pwd) && claude plugin install flow@agent-toolkit"
20
22
  },
21
23
  "repository": {
22
24
  "type": "git",