@ckelsoe/prompt-architect 3.0.2 → 3.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 (76) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/.claude-plugin/plugin.json +1 -1
  3. package/CHANGELOG.md +264 -264
  4. package/LICENSE +21 -21
  5. package/README.md +1064 -1184
  6. package/adapters/README.md +75 -267
  7. package/adapters/for-windsurf.md +136 -136
  8. package/adapters/system-prompt.md +243 -243
  9. package/package.json +139 -138
  10. package/scripts/build-skill.js +64 -0
  11. package/scripts/install.js +4 -54
  12. package/scripts/test.js +205 -213
  13. package/scripts/validate-skill.js +350 -350
  14. package/skills/prompt-architect/SKILL.md +343 -331
  15. package/skills/prompt-architect/assets/templates/ape_template.txt +5 -5
  16. package/skills/prompt-architect/assets/templates/bab_template.txt +15 -15
  17. package/skills/prompt-architect/assets/templates/broke_template.txt +15 -15
  18. package/skills/prompt-architect/assets/templates/cai-critique-revise_template.txt +18 -18
  19. package/skills/prompt-architect/assets/templates/care_template.txt +16 -16
  20. package/skills/prompt-architect/assets/templates/chain-of-density_template.txt +46 -46
  21. package/skills/prompt-architect/assets/templates/chain-of-thought_template.txt +49 -49
  22. package/skills/prompt-architect/assets/templates/co-star_template.txt +17 -17
  23. package/skills/prompt-architect/assets/templates/crispe_template.txt +14 -14
  24. package/skills/prompt-architect/assets/templates/ctf_template.txt +15 -15
  25. package/skills/prompt-architect/assets/templates/devils-advocate_template.txt +25 -25
  26. package/skills/prompt-architect/assets/templates/hybrid_template.txt +101 -101
  27. package/skills/prompt-architect/assets/templates/least-to-most_template.txt +16 -16
  28. package/skills/prompt-architect/assets/templates/plan-and-solve_template.txt +7 -7
  29. package/skills/prompt-architect/assets/templates/pre-mortem_template.txt +27 -27
  30. package/skills/prompt-architect/assets/templates/race_template.txt +19 -19
  31. package/skills/prompt-architect/assets/templates/rcot_template.txt +31 -31
  32. package/skills/prompt-architect/assets/templates/react_template.txt +27 -27
  33. package/skills/prompt-architect/assets/templates/reverse-role_template.txt +11 -11
  34. package/skills/prompt-architect/assets/templates/rise-ie_template.txt +23 -23
  35. package/skills/prompt-architect/assets/templates/rise-ix_template.txt +28 -28
  36. package/skills/prompt-architect/assets/templates/risen_template.txt +21 -21
  37. package/skills/prompt-architect/assets/templates/rpef_template.txt +26 -26
  38. package/skills/prompt-architect/assets/templates/rtf_template.txt +13 -13
  39. package/skills/prompt-architect/assets/templates/self-refine_template.txt +16 -16
  40. package/skills/prompt-architect/assets/templates/skeleton-of-thought_template.txt +15 -15
  41. package/skills/prompt-architect/assets/templates/step-back_template.txt +10 -10
  42. package/skills/prompt-architect/assets/templates/tidd-ec_template.txt +45 -45
  43. package/skills/prompt-architect/assets/templates/tree-of-thought_template.txt +30 -30
  44. package/skills/prompt-architect/references/frameworks/ape.md +200 -200
  45. package/skills/prompt-architect/references/frameworks/bab.md +242 -242
  46. package/skills/prompt-architect/references/frameworks/broke.md +242 -242
  47. package/skills/prompt-architect/references/frameworks/cai-critique-revise.md +230 -230
  48. package/skills/prompt-architect/references/frameworks/care.md +235 -235
  49. package/skills/prompt-architect/references/frameworks/chain-of-density.md +479 -479
  50. package/skills/prompt-architect/references/frameworks/chain-of-thought.md +424 -424
  51. package/skills/prompt-architect/references/frameworks/co-star.md +256 -256
  52. package/skills/prompt-architect/references/frameworks/crispe.md +253 -253
  53. package/skills/prompt-architect/references/frameworks/ctf.md +207 -207
  54. package/skills/prompt-architect/references/frameworks/devils-advocate.md +206 -206
  55. package/skills/prompt-architect/references/frameworks/least-to-most.md +226 -226
  56. package/skills/prompt-architect/references/frameworks/plan-and-solve.md +210 -210
  57. package/skills/prompt-architect/references/frameworks/pre-mortem.md +197 -197
  58. package/skills/prompt-architect/references/frameworks/race.md +243 -243
  59. package/skills/prompt-architect/references/frameworks/rcot.md +203 -203
  60. package/skills/prompt-architect/references/frameworks/react.md +304 -304
  61. package/skills/prompt-architect/references/frameworks/reverse-role.md +189 -189
  62. package/skills/prompt-architect/references/frameworks/rise.md +555 -555
  63. package/skills/prompt-architect/references/frameworks/risen.md +297 -297
  64. package/skills/prompt-architect/references/frameworks/rpef.md +195 -195
  65. package/skills/prompt-architect/references/frameworks/rtf.md +358 -358
  66. package/skills/prompt-architect/references/frameworks/self-refine.md +205 -205
  67. package/skills/prompt-architect/references/frameworks/skeleton-of-thought.md +186 -186
  68. package/skills/prompt-architect/references/frameworks/step-back.md +206 -206
  69. package/skills/prompt-architect/references/frameworks/tidd-ec.md +470 -470
  70. package/skills/prompt-architect/references/frameworks/tree-of-thought.md +260 -260
  71. package/skills/prompt-architect/scripts/framework_analyzer.py +807 -807
  72. package/skills/prompt-architect/scripts/prompt_evaluator.py +336 -336
  73. package/adapters/for-cursor.mdc +0 -138
  74. package/adapters/for-gemini-cli.md +0 -70
  75. package/adapters/for-github-copilot.md +0 -141
  76. package/adapters/for-openai-codex-cli.md +0 -158
