@mind-fold/open-flow 0.1.14 → 0.1.15

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.
@@ -1 +1 @@
1
- {"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/configurators/templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkBH,MAAM,WAAW,gBAAgB;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACtB;AAED,wBAAgB,mBAAmB,IAAI,gBAAgB,CAgBtD"}
1
+ {"version":3,"file":"templates.d.ts","sourceRoot":"","sources":["../../src/configurators/templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmBH,MAAM,WAAW,gBAAgB;IAChC,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;CACtB;AAED,wBAAgB,mBAAmB,IAAI,gBAAgB,CAiBtD"}
@@ -2,7 +2,7 @@
2
2
  * Short command templates for AI assistants
3
3
  * These are the core commands that enable AI-assisted development workflow
4
4
  */
5
- import { initAgentTemplate, checkFrontendTemplate, checkBackendTemplate, recordAgentFlowTemplate, recordQuestionTemplate, onboardDeveloperTemplate, generateFrontendStructureTemplate, generateBackendStructureTemplate, beforeFrontendDevTemplate, beforeBackendDevTemplate, updateFrontendStructureTemplate, updateBackendStructureTemplate, createCommandTemplate, } from "../templates/commands/index.js";
5
+ import { initAgentTemplate, checkFrontendTemplate, checkBackendTemplate, recordAgentFlowTemplate, recordQuestionTemplate, onboardDeveloperTemplate, generateFrontendStructureTemplate, generateBackendStructureTemplate, beforeFrontendDevTemplate, beforeBackendDevTemplate, updateFrontendStructureTemplate, updateBackendStructureTemplate, createCommandTemplate, integrateSkillTemplate, } from "../templates/commands/index.js";
6
6
  export function getCommandTemplates() {
7
7
  return {
8
8
  "init-agent": initAgentTemplate,
@@ -18,6 +18,7 @@ export function getCommandTemplates() {
18
18
  "update-frontend-structure": updateFrontendStructureTemplate,
19
19
  "update-backend-structure": updateBackendStructureTemplate,
20
20
  "create-command": createCommandTemplate,
21
+ "integrate-skill": integrateSkillTemplate,
21
22
  };
22
23
  }
23
24
  //# sourceMappingURL=templates.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/configurators/templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACN,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,iCAAiC,EACjC,gCAAgC,EAChC,yBAAyB,EACzB,wBAAwB,EACxB,+BAA+B,EAC/B,8BAA8B,EAC9B,qBAAqB,GACrB,MAAM,gCAAgC,CAAC;AAMxC,MAAM,UAAU,mBAAmB;IAClC,OAAO;QACN,YAAY,EAAE,iBAAiB;QAC/B,gBAAgB,EAAE,qBAAqB;QACvC,eAAe,EAAE,oBAAoB;QACrC,mBAAmB,EAAE,uBAAuB;QAC5C,iBAAiB,EAAE,sBAAsB;QACzC,mBAAmB,EAAE,wBAAwB;QAC7C,6BAA6B,EAAE,iCAAiC;QAChE,4BAA4B,EAAE,gCAAgC;QAC9D,qBAAqB,EAAE,yBAAyB;QAChD,oBAAoB,EAAE,wBAAwB;QAC9C,2BAA2B,EAAE,+BAA+B;QAC5D,0BAA0B,EAAE,8BAA8B;QAC1D,gBAAgB,EAAE,qBAAqB;KACvC,CAAC;AACH,CAAC"}
1
+ {"version":3,"file":"templates.js","sourceRoot":"","sources":["../../src/configurators/templates.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACN,iBAAiB,EACjB,qBAAqB,EACrB,oBAAoB,EACpB,uBAAuB,EACvB,sBAAsB,EACtB,wBAAwB,EACxB,iCAAiC,EACjC,gCAAgC,EAChC,yBAAyB,EACzB,wBAAwB,EACxB,+BAA+B,EAC/B,8BAA8B,EAC9B,qBAAqB,EACrB,sBAAsB,GACtB,MAAM,gCAAgC,CAAC;AAMxC,MAAM,UAAU,mBAAmB;IAClC,OAAO;QACN,YAAY,EAAE,iBAAiB;QAC/B,gBAAgB,EAAE,qBAAqB;QACvC,eAAe,EAAE,oBAAoB;QACrC,mBAAmB,EAAE,uBAAuB;QAC5C,iBAAiB,EAAE,sBAAsB;QACzC,mBAAmB,EAAE,wBAAwB;QAC7C,6BAA6B,EAAE,iCAAiC;QAChE,4BAA4B,EAAE,gCAAgC;QAC9D,qBAAqB,EAAE,yBAAyB;QAChD,oBAAoB,EAAE,wBAAwB;QAC9C,2BAA2B,EAAE,+BAA+B;QAC5D,0BAA0B,EAAE,8BAA8B;QAC1D,gBAAgB,EAAE,qBAAqB;QACvC,iBAAiB,EAAE,sBAAsB;KACzC,CAAC;AACH,CAAC"}
@@ -15,4 +15,5 @@ export declare const beforeBackendDevTemplate: string;
15
15
  export declare const updateFrontendStructureTemplate: string;
16
16
  export declare const updateBackendStructureTemplate: string;
17
17
  export declare const createCommandTemplate: string;
18
+ export declare const integrateSkillTemplate: string;
18
19
  //# sourceMappingURL=index.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/commands/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,eAAO,MAAM,iBAAiB,QAAgC,CAAC;AAC/D,eAAO,MAAM,qBAAqB,QAAoC,CAAC;AACvE,eAAO,MAAM,oBAAoB,QAAmC,CAAC;AACrE,eAAO,MAAM,uBAAuB,QAAuC,CAAC;AAC5E,eAAO,MAAM,sBAAsB,QAAqC,CAAC;AACzE,eAAO,MAAM,wBAAwB,QAAuC,CAAC;AAC7E,eAAO,MAAM,iCAAiC,QAE7C,CAAC;AACF,eAAO,MAAM,gCAAgC,QAE5C,CAAC;AACF,eAAO,MAAM,yBAAyB,QAAyC,CAAC;AAChF,eAAO,MAAM,wBAAwB,QAAwC,CAAC;AAC9E,eAAO,MAAM,+BAA+B,QAE3C,CAAC;AACF,eAAO,MAAM,8BAA8B,QAE1C,CAAC;AACF,eAAO,MAAM,qBAAqB,QAAoC,CAAC"}
1
+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/templates/commands/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,eAAO,MAAM,iBAAiB,QAAgC,CAAC;AAC/D,eAAO,MAAM,qBAAqB,QAAoC,CAAC;AACvE,eAAO,MAAM,oBAAoB,QAAmC,CAAC;AACrE,eAAO,MAAM,uBAAuB,QAAuC,CAAC;AAC5E,eAAO,MAAM,sBAAsB,QAAqC,CAAC;AACzE,eAAO,MAAM,wBAAwB,QAAuC,CAAC;AAC7E,eAAO,MAAM,iCAAiC,QAE7C,CAAC;AACF,eAAO,MAAM,gCAAgC,QAE5C,CAAC;AACF,eAAO,MAAM,yBAAyB,QAAyC,CAAC;AAChF,eAAO,MAAM,wBAAwB,QAAwC,CAAC;AAC9E,eAAO,MAAM,+BAA+B,QAE3C,CAAC;AACF,eAAO,MAAM,8BAA8B,QAE1C,CAAC;AACF,eAAO,MAAM,qBAAqB,QAAoC,CAAC;AACvE,eAAO,MAAM,sBAAsB,QAAqC,CAAC"}
@@ -16,4 +16,5 @@ export const beforeBackendDevTemplate = readCommand("before-backend-dev.txt");
16
16
  export const updateFrontendStructureTemplate = readCommand("update-frontend-structure.txt");
17
17
  export const updateBackendStructureTemplate = readCommand("update-backend-structure.txt");
18
18
  export const createCommandTemplate = readCommand("create-command.txt");
19
+ export const integrateSkillTemplate = readCommand("integrate-skill.txt");
19
20
  //# sourceMappingURL=index.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/commands/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAAC,gBAAgB,CAAC,CAAC;AAC/D,MAAM,CAAC,MAAM,qBAAqB,GAAG,WAAW,CAAC,oBAAoB,CAAC,CAAC;AACvE,MAAM,CAAC,MAAM,oBAAoB,GAAG,WAAW,CAAC,mBAAmB,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,uBAAuB,GAAG,WAAW,CAAC,uBAAuB,CAAC,CAAC;AAC5E,MAAM,CAAC,MAAM,sBAAsB,GAAG,WAAW,CAAC,qBAAqB,CAAC,CAAC;AACzE,MAAM,CAAC,MAAM,wBAAwB,GAAG,WAAW,CAAC,uBAAuB,CAAC,CAAC;AAC7E,MAAM,CAAC,MAAM,iCAAiC,GAAG,WAAW,CAC3D,iCAAiC,CACjC,CAAC;AACF,MAAM,CAAC,MAAM,gCAAgC,GAAG,WAAW,CAC1D,gCAAgC,CAChC,CAAC;AACF,MAAM,CAAC,MAAM,yBAAyB,GAAG,WAAW,CAAC,yBAAyB,CAAC,CAAC;AAChF,MAAM,CAAC,MAAM,wBAAwB,GAAG,WAAW,CAAC,wBAAwB,CAAC,CAAC;AAC9E,MAAM,CAAC,MAAM,+BAA+B,GAAG,WAAW,CACzD,+BAA+B,CAC/B,CAAC;AACF,MAAM,CAAC,MAAM,8BAA8B,GAAG,WAAW,CACxD,8BAA8B,CAC9B,CAAC;AACF,MAAM,CAAC,MAAM,qBAAqB,GAAG,WAAW,CAAC,oBAAoB,CAAC,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/templates/commands/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,MAAM,CAAC,MAAM,iBAAiB,GAAG,WAAW,CAAC,gBAAgB,CAAC,CAAC;AAC/D,MAAM,CAAC,MAAM,qBAAqB,GAAG,WAAW,CAAC,oBAAoB,CAAC,CAAC;AACvE,MAAM,CAAC,MAAM,oBAAoB,GAAG,WAAW,CAAC,mBAAmB,CAAC,CAAC;AACrE,MAAM,CAAC,MAAM,uBAAuB,GAAG,WAAW,CAAC,uBAAuB,CAAC,CAAC;AAC5E,MAAM,CAAC,MAAM,sBAAsB,GAAG,WAAW,CAAC,qBAAqB,CAAC,CAAC;AACzE,MAAM,CAAC,MAAM,wBAAwB,GAAG,WAAW,CAAC,uBAAuB,CAAC,CAAC;AAC7E,MAAM,CAAC,MAAM,iCAAiC,GAAG,WAAW,CAC3D,iCAAiC,CACjC,CAAC;AACF,MAAM,CAAC,MAAM,gCAAgC,GAAG,WAAW,CAC1D,gCAAgC,CAChC,CAAC;AACF,MAAM,CAAC,MAAM,yBAAyB,GAAG,WAAW,CAAC,yBAAyB,CAAC,CAAC;AAChF,MAAM,CAAC,MAAM,wBAAwB,GAAG,WAAW,CAAC,wBAAwB,CAAC,CAAC;AAC9E,MAAM,CAAC,MAAM,+BAA+B,GAAG,WAAW,CACzD,+BAA+B,CAC/B,CAAC;AACF,MAAM,CAAC,MAAM,8BAA8B,GAAG,WAAW,CACxD,8BAA8B,CAC9B,CAAC;AACF,MAAM,CAAC,MAAM,qBAAqB,GAAG,WAAW,CAAC,oBAAoB,CAAC,CAAC;AACvE,MAAM,CAAC,MAAM,sBAAsB,GAAG,WAAW,CAAC,qBAAqB,CAAC,CAAC"}
@@ -0,0 +1,219 @@
1
+ # Integrate Claude Skill into Project Guidelines
2
+
3
+ Adapt and integrate a Claude global skill into your project's development guidelines (not directly into project code).
4
+
5
+ ## Usage
6
+
7
+ ```
8
+ /integrate-skill <skill-name>
9
+ ```
10
+
11
+ **Examples**:
12
+ ```
13
+ /integrate-skill frontend-design
14
+ /integrate-skill mcp-builder
15
+ ```
16
+
17
+ ## Core Principle
18
+
19
+ > ⚠️ **Important**: The goal of skill integration is to update **development guidelines**, not to generate project code directly.
20
+ >
21
+ > - Guidelines content → Write to `workflow/structure/{target}/doc.md`
22
+ > - Code examples → Place in `workflow/structure/{target}/examples/skills/<skill-name>/`
23
+ > - Example files → Use `.template` suffix (e.g., `component.tsx.template`) to avoid IDE errors
24
+ >
25
+ > Where `{target}` is `frontend` or `backend`, determined by skill type.
26
+
27
+ ## Execution Steps
28
+
29
+ ### 1. Read Skill Content
30
+
31
+ ```bash
32
+ openskills read <skill-name>
33
+ ```
34
+
35
+ If the skill doesn't exist, prompt user to check available skills:
36
+ ```bash
37
+ # Available skills are listed in AGENTS.md under <available_skills>
38
+ ```
39
+
40
+ ### 2. Determine Integration Target
41
+
42
+ Based on skill type, determine which guidelines to update:
43
+
44
+ | Skill Category | Integration Target |
45
+ |----------------|-------------------|
46
+ | UI/Frontend (`frontend-design`, `web-artifacts-builder`) | `workflow/structure/frontend/` |
47
+ | Backend/API (`mcp-builder`) | `workflow/structure/backend/` |
48
+ | Documentation (`doc-coauthoring`, `docx`, `pdf`) | `workflow/` or create dedicated guidelines |
49
+ | Testing (`webapp-testing`) | `workflow/structure/frontend/` (E2E) |
50
+
51
+ ### 3. Analyze Skill Content
52
+
53
+ Extract from the skill:
54
+ - **Core concepts**: How the skill works and key concepts
55
+ - **Best practices**: Recommended approaches
56
+ - **Code patterns**: Reusable code templates
57
+ - **Caveats**: Common issues and solutions
58
+
59
+ ### 4. Execute Integration
60
+
61
+ #### 4.1 Update Guidelines Document
62
+
63
+ Add a new section to the corresponding `doc.md`:
64
+
65
+ ```markdown
66
+ @@@section:skill-<skill-name>
67
+ ## 🎨 <Skill Name> Integration Guide
68
+
69
+ ### Overview
70
+ [Core functionality and use cases of the skill]
71
+
72
+ ### Project Adaptation
73
+ [How to use this skill in the current project]
74
+
75
+ ### Usage Steps
76
+ 1. [Step 1]
77
+ 2. [Step 2]
78
+
79
+ ### Caveats
80
+ - [Project-specific constraints]
81
+ - [Differences from default behavior]
82
+
83
+ ### Reference Examples
84
+ See `examples/skills/<skill-name>/`
85
+
86
+ @@@/section:skill-<skill-name>
87
+ ```
88
+
89
+ #### 4.2 Create Examples Directory (if code examples exist)
90
+
91
+ ```bash
92
+ # Directory structure ({target} = frontend or backend)
93
+ workflow/structure/{target}/
94
+ ├── doc.md # Add skill-related section
95
+ ├── index.md # Update index
96
+ └── examples/
97
+ └── skills/
98
+ └── <skill-name>/
99
+ ├── README.md # Example documentation
100
+ ├── example-1.ts.template # Code example (use .template suffix)
101
+ └── example-2.tsx.template
102
+ ```
103
+
104
+ **File naming conventions**:
105
+ - Code files: `<name>.<ext>.template` (e.g., `component.tsx.template`)
106
+ - Config files: `<name>.config.template` (e.g., `tailwind.config.template`)
107
+ - Documentation: `README.md` (normal suffix)
108
+
109
+ #### 4.3 Update Index File
110
+
111
+ Add to the Quick Navigation table in `index.md`:
112
+
113
+ ```markdown
114
+ | <Skill-related task> | <Section name> | `skill-<skill-name>` |
115
+ ```
116
+
117
+ ### 5. Generate Integration Report
118
+
119
+ ---
120
+
121
+ ## Skill Integration Report: `<skill-name>`
122
+
123
+ ### 📋 Overview
124
+ - **Skill description**: [Functionality description]
125
+ - **Integration target**: `workflow/structure/{target}/`
126
+
127
+ ### 🔧 Tech Stack Compatibility
128
+
129
+ | Skill Requirement | Project Status | Compatibility |
130
+ |-------------------|----------------|---------------|
131
+ | [Tech 1] | [Project tech] | ✅/⚠️/❌ |
132
+
133
+ ### 📁 Integration Locations
134
+
135
+ | Type | Path |
136
+ |------|------|
137
+ | Guidelines doc | `workflow/structure/{target}/doc.md` (section: `skill-<name>`) |
138
+ | Code examples | `workflow/structure/{target}/examples/skills/<name>/` |
139
+ | Index update | `workflow/structure/{target}/index.md` |
140
+
141
+ > `{target}` = `frontend` or `backend`
142
+
143
+ ### 📦 Dependencies (if needed)
144
+
145
+ ```bash
146
+ # Install required dependencies (adjust for your package manager)
147
+ npm install <package>
148
+ # or
149
+ pnpm add <package>
150
+ # or
151
+ yarn add <package>
152
+ ```
153
+
154
+ ### ✅ Completed Changes
155
+
156
+ - [ ] Added `@@@section:skill-<name>` section to `doc.md`
157
+ - [ ] Added index entry to `index.md`
158
+ - [ ] Created example files in `examples/skills/<name>/`
159
+ - [ ] Example files use `.template` suffix
160
+
161
+ ### 📚 Related Guidelines
162
+
163
+ - [Existing related section IDs]
164
+
165
+ ---
166
+
167
+ ## 6. Optional: Create Usage Command
168
+
169
+ If this skill is frequently used, create a shortcut command:
170
+
171
+ ```bash
172
+ /create-command use-<skill-name> Use <skill-name> skill following project guidelines
173
+ ```
174
+
175
+ ## Common Skill Integration Reference
176
+
177
+ | Skill | Integration Target | Examples Directory |
178
+ |-------|-------------------|-------------------|
179
+ | `frontend-design` | `frontend` | `examples/skills/frontend-design/` |
180
+ | `mcp-builder` | `backend` | `examples/skills/mcp-builder/` |
181
+ | `webapp-testing` | `frontend` | `examples/skills/webapp-testing/` |
182
+ | `doc-coauthoring` | `workflow/` | N/A (documentation workflow only) |
183
+
184
+ ## Example: Integrating `mcp-builder` Skill
185
+
186
+ ### Directory Structure
187
+
188
+ ```
189
+ workflow/structure/backend/
190
+ ├── doc.md # Add MCP section
191
+ ├── index.md # Add index entry
192
+ └── examples/
193
+ └── skills/
194
+ └── mcp-builder/
195
+ ├── README.md
196
+ ├── server.ts.template
197
+ ├── tools.ts.template
198
+ └── types.ts.template
199
+ ```
200
+
201
+ ### New Section in doc.md
202
+
203
+ ```markdown
204
+ @@@section:skill-mcp-builder
205
+ ## 🔌 MCP Server Development Guide
206
+
207
+ ### Overview
208
+ Create LLM-callable tool services using MCP (Model Context Protocol).
209
+
210
+ ### Project Adaptation
211
+ - Place services in a dedicated directory
212
+ - Follow existing TypeScript and type definition conventions
213
+ - Use project's logging system
214
+
215
+ ### Reference Examples
216
+ See `examples/skills/mcp-builder/`
217
+
218
+ @@@/section:skill-mcp-builder
219
+ ```
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mind-fold/open-flow",
3
- "version": "0.1.14",
3
+ "version": "0.1.15",
4
4
  "description": "AI-assisted development workflow initializer for Cursor, Claude Code and more",
5
5
  "type": "module",
6
6
  "main": "./dist/index.js",