sqlew 4.0.2 → 4.0.4
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/CHANGELOG.md +79 -0
- package/README.md +17 -105
- package/assets/claude-md-snippets/plan-mode-integration.md +13 -0
- package/assets/config.example.toml +16 -0
- package/assets/sample-agents/sqlew-architect.md +1 -0
- package/assets/sample-agents/sqlew-researcher.md +1 -0
- package/assets/sample-agents/sqlew-scrum-master.md +1 -0
- package/assets/sample-commands/sqlew.md +144 -0
- package/assets/sample-skills/sqlew-plan-guidance/SKILL.md +55 -0
- package/dist/config/minimal-generator.d.ts.map +1 -1
- package/dist/config/minimal-generator.js +72 -91
- package/dist/config/minimal-generator.js.map +1 -1
- package/dist/config/types.d.ts +2 -12
- package/dist/config/types.d.ts.map +1 -1
- package/dist/config/types.js +1 -6
- package/dist/config/types.js.map +1 -1
- package/dist/init-commands.d.ts +5 -2
- package/dist/init-commands.d.ts.map +1 -1
- package/dist/init-commands.js +36 -175
- package/dist/init-commands.js.map +1 -1
- package/dist/init-skills.d.ts +19 -0
- package/dist/init-skills.d.ts.map +1 -0
- package/dist/init-skills.js +104 -0
- package/dist/init-skills.js.map +1 -0
- package/dist/server/setup.d.ts.map +1 -1
- package/dist/server/setup.js +9 -0
- package/dist/server/setup.js.map +1 -1
- package/dist/sync-commands.d.ts.map +1 -1
- package/dist/sync-commands.js +2 -7
- package/dist/sync-commands.js.map +1 -1
- package/dist/tests/unit/case-insensitive-validator.test.d.ts +14 -0
- package/dist/tests/unit/case-insensitive-validator.test.d.ts.map +1 -0
- package/dist/tests/unit/case-insensitive-validator.test.js +390 -0
- package/dist/tests/unit/case-insensitive-validator.test.js.map +1 -0
- package/dist/tools/tasks/actions/get.d.ts.map +1 -1
- package/dist/tools/tasks/actions/get.js +1 -4
- package/dist/tools/tasks/actions/get.js.map +1 -1
- package/dist/tools/tasks/internal/task-queries.d.ts.map +1 -1
- package/dist/tools/tasks/internal/task-queries.js +2 -8
- package/dist/tools/tasks/internal/task-queries.js.map +1 -1
- package/docs/SLASH_COMMANDS.md +192 -478
- package/docs/SPECIALIZED_AGENTS.md +81 -43
- package/package.json +1 -1
- package/assets/sample-commands/sqw-documentor.md +0 -204
- package/assets/sample-commands/sqw-plan.md +0 -348
- package/assets/sample-commands/sqw-research.md +0 -359
- package/assets/sample-commands/sqw-review.md +0 -377
- package/assets/sample-commands/sqw-scrum.md +0 -457
package/CHANGELOG.md
CHANGED
|
@@ -7,6 +7,85 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
|
|
|
7
7
|
|
|
8
8
|
---
|
|
9
9
|
|
|
10
|
+
## [4.0.4] - 2025-12-10
|
|
11
|
+
|
|
12
|
+
### Fixed
|
|
13
|
+
|
|
14
|
+
**Slash Command Sync Bug**
|
|
15
|
+
|
|
16
|
+
- Fixed `sync-commands.ts` referencing obsolete command files (`sqw-scrum.md`, `sqw-documentor.md`, etc.)
|
|
17
|
+
- Updated to use new unified `sqlew.md` command file
|
|
18
|
+
- Resolves "Source file not found" errors during npm package installation
|
|
19
|
+
|
|
20
|
+
### Added
|
|
21
|
+
|
|
22
|
+
**Agent Skills Configuration**
|
|
23
|
+
|
|
24
|
+
- Added `skills` field to agent YAML frontmatter for automatic skill loading
|
|
25
|
+
- All sqlew agents now reference `sqlew-plan-guidance` skill
|
|
26
|
+
- Agents: `sqlew-architect`, `sqlew-researcher`, `sqlew-scrum-master`
|
|
27
|
+
|
|
28
|
+
**Config Example Update**
|
|
29
|
+
|
|
30
|
+
- Added `[commands]` section to `assets/config.example.toml`
|
|
31
|
+
- Documents the unified `/sqlew` command configuration
|
|
32
|
+
|
|
33
|
+
### Changed
|
|
34
|
+
|
|
35
|
+
**Plan Mode Integration Documentation**
|
|
36
|
+
|
|
37
|
+
- Changed `Phase 1 (Research)` → `Research Phase` for flexibility
|
|
38
|
+
- Changed `Phase 4 (Final Plan)` → `Final Plan Phase`
|
|
39
|
+
- Plan mode phases are now semantically named instead of numbered
|
|
40
|
+
|
|
41
|
+
**CommandsConfig Simplified**
|
|
42
|
+
|
|
43
|
+
- Consolidated 6 individual command options into single `sqlew` option
|
|
44
|
+
- Updated `src/config/types.ts` and `src/config/minimal-generator.ts`
|
|
45
|
+
|
|
46
|
+
---
|
|
47
|
+
|
|
48
|
+
## [4.0.3] - 2025-12-04
|
|
49
|
+
|
|
50
|
+
### Added
|
|
51
|
+
|
|
52
|
+
**Unified `/sqlew` Slash Command**
|
|
53
|
+
|
|
54
|
+
- Consolidated all slash commands (`/sqw-plan`, `/sqw-scrum`, `/sqw-research`, etc.) into single `/sqlew` command
|
|
55
|
+
- Natural language interface with automatic intent detection
|
|
56
|
+
- 6-level intent priority: List/Status → Search → Record → Update → Execute → Task Creation
|
|
57
|
+
- Supports both English and Japanese keywords
|
|
58
|
+
- Removed custom agent definitions (sqlew-architect, scrum-master, sqlew-researcher)
|
|
59
|
+
|
|
60
|
+
**Usage Examples:**
|
|
61
|
+
```bash
|
|
62
|
+
/sqlew # Show status and suggest next action
|
|
63
|
+
/sqlew show remaining tasks # List/Status intent
|
|
64
|
+
/sqlew search for auth decisions # Search intent
|
|
65
|
+
/sqlew record that we use JWT # Record intent
|
|
66
|
+
/sqlew execute pending tasks # Execute intent
|
|
67
|
+
```
|
|
68
|
+
|
|
69
|
+
### Fixed
|
|
70
|
+
|
|
71
|
+
**v4_task_details JOIN Bug**
|
|
72
|
+
|
|
73
|
+
- Fixed `task.get` action failing with "no such column: td.project_id" error
|
|
74
|
+
- Root cause: `v4_task_details` table has only `task_id` as PK, not `project_id`
|
|
75
|
+
- Removed invalid `.andOn('t.project_id', '=', 'td.project_id')` from JOIN conditions
|
|
76
|
+
- Affected files: `task-queries.ts`, `get.ts`
|
|
77
|
+
|
|
78
|
+
### Changed
|
|
79
|
+
|
|
80
|
+
**Documentation Updates**
|
|
81
|
+
|
|
82
|
+
- Rewrote `CLAUDE.md` with unified `/sqlew` command section
|
|
83
|
+
- Updated `README.md` Quick Start to use `/sqlew`
|
|
84
|
+
- Rewrote `docs/SLASH_COMMANDS.md` as Unified /sqlew Command Guide
|
|
85
|
+
- Marked `docs/SPECIALIZED_AGENTS.md` as deprecated with migration guide
|
|
86
|
+
|
|
87
|
+
---
|
|
88
|
+
|
|
10
89
|
## [4.0.2] - 2025-11-28
|
|
11
90
|
|
|
12
91
|
### BREAKING CHANGES
|
package/README.md
CHANGED
|
@@ -119,27 +119,30 @@ The first time, sqlew initializes database, installs custom agents and slash com
|
|
|
119
119
|
|
|
120
120
|
It's Ready!
|
|
121
121
|
|
|
122
|
-
## 🚀 Quick Start:
|
|
122
|
+
## 🚀 Quick Start: /sqlew Command
|
|
123
123
|
|
|
124
|
-
**
|
|
124
|
+
**The `/sqlew` command is the easiest way to use sqlew!** Just type `/sqlew` in Claude Code with natural language input.
|
|
125
125
|
|
|
126
|
-
### Most Common
|
|
126
|
+
### Most Common Uses
|
|
127
127
|
|
|
128
128
|
```bash
|
|
129
|
-
#
|
|
130
|
-
/
|
|
129
|
+
# Show status and get suggestions
|
|
130
|
+
/sqlew
|
|
131
131
|
|
|
132
|
-
# Record a decision
|
|
133
|
-
/
|
|
134
|
-
|
|
135
|
-
# Implement a feature (creates tasks AND coordinates agents to build it!)
|
|
136
|
-
/sqw-scrum implement JWT authentication
|
|
132
|
+
# Record a decision
|
|
133
|
+
/sqlew record we use PostgreSQL 15 for production database
|
|
137
134
|
|
|
138
135
|
# Search past decisions
|
|
139
|
-
/
|
|
136
|
+
/sqlew search why we chose Knex for migrations
|
|
137
|
+
|
|
138
|
+
# List remaining tasks
|
|
139
|
+
/sqlew show remaining tasks
|
|
140
|
+
|
|
141
|
+
# Plan a new feature (breakdown into tasks)
|
|
142
|
+
/sqlew plan implementing user authentication
|
|
140
143
|
```
|
|
141
144
|
|
|
142
|
-
|
|
145
|
+
The `/sqlew` command automatically detects your intent (search, record, list, execute, task creation) and invokes the appropriate MCP tools.
|
|
143
146
|
|
|
144
147
|
---
|
|
145
148
|
|
|
@@ -262,100 +265,9 @@ or invoke Specialized Agent
|
|
|
262
265
|
|
|
263
266
|
Specialized Agents use sqlew more efficiently.
|
|
264
267
|
|
|
265
|
-
|
|
266
|
-
|
|
267
|
-
sqlew provides three specialized agents for efficient multi-agent coordination in Claude Code:
|
|
268
|
-
|
|
269
|
-
| Agent | Purpose | Token Cost | Use When |
|
|
270
|
-
|-------|---------|------------|----------|
|
|
271
|
-
| **Scrum Master** | Multi-agent coordination, task management, sprint planning | 12KB/conversation | Coordinating complex features, managing dependencies, tracking progress |
|
|
272
|
-
| **Researcher** | Query decisions, analyze patterns, investigate context | 14KB/conversation | Understanding past decisions, onboarding new members, sprint retrospectives |
|
|
273
|
-
| **Architect** | Document decisions, enforce constraints, maintain standards | 20KB/conversation | Making architectural choices, establishing rules, validating compliance |
|
|
274
|
-
|
|
275
|
-
### Detailed Installation
|
|
276
|
-
|
|
277
|
-
**By default, all three specialized agents are automatically installed** to your project's `.claude/agents/` directory on first run.
|
|
278
|
-
|
|
279
|
-
To disable specific agents, create `.sqlew/config.toml`:
|
|
280
|
-
|
|
281
|
-
```toml
|
|
282
|
-
[agents]
|
|
283
|
-
scrum_master = true # Coordination specialist (12KB)
|
|
284
|
-
researcher = false # Disable this agent
|
|
285
|
-
architect = true # Documentation specialist (20KB)
|
|
286
|
-
```
|
|
287
|
-
|
|
288
|
-
**Note**: Set an agent to `false` in the config file to prevent it from being installed.
|
|
289
|
-
|
|
290
|
-
**Usage**: Invoke agents with the `@` prefix: `@sqlew-scrum-master`, `@sqlew-researcher`, `@sqlew-architect`
|
|
291
|
-
|
|
292
|
-
**Recommendation**: Use all three agents together - they're complementary specialists (46KB total).
|
|
293
|
-
|
|
294
|
-
**Token Optimization** (if needed): Disable unused agents in config.
|
|
295
|
-
Savings: Scrum + Architect = 32KB (30%) | Scrum only = 12KB (74%)
|
|
296
|
-
|
|
297
|
-
**See [docs/SPECIALIZED_AGENTS.md](docs/SPECIALIZED_AGENTS.md) for complete installation guide, usage examples, and customization.**
|
|
298
|
-
|
|
299
|
-
## Slash Commands
|
|
300
|
-
|
|
301
|
-
**🎯 Recommended for Human Users** - Slash commands provide guided workflows that are easier than raw MCP tool calls.
|
|
302
|
-
|
|
303
|
-
Installed automatically to `.claude/commands/` on server startup. Just type `/sqw-` in Claude Code to get started!
|
|
304
|
-
|
|
305
|
-
### Available Commands
|
|
306
|
-
|
|
307
|
-
| Command | What It Does | Perfect For |
|
|
308
|
-
|---------|--------------|-------------|
|
|
309
|
-
| **`/sqw-plan`** | Complete feature planning (architecture + tasks) | Starting new features, planning sprints |
|
|
310
|
-
| **`/sqw-secretary`** | Record decisions like meeting minutes | Documenting team decisions, capturing context |
|
|
311
|
-
| **`/sqw-scrum`** | Create tasks AND coordinate agents to implement them | Actually building features end-to-end |
|
|
312
|
-
| **`/sqw-documentor`** | Document architectural decisions with full context | Design reviews, architecture documentation |
|
|
313
|
-
| **`/sqw-research`** | Search past decisions and analyze patterns | Onboarding, understanding past choices |
|
|
314
|
-
| **`/sqw-review`** | Validate code/design against decisions & constraints | Code reviews, ensuring consistency |
|
|
315
|
-
|
|
316
|
-
### Why Use Slash Commands?
|
|
317
|
-
|
|
318
|
-
✅ **Guided workflows** - Commands prompt you through the process
|
|
319
|
-
✅ **Agent coordination** - Automatically invokes the right agents
|
|
320
|
-
✅ **Error handling** - Built-in validation and helpful error messages
|
|
321
|
-
✅ **Mode detection** - `/sqw-scrum plan` manages tasks, `/sqw-scrum implement` builds code
|
|
322
|
-
✅ **No MCP knowledge needed** - Just describe what you want in plain English
|
|
323
|
-
|
|
324
|
-
### Quick Examples
|
|
325
|
-
|
|
326
|
-
```bash
|
|
327
|
-
# Starting a new feature
|
|
328
|
-
/sqw-plan Add OAuth2 social login with Google and GitHub
|
|
329
|
-
# → Architect documents decisions, Scrum creates tasks
|
|
330
|
-
|
|
331
|
-
# Recording a decision from today's meeting
|
|
332
|
-
/sqw-secretary Team decided to use PostgreSQL 15 for production
|
|
333
|
-
# → Saves with context, checks for duplicates
|
|
334
|
-
|
|
335
|
-
# Actually implementing a feature (game changer!)
|
|
336
|
-
/sqw-scrum implement JWT authentication
|
|
337
|
-
# → Creates tasks, coordinates agents, writes code, runs tests
|
|
338
|
-
|
|
339
|
-
# Finding out why something was done
|
|
340
|
-
/sqw-research Why did we choose Knex over Prisma?
|
|
341
|
-
# → Searches decisions, shows rationale and tradeoffs
|
|
342
|
-
```
|
|
343
|
-
|
|
344
|
-
### Configuration
|
|
345
|
-
|
|
346
|
-
All commands install by default. Customize in `.sqlew/config.toml`:
|
|
347
|
-
|
|
348
|
-
```toml
|
|
349
|
-
[commands]
|
|
350
|
-
plan = true # Feature planning
|
|
351
|
-
secretary = true # Record decisions
|
|
352
|
-
scrum = true # Task management + execution
|
|
353
|
-
documentor = true # Architecture docs
|
|
354
|
-
research = true # Search history
|
|
355
|
-
review = true # Code/design validation
|
|
356
|
-
```
|
|
268
|
+
---
|
|
357
269
|
|
|
358
|
-
|
|
270
|
+
**Note**: The `/sqlew` command supersedes the previous multi-command system (`/sqw-plan`, `/sqw-scrum`, etc.). All functionality is now available through the unified `/sqlew` interface with automatic intent detection.
|
|
359
271
|
|
|
360
272
|
### Advanced: Direct MCP Tool Access
|
|
361
273
|
|
|
@@ -0,0 +1,13 @@
|
|
|
1
|
+
## Plan Mode Integration
|
|
2
|
+
|
|
3
|
+
When `<system-reminder>Plan mode is active</system-reminder>` appears:
|
|
4
|
+
|
|
5
|
+
### Research Phase - Check existing context:
|
|
6
|
+
- `mcp__sqlew__suggest action="by_tags"` - find related decisions
|
|
7
|
+
- `mcp__sqlew__task action="list" status="in_progress"` - check active tasks
|
|
8
|
+
|
|
9
|
+
### Final Plan Phase - Record outcomes:
|
|
10
|
+
- `mcp__sqlew__decision action="set"` - record key architectural decisions
|
|
11
|
+
- `mcp__sqlew__task action="create_batch"` - create implementation tasks
|
|
12
|
+
|
|
13
|
+
**Quick Reference**: `.claude/skills/sqw-plan-guidance/SKILL.md`
|
|
@@ -190,6 +190,22 @@ architect = true
|
|
|
190
190
|
# NOTE: Documentation is centralized in docs/SPECIALIZED_AGENTS.md
|
|
191
191
|
# See: https://github.com/sin5ddd/mcp-sqlew/blob/main/docs/SPECIALIZED_AGENTS.md
|
|
192
192
|
|
|
193
|
+
# ============================================================================
|
|
194
|
+
# Slash Commands Settings
|
|
195
|
+
# ============================================================================
|
|
196
|
+
[commands]
|
|
197
|
+
# Which slash commands to install on server startup
|
|
198
|
+
# Set to false to skip commands you don't need
|
|
199
|
+
|
|
200
|
+
# /sqlew: Unified natural language interface for decisions and tasks
|
|
201
|
+
# Usage: /sqlew <what you want to do>
|
|
202
|
+
# Examples:
|
|
203
|
+
# /sqlew show remaining tasks
|
|
204
|
+
# /sqlew search for auth decisions
|
|
205
|
+
# /sqlew record that we use PostgreSQL 15
|
|
206
|
+
# Default: true
|
|
207
|
+
sqlew = true
|
|
208
|
+
|
|
193
209
|
# ============================================================================
|
|
194
210
|
# Example Configurations
|
|
195
211
|
# ============================================================================
|
|
@@ -3,6 +3,7 @@ name: sqlew-architect
|
|
|
3
3
|
description: Use this agent when you need to document architectural decisions, enforce design constraints, maintain technical standards, and ensure long-term system integrity. Specialized in creating decision records with comprehensive rationale, establishing constraints, and validating architectural compliance. This agent is your guardian of design quality and consistency.
|
|
4
4
|
model: opus
|
|
5
5
|
color: green
|
|
6
|
+
skills: sqlew-plan-guidance
|
|
6
7
|
Examples:
|
|
7
8
|
|
|
8
9
|
<example>
|
|
@@ -3,6 +3,7 @@ name: sqlew-researcher
|
|
|
3
3
|
description: Use this agent when you need to query, analyze, and extract insights from sqlew's context database. Specialized in searching decisions, reviewing constraints, analyzing task patterns, and investigating historical context. This agent is your go-to for understanding "what was decided and why" across the project lifecycle.
|
|
4
4
|
model: haiku
|
|
5
5
|
color: blue
|
|
6
|
+
skills: sqlew-plan-guidance
|
|
6
7
|
Examples:
|
|
7
8
|
|
|
8
9
|
<example>
|
|
@@ -3,6 +3,7 @@ name: scrum-master
|
|
|
3
3
|
description: Use this agent when you need to coordinate multi-agent development work, manage agile workflows, track tasks and dependencies using sqlew, or facilitate sprint planning and execution. This agent should proactively monitor project progress and ensure efficient collaboration between sub-agents.
|
|
4
4
|
model: sonnet
|
|
5
5
|
color: purple
|
|
6
|
+
skills: sqlew-plan-guidance
|
|
6
7
|
Examples:
|
|
7
8
|
|
|
8
9
|
<example>
|
|
@@ -0,0 +1,144 @@
|
|
|
1
|
+
---
|
|
2
|
+
allowed-tools: mcp__sqlew, Task, Read, Glob
|
|
3
|
+
description: sqlew context manager - natural language interface for decisions and tasks
|
|
4
|
+
argument-hint: <what you want to do in natural language>
|
|
5
|
+
---
|
|
6
|
+
|
|
7
|
+
## sqlew Context Manager
|
|
8
|
+
|
|
9
|
+
You are an intelligent interface for the sqlew MCP server. Analyze user input and execute appropriate actions automatically.
|
|
10
|
+
|
|
11
|
+
**Input**: $ARGUMENTS
|
|
12
|
+
|
|
13
|
+
---
|
|
14
|
+
|
|
15
|
+
## If No Arguments Provided
|
|
16
|
+
|
|
17
|
+
Execute status check and suggest next action:
|
|
18
|
+
|
|
19
|
+
### Step 1: Gather Current Status
|
|
20
|
+
|
|
21
|
+
1. **Check plan files**: Use Glob to find `.claude/plans/*.md`
|
|
22
|
+
2. **List decisions**: `mcp__sqlew__decision action="list" limit=5`
|
|
23
|
+
3. **List tasks**: `mcp__sqlew__task action="list"`
|
|
24
|
+
|
|
25
|
+
### Step 2: Analyze and Respond
|
|
26
|
+
|
|
27
|
+
Based on the gathered information:
|
|
28
|
+
|
|
29
|
+
| Situation | Action |
|
|
30
|
+
|-----------|--------|
|
|
31
|
+
| Plan exists & No tasks in sqlew | Ask: "Found plan. Create tasks from it?" |
|
|
32
|
+
| Pending/in_progress tasks exist | Ask: "N tasks remaining. Execute them?" → If yes, run parallel |
|
|
33
|
+
| No plan & Tasks exist | Show task status, suggest next action |
|
|
34
|
+
| Nothing exists | Show usage guide |
|
|
35
|
+
|
|
36
|
+
### Step 3: If User Approves Task Execution
|
|
37
|
+
|
|
38
|
+
1. Get pending tasks: `mcp__sqlew__task action="list" status="pending"`
|
|
39
|
+
2. For each task, launch a subagent using Task tool
|
|
40
|
+
3. After completion, update status: `mcp__sqlew__task action="move" task_id=X status="done"`
|
|
41
|
+
|
|
42
|
+
---
|
|
43
|
+
|
|
44
|
+
## If Arguments Provided
|
|
45
|
+
|
|
46
|
+
Analyze the input and determine intent. **CHECK IN THIS ORDER** (priority matters):
|
|
47
|
+
|
|
48
|
+
### 1. List/Status Intent (CHECK FIRST - highest priority)
|
|
49
|
+
**Keywords**: list, show, status, what, overview, remaining, current, existing, left, pending tasks
|
|
50
|
+
|
|
51
|
+
**Japanese Keywords**: 残り, 残タスク, 書き出, 一覧, 確認, 見せて, 表示
|
|
52
|
+
|
|
53
|
+
**Note**: If input mentions "remaining tasks", "task list", "show tasks" → This is List/Status, NOT Task creation
|
|
54
|
+
|
|
55
|
+
**Action**:
|
|
56
|
+
1. `mcp__sqlew__decision action="list" limit=10`
|
|
57
|
+
2. `mcp__sqlew__task action="list"`
|
|
58
|
+
3. Format as overview
|
|
59
|
+
|
|
60
|
+
### 2. Search Intent
|
|
61
|
+
**Keywords**: search, find, look for, about, related, explore
|
|
62
|
+
|
|
63
|
+
**Japanese Keywords**: 検索, 探して, 調べて
|
|
64
|
+
|
|
65
|
+
**Action**:
|
|
66
|
+
1. Extract search term from input
|
|
67
|
+
2. `mcp__sqlew__suggest action="by_tags" tags=["term"]`
|
|
68
|
+
3. `mcp__sqlew__decision action="search_tags" tags=["term"]`
|
|
69
|
+
4. Format and display results
|
|
70
|
+
|
|
71
|
+
### 3. Record Intent
|
|
72
|
+
**Keywords**: record, add, save, register, decide, decided, decision
|
|
73
|
+
|
|
74
|
+
**Japanese Keywords**: 記録, 登録, 保存
|
|
75
|
+
|
|
76
|
+
**Action**:
|
|
77
|
+
1. Extract key, value, and rationale from input
|
|
78
|
+
2. Check for duplicates: `mcp__sqlew__suggest action="check_duplicate" key="key"`
|
|
79
|
+
3. If no duplicate: `mcp__sqlew__decision action="set" key="key" value="value" rationale="rationale"`
|
|
80
|
+
4. Confirm what was recorded
|
|
81
|
+
|
|
82
|
+
### 4. Update Intent
|
|
83
|
+
**Keywords**: update, change, modify, revise
|
|
84
|
+
|
|
85
|
+
**Japanese Keywords**: 更新, 変更, 修正
|
|
86
|
+
|
|
87
|
+
**Action**:
|
|
88
|
+
1. Extract key and new value from input
|
|
89
|
+
2. Get existing: `mcp__sqlew__decision action="get" key="key"`
|
|
90
|
+
3. Update: `mcp__sqlew__decision action="set" key="key" value="new_value"`
|
|
91
|
+
4. Show before/after
|
|
92
|
+
|
|
93
|
+
### 5. Execute Intent
|
|
94
|
+
**Keywords**: execute, run, do, proceed, continue, finish
|
|
95
|
+
|
|
96
|
+
**Japanese Keywords**: 実行, 進めて, 続けて, やって
|
|
97
|
+
|
|
98
|
+
**Action**:
|
|
99
|
+
1. Get pending tasks: `mcp__sqlew__task action="list" status="pending"`
|
|
100
|
+
2. Confirm with user before execution
|
|
101
|
+
3. Launch parallel subagents for each task using Task tool
|
|
102
|
+
4. Update completed tasks to "done"
|
|
103
|
+
|
|
104
|
+
### 6. Task Creation Intent (CHECK LAST - explicit creation only)
|
|
105
|
+
**Keywords**: create task, make task, breakdown, plan tasks, generate tasks
|
|
106
|
+
|
|
107
|
+
**Japanese Keywords**: タスク作成, タスクを作って, 洗い出し, タスク化
|
|
108
|
+
|
|
109
|
+
**IMPORTANT**: Only trigger this if there's an EXPLICIT creation verb. Do NOT trigger for:
|
|
110
|
+
- "remaining tasks" / "残タスク" → List/Status
|
|
111
|
+
- "task list" / "タスク一覧" → List/Status
|
|
112
|
+
- "show tasks" / "タスクを見せて" → List/Status
|
|
113
|
+
|
|
114
|
+
**Action**:
|
|
115
|
+
1. Read current plan file if exists
|
|
116
|
+
2. Parse plan into tasks
|
|
117
|
+
3. `mcp__sqlew__task action="create_batch" tasks=[...]`
|
|
118
|
+
4. Confirm what was created
|
|
119
|
+
|
|
120
|
+
---
|
|
121
|
+
|
|
122
|
+
## Parallel Task Execution
|
|
123
|
+
|
|
124
|
+
When executing remaining tasks:
|
|
125
|
+
|
|
126
|
+
```
|
|
127
|
+
For each pending task:
|
|
128
|
+
1. Use Task tool with subagent_type="general-purpose"
|
|
129
|
+
2. Provide task description as prompt
|
|
130
|
+
3. Wait for completion
|
|
131
|
+
4. Update task status to "done"
|
|
132
|
+
```
|
|
133
|
+
|
|
134
|
+
Launch multiple Task tools in a single message for parallel execution.
|
|
135
|
+
|
|
136
|
+
---
|
|
137
|
+
|
|
138
|
+
## Response Guidelines
|
|
139
|
+
|
|
140
|
+
- Be concise and actionable
|
|
141
|
+
- Always show what was done
|
|
142
|
+
- Suggest logical next step
|
|
143
|
+
- Use bullet points for clarity
|
|
144
|
+
- If uncertain about intent, ask for clarification
|
|
@@ -0,0 +1,55 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: sqlew-plan-guidance
|
|
3
|
+
description: |
|
|
4
|
+
Quick reference for sqlew MCP tools.
|
|
5
|
+
Provides usage patterns for Plan mode integration.
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
## Quick Reference
|
|
9
|
+
|
|
10
|
+
### Research (Check Existing Context)
|
|
11
|
+
|
|
12
|
+
```typescript
|
|
13
|
+
mcp__sqlew__suggest action="by_tags" tags=["tag"]
|
|
14
|
+
mcp__sqlew__decision action="search_tags" tags=["tag"]
|
|
15
|
+
mcp__sqlew__task action="list" status="in_progress"
|
|
16
|
+
```
|
|
17
|
+
|
|
18
|
+
### Decision Recording
|
|
19
|
+
|
|
20
|
+
```typescript
|
|
21
|
+
mcp__sqlew__decision action="set"
|
|
22
|
+
key="decision-key"
|
|
23
|
+
value="chosen approach"
|
|
24
|
+
rationale="why this decision was made"
|
|
25
|
+
alternatives_considered="what other options were evaluated"
|
|
26
|
+
tradeoffs="benefits and drawbacks"
|
|
27
|
+
```
|
|
28
|
+
|
|
29
|
+
### Task Creation
|
|
30
|
+
|
|
31
|
+
```typescript
|
|
32
|
+
mcp__sqlew__task action="create_batch" tasks=[
|
|
33
|
+
{ title: "Task title", layer: "business", priority: 3, file_actions: [...] }
|
|
34
|
+
]
|
|
35
|
+
```
|
|
36
|
+
|
|
37
|
+
### Constraint Management
|
|
38
|
+
|
|
39
|
+
```typescript
|
|
40
|
+
mcp__sqlew__constraint action="add"
|
|
41
|
+
category="architecture"
|
|
42
|
+
description="rule description"
|
|
43
|
+
priority=3
|
|
44
|
+
```
|
|
45
|
+
|
|
46
|
+
## Tool Selection Guide
|
|
47
|
+
|
|
48
|
+
| Purpose | Tool | Action |
|
|
49
|
+
|---------|------|--------|
|
|
50
|
+
| Find related decisions | suggest | by_tags, by_key |
|
|
51
|
+
| Check for duplicates | suggest | check_duplicate |
|
|
52
|
+
| Record decision | decision | set |
|
|
53
|
+
| Create tasks | task | create, create_batch |
|
|
54
|
+
| Add constraint | constraint | add |
|
|
55
|
+
| List tasks | task | list |
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"minimal-generator.d.ts","sourceRoot":"","sources":["../../src/config/minimal-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,
|
|
1
|
+
{"version":3,"file":"minimal-generator.d.ts","sourceRoot":"","sources":["../../src/config/minimal-generator.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAKH;;;;GAIG;AACH,wBAAgB,qBAAqB,IAAI,MAAM,CA0E9C;AAED;;;;;GAKG;AACH,wBAAgB,8BAA8B,CAAC,WAAW,GAAE,MAAsB,GAAG,OAAO,CAmB3F;AAED;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,WAAW,GAAE,MAAsB,GAAG,MAAM,CAEzE"}
|
|
@@ -10,97 +10,78 @@ import { join, dirname } from 'path';
|
|
|
10
10
|
* @returns TOML content string
|
|
11
11
|
*/
|
|
12
12
|
export function generateMinimalConfig() {
|
|
13
|
-
return `# sqlew Minimal Configuration
|
|
14
|
-
# Generated automatically - edit as needed
|
|
15
|
-
# Full example: .sqlew/config.example.toml
|
|
16
|
-
# Documentation: https://github.com/sin5ddd/mcp-sqlew
|
|
17
|
-
|
|
18
|
-
# ============================================================================
|
|
19
|
-
# Specialized Agents Settings
|
|
20
|
-
# ============================================================================
|
|
21
|
-
[agents]
|
|
22
|
-
# Which specialized agents to install when running: npx sqlew-init-agents
|
|
23
|
-
# Set to false to skip agents you don't need (reduces token consumption)
|
|
24
|
-
|
|
25
|
-
# Scrum Master: Multi-agent coordination, task management, sprint planning
|
|
26
|
-
# Token cost: ~12KB per conversation when loaded in Claude Code
|
|
27
|
-
scrum_master = true
|
|
28
|
-
|
|
29
|
-
# Researcher: Query decisions, analyze patterns, investigate context
|
|
30
|
-
# Token cost: ~14KB per conversation when loaded in Claude Code
|
|
31
|
-
researcher = true
|
|
32
|
-
|
|
33
|
-
# Architect: Document decisions, enforce constraints, maintain standards
|
|
34
|
-
# Token cost: ~20KB per conversation when loaded in Claude Code
|
|
35
|
-
architect = true
|
|
36
|
-
|
|
37
|
-
# Example: Minimal installation (only Scrum Master for task management)
|
|
38
|
-
# [agents]
|
|
39
|
-
# scrum_master = true
|
|
40
|
-
# researcher = false
|
|
41
|
-
# architect = false
|
|
42
|
-
|
|
43
|
-
# ============================================================================
|
|
44
|
-
# Slash Commands Settings
|
|
45
|
-
# ============================================================================
|
|
46
|
-
[commands]
|
|
47
|
-
# Which slash commands to install on server startup
|
|
48
|
-
# Set to false to skip commands you don't need
|
|
49
|
-
|
|
50
|
-
# /
|
|
51
|
-
|
|
52
|
-
|
|
53
|
-
#
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
#
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
#
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
#
|
|
66
|
-
|
|
67
|
-
|
|
68
|
-
#
|
|
69
|
-
|
|
70
|
-
#
|
|
71
|
-
#
|
|
72
|
-
#
|
|
73
|
-
#
|
|
74
|
-
#
|
|
75
|
-
#
|
|
76
|
-
|
|
77
|
-
#
|
|
78
|
-
#
|
|
79
|
-
|
|
80
|
-
|
|
81
|
-
#
|
|
82
|
-
# #
|
|
83
|
-
#
|
|
84
|
-
# #
|
|
85
|
-
# message_hours = 24
|
|
86
|
-
# # File change history retention in days
|
|
87
|
-
# file_history_days = 7
|
|
88
|
-
|
|
89
|
-
# [tasks]
|
|
90
|
-
# # Auto-archive done tasks after N days
|
|
91
|
-
# auto_archive_done_days = 2
|
|
92
|
-
# # Stale detection threshold for in_progress tasks (hours)
|
|
93
|
-
# stale_hours_in_progress = 2
|
|
94
|
-
# # Stale detection threshold for waiting_review tasks (hours)
|
|
95
|
-
# stale_hours_waiting_review = 24
|
|
96
|
-
# # Enable automatic stale detection
|
|
97
|
-
# auto_stale_enabled = true
|
|
98
|
-
|
|
99
|
-
# [debug]
|
|
100
|
-
# # Debug log file path (optional)
|
|
101
|
-
# # log_path = ".sqlew/debug.log"
|
|
102
|
-
# # Log level: "error", "warn", "info", "debug"
|
|
103
|
-
# # log_level = "info"
|
|
13
|
+
return `# sqlew Minimal Configuration
|
|
14
|
+
# Generated automatically - edit as needed
|
|
15
|
+
# Full example: .sqlew/config.example.toml
|
|
16
|
+
# Documentation: https://github.com/sin5ddd/mcp-sqlew
|
|
17
|
+
|
|
18
|
+
# ============================================================================
|
|
19
|
+
# Specialized Agents Settings
|
|
20
|
+
# ============================================================================
|
|
21
|
+
[agents]
|
|
22
|
+
# Which specialized agents to install when running: npx sqlew-init-agents
|
|
23
|
+
# Set to false to skip agents you don't need (reduces token consumption)
|
|
24
|
+
|
|
25
|
+
# Scrum Master: Multi-agent coordination, task management, sprint planning
|
|
26
|
+
# Token cost: ~12KB per conversation when loaded in Claude Code
|
|
27
|
+
scrum_master = true
|
|
28
|
+
|
|
29
|
+
# Researcher: Query decisions, analyze patterns, investigate context
|
|
30
|
+
# Token cost: ~14KB per conversation when loaded in Claude Code
|
|
31
|
+
researcher = true
|
|
32
|
+
|
|
33
|
+
# Architect: Document decisions, enforce constraints, maintain standards
|
|
34
|
+
# Token cost: ~20KB per conversation when loaded in Claude Code
|
|
35
|
+
architect = true
|
|
36
|
+
|
|
37
|
+
# Example: Minimal installation (only Scrum Master for task management)
|
|
38
|
+
# [agents]
|
|
39
|
+
# scrum_master = true
|
|
40
|
+
# researcher = false
|
|
41
|
+
# architect = false
|
|
42
|
+
|
|
43
|
+
# ============================================================================
|
|
44
|
+
# Slash Commands Settings
|
|
45
|
+
# ============================================================================
|
|
46
|
+
[commands]
|
|
47
|
+
# Which slash commands to install on server startup
|
|
48
|
+
# Set to false to skip commands you don't need
|
|
49
|
+
|
|
50
|
+
# /sqlew: Unified natural language interface for decisions and tasks
|
|
51
|
+
# Usage: /sqlew <what you want to do>
|
|
52
|
+
# Examples:
|
|
53
|
+
# /sqlew show remaining tasks
|
|
54
|
+
# /sqlew search for auth decisions
|
|
55
|
+
# /sqlew record that we use PostgreSQL 15
|
|
56
|
+
sqlew = true
|
|
57
|
+
|
|
58
|
+
# ============================================================================
|
|
59
|
+
# Other Settings (Optional - uncomment to customize)
|
|
60
|
+
# ============================================================================
|
|
61
|
+
|
|
62
|
+
# [autodelete]
|
|
63
|
+
# # Skip weekends when calculating retention periods
|
|
64
|
+
# ignore_weekend = false
|
|
65
|
+
# # Message retention period in hours
|
|
66
|
+
# message_hours = 24
|
|
67
|
+
# # File change history retention in days
|
|
68
|
+
# file_history_days = 7
|
|
69
|
+
|
|
70
|
+
# [tasks]
|
|
71
|
+
# # Auto-archive done tasks after N days
|
|
72
|
+
# auto_archive_done_days = 2
|
|
73
|
+
# # Stale detection threshold for in_progress tasks (hours)
|
|
74
|
+
# stale_hours_in_progress = 2
|
|
75
|
+
# # Stale detection threshold for waiting_review tasks (hours)
|
|
76
|
+
# stale_hours_waiting_review = 24
|
|
77
|
+
# # Enable automatic stale detection
|
|
78
|
+
# auto_stale_enabled = true
|
|
79
|
+
|
|
80
|
+
# [debug]
|
|
81
|
+
# # Debug log file path (optional)
|
|
82
|
+
# # log_path = ".sqlew/debug.log"
|
|
83
|
+
# # Log level: "error", "warn", "info", "debug"
|
|
84
|
+
# # log_level = "info"
|
|
104
85
|
`;
|
|
105
86
|
}
|
|
106
87
|
/**
|