@ckelsoe/prompt-architect 3.0.2 → 3.1.1

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 +331 -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
@@ -12,7 +12,7 @@
12
12
  "name": "prompt-architect",
13
13
  "source": "./",
14
14
  "description": "Analyzes and improves prompts using 27 research-backed frameworks. Intent-based selection routes to the right framework — from ultra-minimal (APE) to agentic (ReAct).",
15
- "version": "3.0.2",
15
+ "version": "3.1.1",
16
16
  "keywords": ["prompt-engineering", "prompt-frameworks", "agent-skills"],
17
17
  "category": "productivity"
18
18
  }
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "prompt-architect",
3
3
  "description": "27-framework prompt engineering skill for analyzing and improving prompts across 7 intent categories",
4
- "version": "3.0.2",
4
+ "version": "3.1.1",
5
5
  "author": {
6
6
  "name": "Charles Kelsoe",
7
7
  "email": "charles@kelsoe.com"
package/CHANGELOG.md CHANGED
@@ -1,264 +1,264 @@
1
- # Changelog
2
-
3
- All notable changes to the Prompt Architect Claude Code skill will be documented in this file.
4
-
5
- The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
- and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
-
8
- ## [3.0.0] - 2026-03-24
9
-
10
- ### Breaking Changes
11
- - **Package renamed**: `@ckelsoe/claude-skill-prompt-architect` → `@ckelsoe/prompt-architect`
12
- - **Directory restructured**: `prompt-architect/` moved to `skills/prompt-architect/` for Claude Code plugin system compatibility
13
-
14
- ### Added
15
- - **Claude Code Plugin System support**: `.claude-plugin/plugin.json` and `marketplace.json` — install via `/plugin marketplace add` and `/plugin install`
16
- - **Gemini CLI support**: Native Agent Skills compatibility. Install via `gemini skills install`
17
- - **Agent Skills standard compliance** (agentskills.io): Added `license`, `compatibility`, and `metadata` fields to SKILL.md frontmatter. Works with 30+ compatible agents including Cursor, Copilot, Kiro, Roo Code, Amp, OpenHands, and more
18
- - **Interactive multi-agent installer**: Detects installed AI agents (Claude Code, Gemini CLI, Cursor, Copilot, Windsurf, Codex) and presents a selection UI using @clack/prompts
19
- - **Universal install path**: `~/.agents/skills/` for Agent Skills standard compatible tools
20
- - **CLI flags**: `--all`, `--claude`, `--gemini`, `--agents`, `--cursor`, `--copilot`, `--windsurf`, `--codex`, `--yes`
21
- - **Gemini CLI adapter**: `adapters/for-gemini-cli.md` with installation instructions
22
- - **Append-mode safety**: Marker comments prevent duplicate content when appending adapters to existing files
23
- - **MIGRATION.md**: Step-by-step guide for migrating from the old package name
24
-
25
- ### Changed
26
- - `scripts/install.js` fully rewritten as multi-agent installer with @clack/prompts UI
27
- - `scripts/test.js` expanded from 11 to 19 tests (plugin manifests, Agent Skills compliance, all adapters)
28
- - `scripts/validate-skill.js` now validates plugin manifest and cross-checks version consistency
29
- - Added `@clack/prompts` as a runtime dependency (previously zero dependencies)
30
- - Non-interactive postinstall still defaults to Claude Code only for backwards compatibility
31
-
32
- ---
33
-
34
- ## [2.1.3] - 2026-03-10
35
-
36
- ### Fixed
37
- - **`npm install -g` now automatically installs the Claude Code skill** — no separate command needed
38
- - Root cause: npm was stripping the `bin[prompt-architect-install]` entry during publish, so the install command never existed after `npm install -g`
39
- - Fix: added `"postinstall": "node scripts/install.js"` — npm runs this automatically after every install
40
- - Global installs (`npm install -g`) auto-install the skill to `~/.claude/skills/`
41
- - Project installs (`npm install`) print a message explaining how to install for the project
42
- - Added `scripts/` to the `files` array so `install.js` is explicitly included in the npm package
43
- - Removed the broken `bin` entry that npm kept stripping
44
-
45
- ---
46
-
47
- ## [2.1.2] - 2026-03-10
48
-
49
- ### Fixed
50
- - **`scripts/install.js` — simplified to always install, no conditions**
51
- - Removed all version-checking logic (unnecessary complexity)
52
- - `prompt-architect-install` now always removes any existing installation and copies the current version fresh
53
- - Running it multiple times is safe and always gives you the version from the npm package you installed
54
-
55
- ---
56
-
57
- ## [2.1.1] - 2026-03-10
58
-
59
- ### Fixed
60
- - **`scripts/install.js` — install script never updated an existing installation**
61
- - Old behavior: if skill was already installed, the script exited immediately without copying new files. Running `prompt-architect-install` after an npm update silently kept the old version.
62
- - New behavior: script compares the installed version against the current package version. If they differ, it updates automatically. Only skips if already at the same version.
63
- - Writes a `.version` marker file at install time so future runs can detect version mismatches.
64
- - Success message now shows the installed version number.
65
-
66
- ---
67
-
68
- ## [2.1.0] - 2026-03-10
69
-
70
- ### Added
71
- - **Cross-platform adapters** in `adapters/` — ready-to-use versions for AI tools other than Claude Code:
72
- - `adapters/system-prompt.md` — Universal system prompt for any LLM API, ChatGPT Custom GPT, etc.
73
- - `adapters/for-openai-codex-cli.md` — For OpenAI Codex CLI (`AGENTS.md`)
74
- - `adapters/for-cursor.mdc` — For Cursor editor (`.cursor/rules/` MDC format)
75
- - `adapters/for-github-copilot.md` — For GitHub Copilot (`.github/copilot-instructions.md`)
76
- - `adapters/for-windsurf.md` — For Windsurf editor (`.windsurfrules`)
77
- - `adapters/README.md` — Full documentation: install steps, limitations, troubleshooting per platform
78
- - **README "Use with Other AI Tools" section** — quick-install commands for all supported platforms
79
- - `adapters/` added to `package.json` files array — adapters now ship inside the npm package
80
-
81
- ---
82
-
83
- ## [2.0.0] - 2026-03-10
84
-
85
- ### Breaking Changes
86
- - **SKILL.md completely restructured** with intent-based framework selection replacing the flat 20-item use-case list. Seven intent categories (Recover, Clarify, Create, Transform, Reason, Critique, Agentic) now route to frameworks with discriminating tables within each category. Downstream tooling that parsed the old flat list format must be updated.
87
-
88
- ### Added
89
- - **Intent-based framework selection system**: 7 categories with discriminating tables replace the flat list
90
- - **"When NOT to use frameworks" guidance**: Explicit conditions for skipping framework overhead
91
- - **Updated example interaction**: Demonstrates full intent-detection → framework-selection → delivery flow using BAB (not just CO-STAR)
92
- - **27-framework `hybrid_template.txt`**: Updated with 6 named combination patterns (Reverse Role → CREATE, BAB + Self-Refine, Devil's Advocate + Pre-Mortem, Step-Back + Chain of Thought, RPEF + Self-Refine, CO-STAR/RISEN + CAI Critique-Revise)
93
- - **Rewritten `framework_analyzer.py`**: Intent-based 27-framework system with two-phase scoring (detect intent → score within category)
94
- - **Updated `package.json`**: v2.0.0, 27 frameworks, expanded keywords, `intentCategories` and `frameworkCombinations` metadata fields
95
- - **Framework quick-reference taxonomy** in SKILL.md grouping all 27 by family
96
-
97
- ### Changed
98
- - `package.json` version: 1.0.8 → 2.0.0
99
- - `package.json` description: updated to reference 27 frameworks across 7 intent categories
100
- - `framework_analyzer.py`: Rewritten from 8-framework flat scoring to 27-framework intent-based system
101
- - `hybrid_template.txt`: Updated from 4-framework references to all 7 framework family sections + 6 named combination patterns
102
-
103
- ---
104
-
105
- ## [1.3.0] - 2026-03-10
106
-
107
- ### Added
108
- - **7 New Frameworks** (total now 27):
109
- - **RPEF** — Reverse Prompt Engineering: recover a reusable prompt from an existing output (EMNLP 2025)
110
- - **Reverse Role Prompting** — AI-Led Interview: AI interviews you before executing (FATA, arXiv 2025, ~40% improvement)
111
- - **Self-Refine** — Generate → Feedback → Refine loop for any output quality improvement (NeurIPS 2023, +5-40%)
112
- - **Devil's Advocate** — Generate the strongest opposing argument against a position (ACM IUI 2024)
113
- - **Pre-Mortem** — Assume failure, work backwards to specific causes with warning signs (Gary Klein)
114
- - **CAI Critique-Revise** — Principle-based critique and revision (Anthropic Constitutional AI, 2022)
115
- - **RCoT** — Reverse Chain-of-Thought: verify reasoning by reconstructing the question from the answer
116
- - **7 New Framework Reference Docs** in `references/frameworks/`
117
- - **7 New Templates** in `assets/templates/`
118
-
119
- ### Changed
120
- - **SKILL.md completely restructured** with intent-based framework selection system:
121
- - Replaced flat 20-item list with 7 intent categories: Recover, Clarify, Create, Transform, Reason, Critique, Agentic
122
- - Each category has a discriminating table/decision for selecting among similar frameworks
123
- - Added quick-reference taxonomy grouping all 27 frameworks by family
124
- - Added clarification questions for all 7 new frameworks
125
- - README updated: framework count, table, supported frameworks entries, decision tree, quick reference, project structure, documentation
126
- - Framework count references updated to 27 throughout
127
-
128
- ---
129
-
130
- ## [1.2.0] - 2026-03-10
131
-
132
- ### Added
133
- - **7 New Frameworks** (total now 20):
134
- - **Skeleton of Thought (SoT)** — Generate skeleton outline first, expand each point (ICLR 2024, Microsoft Research)
135
- - **Step-Back Prompting** — Abstract to underlying principles before answering (Google DeepMind, ICLR 2024)
136
- - **Least-to-Most (LtM)** — Decompose into ordered subproblems, solve sequentially (Google Brain, ICLR 2023)
137
- - **Plan-and-Solve (PS+)** — Zero-shot: plan + extract variables + calculate step by step (ACL 2023)
138
- - **CRISPE** — Capacity+Role, Insight, Instructions, Personality, Experiment (multiple variants)
139
- - **BROKE** — Background, Role, Objective, Key Results, Evolve (business OKR-style with self-critique)
140
- - **CARE** — Context, Ask, Rules, Examples (Nielsen Norman Group, constraint-driven)
141
- - **7 New Framework Reference Docs** in `references/frameworks/`
142
- - **7 New Templates** in `assets/templates/`
143
- - Updated reasoning ladder notes in SKILL.md
144
- - Expanded decision tree and quick reference in README
145
-
146
- ### Changed
147
- - SKILL.md updated to 20 frameworks
148
- - README framework table, decision tree, quick reference, and project structure updated
149
- - Framework count references updated throughout
150
-
151
- ---
152
-
153
- ## [1.1.0] - 2026-03-10
154
-
155
- ### Added
156
- - **6 New Frameworks** (total now 13):
157
- - **CTF** (Context, Task, Format) — Simple tasks where situational context drives the prompt more than AI persona framing
158
- - **APE** (Action, Purpose, Expectation) — Ultra-minimal framework for one-off quick prompts
159
- - **BAB** (Before, After, Bridge) — Transformation tasks: rewriting, refactoring, converting existing content
160
- - **RACE** (Role, Action, Context, Expectation) — Medium complexity with role + background + explicit success bar
161
- - **Tree of Thought** — Decision-making via systematic exploration of multiple solution branches
162
- - **ReAct** (Reasoning + Acting) — Agentic tasks interleaving reasoning with tool/action use
163
- - **6 New Framework Reference Docs** in `references/frameworks/`
164
- - **6 New Templates** in `assets/templates/`
165
- - Updated framework selection decision tree in SKILL.md and README
166
- - Added complexity ladder notes: simple task ladder and reasoning ladder
167
-
168
- ### Changed
169
- - SKILL.md description updated to reflect 13 frameworks
170
- - README framework table, decision tree, quick reference, project structure, and documentation sections updated
171
- - Framework count references updated throughout documentation
172
-
173
- ---
174
-
175
- ## [1.0.0] - 2025-01-24
176
-
177
- ### Added
178
- - Initial production release of Prompt Architect skill
179
- - **7 Framework Support**:
180
- - CO-STAR (Context, Objective, Style, Tone, Audience, Response)
181
- - RISEN (Role, Instructions, Steps, End goal, Narrowing)
182
- - RISE-IE (Role, Input, Steps, Expectation) for data analysis
183
- - RISE-IX (Role, Instructions, Steps, Examples) for content creation
184
- - TIDD-EC (Task, Instructions, Do, Don't, Examples, Context)
185
- - RTF (Role, Task, Format)
186
- - Chain of Thought for reasoning tasks
187
- - Chain of Density for iterative refinement
188
- - **Prompt Analysis System**:
189
- - Quality scoring across 5 dimensions (clarity, specificity, context, completeness, structure)
190
- - Automatic framework recommendation based on use case
191
- - Before/after comparison with explanations
192
- - **Interactive Workflow**:
193
- - Progressive clarification questions (3-5 at a time)
194
- - Framework-specific question sets
195
- - Iterative refinement based on feedback
196
- - Framework switching capability
197
- - **Complete Documentation**:
198
- - 7 comprehensive framework references (500-700 lines each)
199
- - 7 ready-to-use templates
200
- - Detailed usage examples
201
- - Framework selection guide
202
- - **Analysis Scripts**:
203
- - `framework_analyzer.py` - Framework recommendation logic
204
- - `prompt_evaluator.py` - Quality scoring system
205
- - **Installation Tools**:
206
- - Automated installation script
207
- - Multi-platform support (Windows, macOS, Linux)
208
- - Project and user-wide installation options
209
-
210
- ### Documentation
211
- - Comprehensive README with quick start guide
212
- - Framework selection decision tree
213
- - Example transformations with scoring
214
- - Complete API documentation
215
- - Contributing guidelines
216
- - MIT License
217
-
218
- ### Framework Details
219
- - **CO-STAR**: 600+ lines of documentation with 5 complete examples
220
- - **RISEN**: 600+ lines with systematic methodology guidance
221
- - **RISE**: 700+ lines covering both IE and IX variants
222
- - **TIDD-EC**: 600+ lines with explicit dos/don'ts patterns
223
- - **RTF**: 500+ lines for simple task structuring
224
- - **Chain of Thought**: 500+ lines on reasoning techniques
225
- - **Chain of Density**: 500+ lines on iterative compression
226
-
227
-
228
-
229
- ---
230
-
231
- ## Migration Notes
232
-
233
- ### v1.x → v2.0.0
234
-
235
- The framework selection system in SKILL.md was completely restructured:
236
-
237
- - **Old format**: flat "use case → framework" list (20 items)
238
- - **New format**: 7 intent categories (A–G), each with a discriminating table
239
-
240
- **Impact on users**: No breaking changes to templates or prompts themselves. The change is in how the skill reasons about which framework to apply. If you have custom tooling that parsed the old flat list format, update it to use the 7-category intent system.
241
-
242
- **Impact on `framework_analyzer.py`**: Rewritten with intent-based two-phase scoring. If you imported this script directly, the function signatures for `analyze_use_case()` are unchanged but the internal scoring logic is different.
243
-
244
- ### For v1.0.0 Users
245
-
246
- - No migration needed for prompts or templates
247
- - All 27 framework templates are backwards compatible
248
- - The 7 new frameworks added in v1.1.0–v1.3.0 are additive only
249
-
250
- ---
251
-
252
- ## Notes
253
-
254
- - All dates in format: YYYY-MM-DD
255
- - Version numbers follow SemVer: MAJOR.MINOR.PATCH
256
- - [Unreleased] section tracks upcoming changes
257
- - Each version includes upgrade instructions if needed
258
-
259
- ## Links
260
-
261
- - [npm Package](https://www.npmjs.com/package/@ckelsoe/claude-skill-prompt-architect)
262
- - [GitHub Repository](https://github.com/ckelsoe/claude-skill-prompt-architect)
263
- - [Issue Tracker](https://github.com/ckelsoe/claude-skill-prompt-architect/issues)
264
- - [Contributing Guidelines](https://github.com/ckelsoe/claude-skill-prompt-architect/blob/main/README.md#contributing)
1
+ # Changelog
2
+
3
+ All notable changes to the Prompt Architect Claude Code skill will be documented in this file.
4
+
5
+ The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
6
+ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
7
+
8
+ ## [3.0.0] - 2026-03-24
9
+
10
+ ### Breaking Changes
11
+ - **Package renamed**: `@ckelsoe/claude-skill-prompt-architect` → `@ckelsoe/prompt-architect`
12
+ - **Directory restructured**: `prompt-architect/` moved to `skills/prompt-architect/` for Claude Code plugin system compatibility
13
+
14
+ ### Added
15
+ - **Claude Code Plugin System support**: `.claude-plugin/plugin.json` and `marketplace.json` — install via `/plugin marketplace add` and `/plugin install`
16
+ - **Gemini CLI support**: Native Agent Skills compatibility. Install via `gemini skills install`
17
+ - **Agent Skills standard compliance** (agentskills.io): Added `license`, `compatibility`, and `metadata` fields to SKILL.md frontmatter. Works with 30+ compatible agents including Cursor, Copilot, Kiro, Roo Code, Amp, OpenHands, and more
18
+ - **Interactive multi-agent installer**: Detects installed AI agents (Claude Code, Gemini CLI, Cursor, Copilot, Windsurf, Codex) and presents a selection UI using @clack/prompts
19
+ - **Universal install path**: `~/.agents/skills/` for Agent Skills standard compatible tools
20
+ - **CLI flags**: `--all`, `--claude`, `--gemini`, `--agents`, `--cursor`, `--copilot`, `--windsurf`, `--codex`, `--yes`
21
+ - **Gemini CLI adapter**: `adapters/for-gemini-cli.md` with installation instructions
22
+ - **Append-mode safety**: Marker comments prevent duplicate content when appending adapters to existing files
23
+ - **MIGRATION.md**: Step-by-step guide for migrating from the old package name
24
+
25
+ ### Changed
26
+ - `scripts/install.js` fully rewritten as multi-agent installer with @clack/prompts UI
27
+ - `scripts/test.js` expanded from 11 to 19 tests (plugin manifests, Agent Skills compliance, all adapters)
28
+ - `scripts/validate-skill.js` now validates plugin manifest and cross-checks version consistency
29
+ - Added `@clack/prompts` as a runtime dependency (previously zero dependencies)
30
+ - Non-interactive postinstall still defaults to Claude Code only for backwards compatibility
31
+
32
+ ---
33
+
34
+ ## [2.1.3] - 2026-03-10
35
+
36
+ ### Fixed
37
+ - **`npm install -g` now automatically installs the Claude Code skill** — no separate command needed
38
+ - Root cause: npm was stripping the `bin[prompt-architect-install]` entry during publish, so the install command never existed after `npm install -g`
39
+ - Fix: added `"postinstall": "node scripts/install.js"` — npm runs this automatically after every install
40
+ - Global installs (`npm install -g`) auto-install the skill to `~/.claude/skills/`
41
+ - Project installs (`npm install`) print a message explaining how to install for the project
42
+ - Added `scripts/` to the `files` array so `install.js` is explicitly included in the npm package
43
+ - Removed the broken `bin` entry that npm kept stripping
44
+
45
+ ---
46
+
47
+ ## [2.1.2] - 2026-03-10
48
+
49
+ ### Fixed
50
+ - **`scripts/install.js` — simplified to always install, no conditions**
51
+ - Removed all version-checking logic (unnecessary complexity)
52
+ - `prompt-architect-install` now always removes any existing installation and copies the current version fresh
53
+ - Running it multiple times is safe and always gives you the version from the npm package you installed
54
+
55
+ ---
56
+
57
+ ## [2.1.1] - 2026-03-10
58
+
59
+ ### Fixed
60
+ - **`scripts/install.js` — install script never updated an existing installation**
61
+ - Old behavior: if skill was already installed, the script exited immediately without copying new files. Running `prompt-architect-install` after an npm update silently kept the old version.
62
+ - New behavior: script compares the installed version against the current package version. If they differ, it updates automatically. Only skips if already at the same version.
63
+ - Writes a `.version` marker file at install time so future runs can detect version mismatches.
64
+ - Success message now shows the installed version number.
65
+
66
+ ---
67
+
68
+ ## [2.1.0] - 2026-03-10
69
+
70
+ ### Added
71
+ - **Cross-platform adapters** in `adapters/` — ready-to-use versions for AI tools other than Claude Code:
72
+ - `adapters/system-prompt.md` — Universal system prompt for any LLM API, ChatGPT Custom GPT, etc.
73
+ - `adapters/for-openai-codex-cli.md` — For OpenAI Codex CLI (`AGENTS.md`)
74
+ - `adapters/for-cursor.mdc` — For Cursor editor (`.cursor/rules/` MDC format)
75
+ - `adapters/for-github-copilot.md` — For GitHub Copilot (`.github/copilot-instructions.md`)
76
+ - `adapters/for-windsurf.md` — For Windsurf editor (`.windsurfrules`)
77
+ - `adapters/README.md` — Full documentation: install steps, limitations, troubleshooting per platform
78
+ - **README "Use with Other AI Tools" section** — quick-install commands for all supported platforms
79
+ - `adapters/` added to `package.json` files array — adapters now ship inside the npm package
80
+
81
+ ---
82
+
83
+ ## [2.0.0] - 2026-03-10
84
+
85
+ ### Breaking Changes
86
+ - **SKILL.md completely restructured** with intent-based framework selection replacing the flat 20-item use-case list. Seven intent categories (Recover, Clarify, Create, Transform, Reason, Critique, Agentic) now route to frameworks with discriminating tables within each category. Downstream tooling that parsed the old flat list format must be updated.
87
+
88
+ ### Added
89
+ - **Intent-based framework selection system**: 7 categories with discriminating tables replace the flat list
90
+ - **"When NOT to use frameworks" guidance**: Explicit conditions for skipping framework overhead
91
+ - **Updated example interaction**: Demonstrates full intent-detection → framework-selection → delivery flow using BAB (not just CO-STAR)
92
+ - **27-framework `hybrid_template.txt`**: Updated with 6 named combination patterns (Reverse Role → CREATE, BAB + Self-Refine, Devil's Advocate + Pre-Mortem, Step-Back + Chain of Thought, RPEF + Self-Refine, CO-STAR/RISEN + CAI Critique-Revise)
93
+ - **Rewritten `framework_analyzer.py`**: Intent-based 27-framework system with two-phase scoring (detect intent → score within category)
94
+ - **Updated `package.json`**: v2.0.0, 27 frameworks, expanded keywords, `intentCategories` and `frameworkCombinations` metadata fields
95
+ - **Framework quick-reference taxonomy** in SKILL.md grouping all 27 by family
96
+
97
+ ### Changed
98
+ - `package.json` version: 1.0.8 → 2.0.0
99
+ - `package.json` description: updated to reference 27 frameworks across 7 intent categories
100
+ - `framework_analyzer.py`: Rewritten from 8-framework flat scoring to 27-framework intent-based system
101
+ - `hybrid_template.txt`: Updated from 4-framework references to all 7 framework family sections + 6 named combination patterns
102
+
103
+ ---
104
+
105
+ ## [1.3.0] - 2026-03-10
106
+
107
+ ### Added
108
+ - **7 New Frameworks** (total now 27):
109
+ - **RPEF** — Reverse Prompt Engineering: recover a reusable prompt from an existing output (EMNLP 2025)
110
+ - **Reverse Role Prompting** — AI-Led Interview: AI interviews you before executing (FATA, arXiv 2025, ~40% improvement)
111
+ - **Self-Refine** — Generate → Feedback → Refine loop for any output quality improvement (NeurIPS 2023, +5-40%)
112
+ - **Devil's Advocate** — Generate the strongest opposing argument against a position (ACM IUI 2024)
113
+ - **Pre-Mortem** — Assume failure, work backwards to specific causes with warning signs (Gary Klein)
114
+ - **CAI Critique-Revise** — Principle-based critique and revision (Anthropic Constitutional AI, 2022)
115
+ - **RCoT** — Reverse Chain-of-Thought: verify reasoning by reconstructing the question from the answer
116
+ - **7 New Framework Reference Docs** in `references/frameworks/`
117
+ - **7 New Templates** in `assets/templates/`
118
+
119
+ ### Changed
120
+ - **SKILL.md completely restructured** with intent-based framework selection system:
121
+ - Replaced flat 20-item list with 7 intent categories: Recover, Clarify, Create, Transform, Reason, Critique, Agentic
122
+ - Each category has a discriminating table/decision for selecting among similar frameworks
123
+ - Added quick-reference taxonomy grouping all 27 frameworks by family
124
+ - Added clarification questions for all 7 new frameworks
125
+ - README updated: framework count, table, supported frameworks entries, decision tree, quick reference, project structure, documentation
126
+ - Framework count references updated to 27 throughout
127
+
128
+ ---
129
+
130
+ ## [1.2.0] - 2026-03-10
131
+
132
+ ### Added
133
+ - **7 New Frameworks** (total now 20):
134
+ - **Skeleton of Thought (SoT)** — Generate skeleton outline first, expand each point (ICLR 2024, Microsoft Research)
135
+ - **Step-Back Prompting** — Abstract to underlying principles before answering (Google DeepMind, ICLR 2024)
136
+ - **Least-to-Most (LtM)** — Decompose into ordered subproblems, solve sequentially (Google Brain, ICLR 2023)
137
+ - **Plan-and-Solve (PS+)** — Zero-shot: plan + extract variables + calculate step by step (ACL 2023)
138
+ - **CRISPE** — Capacity+Role, Insight, Instructions, Personality, Experiment (multiple variants)
139
+ - **BROKE** — Background, Role, Objective, Key Results, Evolve (business OKR-style with self-critique)
140
+ - **CARE** — Context, Ask, Rules, Examples (Nielsen Norman Group, constraint-driven)
141
+ - **7 New Framework Reference Docs** in `references/frameworks/`
142
+ - **7 New Templates** in `assets/templates/`
143
+ - Updated reasoning ladder notes in SKILL.md
144
+ - Expanded decision tree and quick reference in README
145
+
146
+ ### Changed
147
+ - SKILL.md updated to 20 frameworks
148
+ - README framework table, decision tree, quick reference, and project structure updated
149
+ - Framework count references updated throughout
150
+
151
+ ---
152
+
153
+ ## [1.1.0] - 2026-03-10
154
+
155
+ ### Added
156
+ - **6 New Frameworks** (total now 13):
157
+ - **CTF** (Context, Task, Format) — Simple tasks where situational context drives the prompt more than AI persona framing
158
+ - **APE** (Action, Purpose, Expectation) — Ultra-minimal framework for one-off quick prompts
159
+ - **BAB** (Before, After, Bridge) — Transformation tasks: rewriting, refactoring, converting existing content
160
+ - **RACE** (Role, Action, Context, Expectation) — Medium complexity with role + background + explicit success bar
161
+ - **Tree of Thought** — Decision-making via systematic exploration of multiple solution branches
162
+ - **ReAct** (Reasoning + Acting) — Agentic tasks interleaving reasoning with tool/action use
163
+ - **6 New Framework Reference Docs** in `references/frameworks/`
164
+ - **6 New Templates** in `assets/templates/`
165
+ - Updated framework selection decision tree in SKILL.md and README
166
+ - Added complexity ladder notes: simple task ladder and reasoning ladder
167
+
168
+ ### Changed
169
+ - SKILL.md description updated to reflect 13 frameworks
170
+ - README framework table, decision tree, quick reference, project structure, and documentation sections updated
171
+ - Framework count references updated throughout documentation
172
+
173
+ ---
174
+
175
+ ## [1.0.0] - 2025-01-24
176
+
177
+ ### Added
178
+ - Initial production release of Prompt Architect skill
179
+ - **7 Framework Support**:
180
+ - CO-STAR (Context, Objective, Style, Tone, Audience, Response)
181
+ - RISEN (Role, Instructions, Steps, End goal, Narrowing)
182
+ - RISE-IE (Role, Input, Steps, Expectation) for data analysis
183
+ - RISE-IX (Role, Instructions, Steps, Examples) for content creation
184
+ - TIDD-EC (Task, Instructions, Do, Don't, Examples, Context)
185
+ - RTF (Role, Task, Format)
186
+ - Chain of Thought for reasoning tasks
187
+ - Chain of Density for iterative refinement
188
+ - **Prompt Analysis System**:
189
+ - Quality scoring across 5 dimensions (clarity, specificity, context, completeness, structure)
190
+ - Automatic framework recommendation based on use case
191
+ - Before/after comparison with explanations
192
+ - **Interactive Workflow**:
193
+ - Progressive clarification questions (3-5 at a time)
194
+ - Framework-specific question sets
195
+ - Iterative refinement based on feedback
196
+ - Framework switching capability
197
+ - **Complete Documentation**:
198
+ - 7 comprehensive framework references (500-700 lines each)
199
+ - 7 ready-to-use templates
200
+ - Detailed usage examples
201
+ - Framework selection guide
202
+ - **Analysis Scripts**:
203
+ - `framework_analyzer.py` - Framework recommendation logic
204
+ - `prompt_evaluator.py` - Quality scoring system
205
+ - **Installation Tools**:
206
+ - Automated installation script
207
+ - Multi-platform support (Windows, macOS, Linux)
208
+ - Project and user-wide installation options
209
+
210
+ ### Documentation
211
+ - Comprehensive README with quick start guide
212
+ - Framework selection decision tree
213
+ - Example transformations with scoring
214
+ - Complete API documentation
215
+ - Contributing guidelines
216
+ - MIT License
217
+
218
+ ### Framework Details
219
+ - **CO-STAR**: 600+ lines of documentation with 5 complete examples
220
+ - **RISEN**: 600+ lines with systematic methodology guidance
221
+ - **RISE**: 700+ lines covering both IE and IX variants
222
+ - **TIDD-EC**: 600+ lines with explicit dos/don'ts patterns
223
+ - **RTF**: 500+ lines for simple task structuring
224
+ - **Chain of Thought**: 500+ lines on reasoning techniques
225
+ - **Chain of Density**: 500+ lines on iterative compression
226
+
227
+
228
+
229
+ ---
230
+
231
+ ## Migration Notes
232
+
233
+ ### v1.x → v2.0.0
234
+
235
+ The framework selection system in SKILL.md was completely restructured:
236
+
237
+ - **Old format**: flat "use case → framework" list (20 items)
238
+ - **New format**: 7 intent categories (A–G), each with a discriminating table
239
+
240
+ **Impact on users**: No breaking changes to templates or prompts themselves. The change is in how the skill reasons about which framework to apply. If you have custom tooling that parsed the old flat list format, update it to use the 7-category intent system.
241
+
242
+ **Impact on `framework_analyzer.py`**: Rewritten with intent-based two-phase scoring. If you imported this script directly, the function signatures for `analyze_use_case()` are unchanged but the internal scoring logic is different.
243
+
244
+ ### For v1.0.0 Users
245
+
246
+ - No migration needed for prompts or templates
247
+ - All 27 framework templates are backwards compatible
248
+ - The 7 new frameworks added in v1.1.0–v1.3.0 are additive only
249
+
250
+ ---
251
+
252
+ ## Notes
253
+
254
+ - All dates in format: YYYY-MM-DD
255
+ - Version numbers follow SemVer: MAJOR.MINOR.PATCH
256
+ - [Unreleased] section tracks upcoming changes
257
+ - Each version includes upgrade instructions if needed
258
+
259
+ ## Links
260
+
261
+ - [npm Package](https://www.npmjs.com/package/@ckelsoe/claude-skill-prompt-architect)
262
+ - [GitHub Repository](https://github.com/ckelsoe/claude-skill-prompt-architect)
263
+ - [Issue Tracker](https://github.com/ckelsoe/claude-skill-prompt-architect/issues)
264
+ - [Contributing Guidelines](https://github.com/ckelsoe/claude-skill-prompt-architect/blob/main/README.md#contributing)
package/LICENSE CHANGED
@@ -1,21 +1,21 @@
1
- MIT License
2
-
3
- Copyright (c) 2025 prompt-architect contributors
4
-
5
- Permission is hereby granted, free of charge, to any person obtaining a copy
6
- of this software and associated documentation files (the "Software"), to deal
7
- in the Software without restriction, including without limitation the rights
8
- to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
- copies of the Software, and to permit persons to whom the Software is
10
- furnished to do so, subject to the following conditions:
11
-
12
- The above copyright notice and this permission notice shall be included in all
13
- copies or substantial portions of the Software.
14
-
15
- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
- IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
- FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
- AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
- LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
- OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
- SOFTWARE.
1
+ MIT License
2
+
3
+ Copyright (c) 2025 prompt-architect contributors
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.