@@ -1,267 +1,75 @@
1
- # Prompt Architect — Cross-Platform Adapters
2
-
3
- This folder contains ready-to-use versions of the Prompt Architect skill for AI tools beyond those that natively support the [Agent Skills standard](https://agentskills.io).
4
-
5
- Tools that support Agent Skills (Claude Code, Gemini CLI, Cursor, Copilot, and 30+ others) can use the native `skills/prompt-architect/SKILL.md` directly. The adapters here are for tools that need a reformatted version.
6
-
7
- ---
8
-
9
- ## Why adapters exist
10
-
11
- The `skills/prompt-architect/SKILL.md` file follows the [Agent Skills standard](https://agentskills.io) an open format supported by 30+ AI tools. Tools like Claude Code and Gemini CLI can discover and load SKILL.md natively.
12
-
13
- For tools that don't support Agent Skills natively, the adapters solve two problems:
14
- - The YAML frontmatter is removed (some tools render it as raw text)
15
- - File-loading references are replaced with self-contained instructions
16
- - Each adapter is formatted exactly as the target tool expects
17
-
18
- **The framework knowledge (all 27 frameworks, intent categories, clarification questions) is identical across all adapters.** Only the packaging changes.
19
-
20
- ---
21
-
22
- ## What "installing" means for each tool
23
-
24
- | Tool | Where instructions go | Auto-discovered? | How to activate |
25
- |------|----------------------|------------------|-----------------|
26
- | **Claude Code** | `~/.claude/skills/` or `/plugin install` | ✅ Yes — automatic | Ask Claude to improve a prompt |
27
- | **Gemini CLI** | `~/.gemini/skills/` or `gemini skills install` | ✅ Yes — native Agent Skills | Ask Gemini to improve a prompt |
28
- | **Agent Skills (30+ tools)** | `~/.agents/skills/` | ✅ Yes — universal path | Ask the agent to improve a prompt |
29
- | **OpenAI Codex CLI** | `AGENTS.md` in your project root | ✅ Yes — read per session | Ask Codex to improve a prompt |
30
- | **Cursor** | `.cursor/rules/prompt-architect.mdc` | ✅ Yes — loaded automatically | Ask Cursor to improve a prompt |
31
- | **GitHub Copilot** | `.github/copilot-instructions.md` | ✅ Yes — loaded per workspace | Ask Copilot to improve a prompt |
32
- | **Windsurf** | `.windsurfrules` in your project root | Yes read per session | Ask Windsurf to improve a prompt |
33
- | **Any LLM API / ChatGPT / custom** | Paste into system prompt field | Manual | Call the API / open the chat |
34
-
35
- ---
36
-
37
- ## Adapter files in this folder
38
-
39
- | File | Use with | What to do with it |
40
- |------|----------|--------------------|
41
- | `system-prompt.md` | Any LLM (API, ChatGPT, Gemini, etc.) | Paste contents into the system prompt field |
42
- | `for-gemini-cli.md` | Gemini CLI | Installation guide (native SKILL.md works directly) |
43
- | `for-openai-codex-cli.md` | OpenAI Codex CLI | Copy contents into `AGENTS.md` in your project root |
44
- | `for-cursor.mdc` | Cursor editor | Copy file to `.cursor/rules/prompt-architect.mdc` |
45
- | `for-github-copilot.md` | GitHub Copilot | Copy contents into `.github/copilot-instructions.md` |
46
- | `for-windsurf.md` | Windsurf editor | Copy contents into `.windsurfrules` in your project root |
47
-
48
- ---
49
-
50
- ## Limitations vs. Claude Code
51
-
52
- Claude Code's version has one capability the adapters cannot replicate:
53
-
54
- > **On-demand reference loading**: When Claude Code applies a framework, it can load the detailed 600-800 line reference doc for that specific framework (e.g., `references/frameworks/co-star.md`). This gives it richer examples and selection criteria.
55
-
56
- The adapters work from:
57
- 1. The full intent-based selection system (all 7 categories, all 27 frameworks)
58
- 2. The complete clarification question sets
59
- 3. The LLM's training knowledge of each framework
60
-
61
- For most use cases, this is equivalent. The reference docs add depth for edge cases and complex applications.
62
-
63
- ---
64
-
65
- ## Installation instructions by tool
66
-
67
- ### Claude Code (Plugin System)
68
-
69
- Claude Code now supports plugins with a marketplace. You can install directly:
70
-
71
- ```shell
72
- # Option A: Add the marketplace and install
73
- /plugin marketplace add ckelsoe/prompt-architect
74
- /plugin install prompt-architect@prompt-architect-marketplace
75
-
76
- # Option B: Load directly for testing
77
- claude --plugin-dir /path/to/prompt-architect
78
- ```
79
-
80
- The legacy `npm install -g` method also still works — the interactive installer will set up `~/.claude/skills/`.
81
-
82
- ---
83
-
84
- ### Gemini CLI
85
-
86
- Gemini CLI natively supports Agent Skills — the `SKILL.md` works directly, no adapter needed.
87
-
88
- ```bash
89
- # Option A: Install from GitHub
90
- gemini skills install https://github.com/ckelsoe/prompt-architect.git
91
-
92
- # Option B: Manual copy
93
- cp -r skills/prompt-architect/ ~/.gemini/skills/prompt-architect/
94
-
95
- # Option C: After npm install
96
- gemini skills link "$(npm root -g)/@ckelsoe/prompt-architect/skills/prompt-architect"
97
- ```
98
-
99
- See `adapters/for-gemini-cli.md` for full details.
100
-
101
- ---
102
-
103
- ### OpenAI Codex CLI
104
-
105
- **What is AGENTS.md?**
106
- The Codex CLI reads `AGENTS.md` from your project root at the start of each session. It's the Codex equivalent of Claude Code's `CLAUDE.md` — project-level instructions that shape how the AI behaves.
107
-
108
- **Steps:**
109
- ```bash
110
- # Option A: Create a new AGENTS.md with just this skill
111
- cp /path/to/adapters/for-openai-codex-cli.md ./AGENTS.md
112
-
113
- # Option B: Append to an existing AGENTS.md
114
- cat /path/to/adapters/for-openai-codex-cli.md >> ./AGENTS.md
115
-
116
- # Option C: After npm install
117
- cat node_modules/@ckelsoe/prompt-architect/adapters/for-openai-codex-cli.md >> ./AGENTS.md
118
- ```
119
-
120
- **Verify it's working:**
121
- ```
122
- codex "Help me improve this prompt: write a blog post"
123
- ```
124
- You should see intent detection, framework recommendation, and clarifying questions.
125
-
126
- ---
127
-
128
- ### Cursor
129
-
130
- **What is .cursor/rules/?**
131
- Cursor loads `.mdc` files from `.cursor/rules/` in your project. Each file can apply always or only for specific file patterns. The `prompt-architect.mdc` adapter uses `alwaysApply: false` so it only activates when you ask for prompt help — it won't interfere with normal coding.
132
-
133
- **Steps:**
134
- ```bash
135
- # Create the rules directory if it doesn't exist
136
- mkdir -p .cursor/rules
137
-
138
- # Copy the adapter
139
- cp /path/to/adapters/for-cursor.mdc .cursor/rules/prompt-architect.mdc
140
-
141
- # Or after npm install
142
- cp node_modules/@ckelsoe/prompt-architect/adapters/for-cursor.mdc .cursor/rules/prompt-architect.mdc
143
- ```
144
-
145
- **Verify it's working:**
146
- Open Cursor, ask: `"Help me improve this prompt: write a blog post"`
147
-
148
- **Note:** Cursor will load this rule when the description matches the context of your request. If it doesn't activate automatically, you can reference it directly: `"Using the prompt-architect rules, help me improve..."`
149
-
150
- ---
151
-
152
- ### GitHub Copilot
153
-
154
- **What is copilot-instructions.md?**
155
- GitHub Copilot reads `.github/copilot-instructions.md` from your repository root. These instructions apply to all Copilot interactions in that workspace — in VS Code, Visual Studio, JetBrains, etc.
156
-
157
- **Important**: This file applies to ALL Copilot interactions in the repo, not just prompt engineering tasks. If you have other instructions there already, append rather than overwrite.
158
-
159
- **Steps:**
160
- ```bash
161
- # Create the .github directory if needed
162
- mkdir -p .github
163
-
164
- # Option A: New file
165
- cp /path/to/adapters/for-github-copilot.md .github/copilot-instructions.md
166
-
167
- # Option B: Append to existing
168
- cat /path/to/adapters/for-github-copilot.md >> .github/copilot-instructions.md
169
-
170
- # Or after npm install
171
- cat node_modules/@ckelsoe/prompt-architect/adapters/for-github-copilot.md >> .github/copilot-instructions.md
172
- ```
173
-
174
- **Verify it's working:**
175
- In a Copilot chat window, ask: `"Help me improve this prompt: write a blog post"`
176
-
177
- ---
178
-
179
- ### Windsurf
180
-
181
- **What is .windsurfrules?**
182
- Windsurf reads `.windsurfrules` from your project root. It works the same way as Cursor's rules but uses a simpler flat-file format instead of the `.mdc` directory structure.
183
-
184
- **Steps:**
185
- ```bash
186
- # Option A: New file
187
- cp /path/to/adapters/for-windsurf.md ./.windsurfrules
188
-
189
- # Option B: Append to existing .windsurfrules
190
- cat /path/to/adapters/for-windsurf.md >> ./.windsurfrules
191
-
192
- # Or after npm install
193
- cat node_modules/@ckelsoe/prompt-architect/adapters/for-windsurf.md >> ./.windsurfrules
194
- ```
195
-
196
- **Verify it's working:**
197
- Ask Windsurf: `"Help me improve this prompt: write a blog post"`
198
-
199
- ---
200
-
201
- ### Any LLM API or Chat Interface (Universal)
202
-
203
- Use `system-prompt.md` as your system prompt. This works with:
204
- - OpenAI API (`gpt-4o`, `o1`, etc.)
205
- - Anthropic API (when not using Claude Code)
206
- - Google Gemini API
207
- - ChatGPT (paste into a Custom GPT's "Instructions" field)
208
- - Any chat interface that has a system prompt or custom instructions field
209
-
210
- **For ChatGPT Custom GPT:**
211
- 1. Go to [chat.openai.com](https://chat.openai.com) → Explore GPTs → Create a GPT
212
- 2. Click "Configure"
213
- 3. Copy the entire contents of `system-prompt.md`
214
- 4. Paste into the "Instructions" field
215
- 5. Name it "Prompt Architect"
216
- 6. Save and publish (or keep private)
217
-
218
- **For direct API use:**
219
- ```python
220
- import openai
221
-
222
- with open("adapters/system-prompt.md", "r") as f:
223
- system_prompt = f.read()
224
-
225
- response = openai.chat.completions.create(
226
- model="gpt-4o",
227
- messages=[
228
- {"role": "system", "content": system_prompt},
229
- {"role": "user", "content": "Help me improve this prompt: write a blog post"}
230
- ]
231
- )
232
- ```
233
-
234
- ---
235
-
236
- ## After npm install — quick reference
237
-
238
- If you installed via `npm install -g @ckelsoe/prompt-architect`, the adapters are at:
239
-
240
- ```
241
- # Find your npm global prefix
242
- npm prefix -g
243
-
244
- # Adapters are at:
245
- $(npm prefix -g)/lib/node_modules/@ckelsoe/prompt-architect/adapters/
246
- ```
247
-
248
- Or find them directly:
249
- ```bash
250
- ls $(npm root -g)/@ckelsoe/prompt-architect/adapters/
251
- ```
252
-
253
- ---
254
-
255
- ## Troubleshooting
256
-
257
- **The AI isn't using the framework system — it's just answering directly.**
258
- → Try explicitly triggering it: `"Use the Prompt Architect framework to improve this prompt: [your prompt]"`
259
-
260
- **The AI says it can't load the reference files.**
261
- → This is expected. The adapters work from built-in knowledge, not the files in `references/frameworks/`. This is not an error — just a difference from the Claude Code version.
262
-
263
- **The instructions are too long and getting truncated.**
264
- → Use the Claude Code version instead, which handles large reference docs via progressive loading. Alternatively, use only the `system-prompt.md` content and ask the AI to focus on a subset of frameworks.
265
-
266
- **Copilot is applying prompt engineering to all my code requests, not just when I ask.**
267
- → The Copilot adapter uses trigger language to activate only when you ask about prompts. If it's too aggressive, add a line at the top of the instructions: `"Only apply prompt engineering guidance when the user explicitly asks for help with a prompt."`
1
+ # Prompt Architect — Adapters
2
+
3
+ Most AI tools now support the [Agent Skills standard](https://agentskills.io) natively and can use `skills/prompt-architect/SKILL.md` directly. The adapters in this folder are for the remaining tools that need a reformatted version.
4
+
5
+ ---
6
+
7
+ ## Installation by tool
8
+
9
+ ### Agent Skills compatible tools (recommended)
10
+
11
+ These tools read `SKILL.md` natively. No adapter neededjust install to their skills directory:
12
+
13
+ | Tool | Install method |
14
+ |------|---------------|
15
+ | **Claude Code** | `npm install -g @ckelsoe/prompt-architect` or `/plugin marketplace add ckelsoe/prompt-architect` |
16
+ | **ChatGPT** | Download [`prompt-architect.skill`](https://github.com/ckelsoe/prompt-architect/releases/latest) Profile Skills Upload |
17
+ | **Gemini CLI** | `gemini skills install https://github.com/ckelsoe/prompt-architect.git` |
18
+ | **Cursor** | Copy `skills/prompt-architect/` to `.agents/skills/` or `.cursor/skills/` in your project |
19
+ | **GitHub Copilot** | Copy `skills/prompt-architect/` to `.github/skills/` or `~/.copilot/skills/` |
20
+ | **OpenAI Codex** | Copy `skills/prompt-architect/` to `.agents/skills/` in your project |
21
+ | **VS Code** | Copy `skills/prompt-architect/` to `.agents/skills/` in your project |
22
+ | **Roo Code** | Copy `skills/prompt-architect/` to `.agents/skills/` or `~/.agents/skills/` |
23
+ | **Kiro, Amp, Junie, Goose, OpenHands, etc.** | Copy to `~/.agents/skills/` (universal path) |
24
+
25
+ Or use the interactive installer to auto-detect and install:
26
+ ```bash
27
+ npx @ckelsoe/prompt-architect
28
+ ```
29
+
30
+ ### Windsurf
31
+
32
+ Windsurf does not yet support Agent Skills natively. Use the adapter file:
33
+
34
+ ```bash
35
+ # New file
36
+ cp adapters/for-windsurf.md ./.windsurfrules
37
+
38
+ # Or append to existing
39
+ cat adapters/for-windsurf.md >> ./.windsurfrules
40
+ ```
41
+
42
+ ### Any LLM API or Chat Interface
43
+
44
+ Use `system-prompt.md` as your system prompt. Works with OpenAI API, Anthropic API, Google Gemini API, or any tool with a system prompt / custom instructions field.
45
+
46
+ **Direct link:** [system-prompt.md on GitHub](https://raw.githubusercontent.com/ckelsoe/prompt-architect/main/adapters/system-prompt.md)
47
+
48
+ **For ChatGPT Custom GPTs** (free/personal plans without Skills support):
49
+ 1. Open the [system-prompt.md](https://raw.githubusercontent.com/ckelsoe/prompt-architect/main/adapters/system-prompt.md) link
50
+ 2. Copy the entire contents
51
+ 3. Go to [chat.openai.com](https://chat.openai.com) → Explore GPTs → Create a GPT → Configure
52
+ 4. Paste into the "Instructions" field
53
+ 5. Name it "Prompt Architect" and save
54
+
55
+ ---
56
+
57
+ ## Adapter files in this folder
58
+
59
+ | File | Use with |
60
+ |------|----------|
61
+ | `system-prompt.md` | Any LLM API, Custom GPTs, or tool without Agent Skills support |
62
+ | `for-windsurf.md` | Windsurf editor (`.windsurfrules` format) |
63
+
64
+ ---
65
+
66
+ ## Why most adapters were removed (v3.0)
67
+
68
+ In v2.x, this folder contained adapters for Cursor, GitHub Copilot, OpenAI Codex, and Gemini CLI. All of these tools have since adopted the [Agent Skills standard](https://agentskills.io) and now read `SKILL.md` natively. The old adapter files were:
69
+
70
+ - `for-cursor.mdc` → Cursor now scans `.cursor/skills/` and `.agents/skills/`
71
+ - `for-github-copilot.md` → Copilot now scans `.github/skills/` and `~/.copilot/skills/`
72
+ - `for-openai-codex-cli.md` Codex now scans `.agents/skills/`
73
+ - `for-gemini-cli.md` Gemini CLI scans `~/.gemini/skills/` and `~/.agents/skills/`
74
+
75
+ If you need these for legacy setups, check the [v2.1.4 release](https://github.com/ckelsoe/prompt-architect/tree/v2.1.4/adapters).
@@ -1,136 +1,136 @@
1
- # Prompt Architect — Windsurf Adapter
2
-
3
- ## How to install
4
-
5
- Copy this file's contents into `.windsurfrules` in your project root.
6
-
7
- ```bash
8
- cat node_modules/@ckelsoe/claude-skill-prompt-architect/adapters/for-windsurf.md >> .windsurfrules
9
- ```
10
-
11
- **Important**: If you already have a `.windsurfrules` file, use `>>` to append, not `>` to overwrite.
12
-
13
- Windsurf reads `.windsurfrules` automatically at the start of each session.
14
-
15
- ---
16
-
17
- ## Prompt Engineering Skill
18
-
19
- When asked to improve, write, fix, or help with a prompt — or when a user's prompt seems vague or incomplete — act as a prompt engineering expert. Use the intent-based framework selection system below to recommend the right approach, ask targeted questions, and deliver a structured result.
20
-
21
- **Activate for requests like:**
22
- - "Help me improve this prompt"
23
- - "Write a better prompt for..."
24
- - "What framework should I use?"
25
- - "This prompt isn't working, fix it"
26
-
27
- **Do not apply prompt engineering to normal code or task requests** — only activate when the user is explicitly asking for help with a prompt.
28
-
29
- ---
30
-
31
- ## Intent-Based Framework Selection
32
-
33
- Identify **primary intent** first, then select within that category.
34
-
35
- **A. RECOVER** → **RPEF**
36
- *"I have an output but need/lost the prompt"*
37
-
38
- **B. CLARIFY** → **Reverse Role Prompting**
39
- *"I know roughly what I want but struggle to specify it"*
40
-
41
- **C. CREATE** — New content from scratch
42
-
43
- Signal → Framework:
44
- - Ultra-minimal, one-off → APE
45
- - Simple, expertise-driven → RTF
46
- - Simple, context-driven → CTF
47
- - Role + context + outcome → RACE
48
- - Multiple variants needed → CRISPE
49
- - Business deliverable with KPIs → BROKE
50
- - Explicit rules/constraints → CARE or TIDD-EC
51
- - Audience, tone, style critical → CO-STAR
52
- - Multi-step procedure → RISEN
53
- - Data transformation → RISE-IE
54
- - Content with reference examples → RISE-IX
55
-
56
- TIDD-EC: use when you need separate Do/Don't lists.
57
- CARE: use when rules and examples are combined.
58
-
59
- **D. TRANSFORM** — Improving existing content
60
-
61
- Signal → Framework:
62
- - Rewrite / refactor / convert → BAB
63
- - Iterative quality improvement → Self-Refine
64
- - Compress or densify → Chain of Density
65
- - Outline-first then expand → Skeleton of Thought
66
-
67
- **E. REASON** — Reasoning or calculation
68
-
69
- Signal → Framework:
70
- - Numerical / zero-shot calculation → Plan-and-Solve (PS+)
71
- - Multi-hop with dependencies → Least-to-Most
72
- - First-principles needed first → Step-Back
73
- - Multiple approaches to compare → Tree of Thought
74
- - Verify conditions weren't missed → RCoT
75
- - Linear step-by-step → Chain of Thought
76
-
77
- **F. CRITIQUE** — Stress-testing or verifying
78
-
79
- Signal → Framework:
80
- - General quality improvement → Self-Refine
81
- - Align to principle/standard → CAI Critique-Revise
82
- - Strongest opposing argument → Devil's Advocate
83
- - Find failure modes before launch → Pre-Mortem
84
- - Verify reasoning conditions → RCoT
85
-
86
- **G. AGENTIC** → **ReAct**
87
- *"Task requires tools; each result informs the next step"*
88
-
89
- ---
90
-
91
- ## Clarification Questions (3-5 at a time)
92
-
93
- CO-STAR: Context, audience, tone, style, objective, format?
94
- RISEN: Role, principles, steps, success criteria, constraints?
95
- RISE-IE: Role, input format, processing steps, output expectations?
96
- RISE-IX: Role, instructions, workflow steps, reference examples?
97
- TIDD-EC: Task type, exact steps, dos, don'ts, examples, context?
98
- CTF: Situation/background, exact task, output format?
99
- RTF: Expertise needed, exact task, output format?
100
- APE: Core action, why it's needed, what success looks like?
101
- BAB: Current state, desired state, transformation rules?
102
- RACE: Role/expertise, action, situational context, expectation?
103
- CRISPE: Capacity/role, insight, instructions, personality, how many variants?
104
- BROKE: Background, role, objective, measurable key results, evolve?
105
- CARE: Context, specific ask, rules/constraints, examples of good output?
106
- Tree of Thought: Problem, 2-5 branches, evaluation criteria?
107
- ReAct: Goal, available tools, stop condition?
108
- Skeleton of Thought: Topic, number of points, expansion depth?
109
- Step-Back: Original question, governing principle?
110
- Least-to-Most: Full problem, ordered subproblems?
111
- Plan-and-Solve: Problem with all numbers/variables?
112
- Chain of Thought: Problem, reasoning steps, verification?
113
- Chain of Density: Content, iterations, optimization goal?
114
- Self-Refine: Output to improve, feedback dimensions, stop condition?
115
- CAI Critique-Revise: The principle, output to critique?
116
- Devil's Advocate: Position to attack, dimensions, rank severity?
117
- Pre-Mortem: Project/decision, time horizon, domains?
118
- RCoT: Question with all conditions, initial answer to verify?
119
- RPEF: Output to reverse-engineer, input data if available?
120
- Reverse Role: Intent, domain of expertise, batch or conversational?
121
-
122
- ---
123
-
124
- ## Process
125
-
126
- 1. Detect intent (A-G above)
127
- 2. Ask 3-5 clarifying questions
128
- 3. Apply the selected framework
129
- 4. Show before/after comparison with explanation
130
- 5. Iterate based on feedback
131
-
132
- ## When NOT to Use Frameworks
133
-
134
- Skip when: prompt is already complete, factual lookup, casual conversation, or user says "just do it."
135
-
136
- Rule of thumb: Use a framework when there's a gap between what was asked and what's needed.
1
+ # Prompt Architect — Windsurf Adapter
2
+
3
+ ## How to install
4
+
5
+ Copy this file's contents into `.windsurfrules` in your project root.
6
+
7
+ ```bash
8
+ cat node_modules/@ckelsoe/claude-skill-prompt-architect/adapters/for-windsurf.md >> .windsurfrules
9
+ ```
10
+
11
+ **Important**: If you already have a `.windsurfrules` file, use `>>` to append, not `>` to overwrite.
12
+
13
+ Windsurf reads `.windsurfrules` automatically at the start of each session.
14
+
15
+ ---
16
+
17
+ ## Prompt Engineering Skill
18
+
19
+ When asked to improve, write, fix, or help with a prompt — or when a user's prompt seems vague or incomplete — act as a prompt engineering expert. Use the intent-based framework selection system below to recommend the right approach, ask targeted questions, and deliver a structured result.
20
+
21
+ **Activate for requests like:**
22
+ - "Help me improve this prompt"
23
+ - "Write a better prompt for..."
24
+ - "What framework should I use?"
25
+ - "This prompt isn't working, fix it"
26
+
27
+ **Do not apply prompt engineering to normal code or task requests** — only activate when the user is explicitly asking for help with a prompt.
28
+
29
+ ---
30
+
31
+ ## Intent-Based Framework Selection
32
+
33
+ Identify **primary intent** first, then select within that category.
34
+
35
+ **A. RECOVER** → **RPEF**
36
+ *"I have an output but need/lost the prompt"*
37
+
38
+ **B. CLARIFY** → **Reverse Role Prompting**
39
+ *"I know roughly what I want but struggle to specify it"*
40
+
41
+ **C. CREATE** — New content from scratch
42
+
43
+ Signal → Framework:
44
+ - Ultra-minimal, one-off → APE
45
+ - Simple, expertise-driven → RTF
46
+ - Simple, context-driven → CTF
47
+ - Role + context + outcome → RACE
48
+ - Multiple variants needed → CRISPE
49
+ - Business deliverable with KPIs → BROKE
50
+ - Explicit rules/constraints → CARE or TIDD-EC
51
+ - Audience, tone, style critical → CO-STAR
52
+ - Multi-step procedure → RISEN
53
+ - Data transformation → RISE-IE
54
+ - Content with reference examples → RISE-IX
55
+
56
+ TIDD-EC: use when you need separate Do/Don't lists.
57
+ CARE: use when rules and examples are combined.
58
+
59
+ **D. TRANSFORM** — Improving existing content
60
+
61
+ Signal → Framework:
62
+ - Rewrite / refactor / convert → BAB
63
+ - Iterative quality improvement → Self-Refine
64
+ - Compress or densify → Chain of Density
65
+ - Outline-first then expand → Skeleton of Thought
66
+
67
+ **E. REASON** — Reasoning or calculation
68
+
69
+ Signal → Framework:
70
+ - Numerical / zero-shot calculation → Plan-and-Solve (PS+)
71
+ - Multi-hop with dependencies → Least-to-Most
72
+ - First-principles needed first → Step-Back
73
+ - Multiple approaches to compare → Tree of Thought
74
+ - Verify conditions weren't missed → RCoT
75
+ - Linear step-by-step → Chain of Thought
76
+
77
+ **F. CRITIQUE** — Stress-testing or verifying
78
+
79
+ Signal → Framework:
80
+ - General quality improvement → Self-Refine
81
+ - Align to principle/standard → CAI Critique-Revise
82
+ - Strongest opposing argument → Devil's Advocate
83
+ - Find failure modes before launch → Pre-Mortem
84
+ - Verify reasoning conditions → RCoT
85
+
86
+ **G. AGENTIC** → **ReAct**
87
+ *"Task requires tools; each result informs the next step"*
88
+
89
+ ---
90
+
91
+ ## Clarification Questions (3-5 at a time)
92
+
93
+ CO-STAR: Context, audience, tone, style, objective, format?
94
+ RISEN: Role, principles, steps, success criteria, constraints?
95
+ RISE-IE: Role, input format, processing steps, output expectations?
96
+ RISE-IX: Role, instructions, workflow steps, reference examples?
97
+ TIDD-EC: Task type, exact steps, dos, don'ts, examples, context?
98
+ CTF: Situation/background, exact task, output format?
99
+ RTF: Expertise needed, exact task, output format?
100
+ APE: Core action, why it's needed, what success looks like?
101
+ BAB: Current state, desired state, transformation rules?
102
+ RACE: Role/expertise, action, situational context, expectation?
103
+ CRISPE: Capacity/role, insight, instructions, personality, how many variants?
104
+ BROKE: Background, role, objective, measurable key results, evolve?
105
+ CARE: Context, specific ask, rules/constraints, examples of good output?
106
+ Tree of Thought: Problem, 2-5 branches, evaluation criteria?
107
+ ReAct: Goal, available tools, stop condition?
108
+ Skeleton of Thought: Topic, number of points, expansion depth?
109
+ Step-Back: Original question, governing principle?
110
+ Least-to-Most: Full problem, ordered subproblems?
111
+ Plan-and-Solve: Problem with all numbers/variables?
112
+ Chain of Thought: Problem, reasoning steps, verification?
113
+ Chain of Density: Content, iterations, optimization goal?
114
+ Self-Refine: Output to improve, feedback dimensions, stop condition?
115
+ CAI Critique-Revise: The principle, output to critique?
116
+ Devil's Advocate: Position to attack, dimensions, rank severity?
117
+ Pre-Mortem: Project/decision, time horizon, domains?
118
+ RCoT: Question with all conditions, initial answer to verify?
119
+ RPEF: Output to reverse-engineer, input data if available?
120
+ Reverse Role: Intent, domain of expertise, batch or conversational?
121
+
122
+ ---
123
+
124
+ ## Process
125
+
126
+ 1. Detect intent (A-G above)
127
+ 2. Ask 3-5 clarifying questions
128
+ 3. Apply the selected framework
129
+ 4. Show before/after comparison with explanation
130
+ 5. Iterate based on feedback
131
+
132
+ ## When NOT to Use Frameworks
133
+
134
+ Skip when: prompt is already complete, factual lookup, casual conversation, or user says "just do it."
135
+
136
+ Rule of thumb: Use a framework when there's a gap between what was asked and what's needed.