@ckelsoe/prompt-architect 3.2.2 → 3.4.0

package/.claude-plugin/marketplace.json

@@ -5,14 +5,14 @@
     "email": "charles@kelsoe.com"
   },
   "metadata": {
-    "description": "Prompt engineering skill using 27 research-backed frameworks across 7 intent categories"
+    "description": "Prompt engineering skill using 29 frameworks across 7 intent categories"
   },
   "plugins": [
     {
       "name": "prompt-architect",
       "source": "./",
-      "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).",
-      "version": "3.2.1",
+      "description": "Analyzes and improves prompts using 29 frameworks. Intent-based selection routes to the right framework — from ultra-minimal (APE) to agentic (ReAct).",
+      "version": "3.4.0",
       "keywords": ["prompt-engineering", "prompt-frameworks", "agent-skills"],
       "category": "productivity"
     }

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "prompt-architect",
-  "description": "27-framework prompt engineering skill for analyzing and improving prompts across 7 intent categories",
-  "version": "3.2.2",
+  "description": "29-framework prompt engineering skill for analyzing and improving prompts across 7 intent categories",
+  "version": "3.4.0",
   "author": {
     "name": "Charles Kelsoe",
     "email": "charles@kelsoe.com"

package/CHANGELOG.md

@@ -5,6 +5,136 @@ All notable changes to the Prompt Architect Claude Code skill will be documented
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [3.4.0] - 2026-07-22
+
+This release makes the **emission contract** explicit and consistent across the whole skill. When Prompt Architect delivers the final prompt, framework section headers (`CONTEXT:`, `ROLE:`, `BEFORE:`, …) are stripped — the user pastes a flat block of prose with no labels. Previously the framework docs and templates were written as if those headers would survive, so slots that were bare fragments ("meeting summary", "busy professionals") lost their meaning once the header was removed. Every framework now carries its own meaning in prose.
+
+### Added
+- **Optional `SOURCE MATERIAL` block on every template that operates on an artifact.** It names the artifact concretely (never a generic "content"), ties it to the task with one carrier sentence, and self-deletes for from-scratch tasks. Three frameworks are deliberately exempt because they have no pasted-material slot: **ReAct** (material arrives as live tool output), **Reverse Role** (everything is gathered through the interview), and **RISE-IX** (its samples land in the EXAMPLES slot).
+- **Emission-contract test guard.** `scripts/test.js` now fails if the load-bearing output-delivery rules (no section headers in the deliverable, paste-verbatim, "revised prompt is last element", the negation-survival and no-defaulting rules, and the worked example obeying them) diverge between `SKILL.md` and `adapters/system-prompt.md`. The prior drift checks compared only step headings and framework names, so prose drift — like the adapter shipping a BAB example *with* `BEFORE:/AFTER:/BRIDGE:` headers — passed silently.
+
+### Changed
+- **All 28 framework reference docs rewritten for the emission contract.** Each Overview now states how the framework emits; each component's guidance says whether its slot must be a complete sentence or ships inside a carrier sentence; and every Complete Example is shown in emitted form — with the `SOURCE MATERIAL` block, "the … above" references, and at least one from-scratch variant showing the block deleted. Origin/citation facts were preserved verbatim throughout.
+- **Elicitation questions in `SKILL.md` and the adapter now ask for the user's own material** ("Paste the Q3 revenue report here", "paste 2-3 actual samples whose style should be matched") instead of one-word checklists ("Context, audience, tone?"). A framework that operates on an artifact and never asks for it will otherwise invent one. The material-question exemptions above are documented inline.
+- **APE loses its collapsed single-sentence form.** The two inconsistent inline syntaxes it advertised were never implemented by the template and break when source material or multi-clause expectations are present; the doc now explains why. A complete APE prompt is still three sentences.
+- **`RISE` → `RISE-IE` in cross-references.** Docs that pointed to RISE as the input-transformation framework now use the skill's `RISE-IE` shorthand consistently. `RISEN` references are unchanged.
+
+### Fixed
+- **`RACE` examples no longer dangle.** Two examples referenced material "described below" when the `SOURCE MATERIAL` block places it above; they now say "above", matching the template's positioning rule.
+
+---
+
+## [3.3.1] - 2026-07-19
+
+### Fixed
+- **Publishing was broken before this release and would have failed for any version.** `.github/workflows/publish.yml` pinned Node 20 while running `npm install -g npm@latest`; once npm 12 shipped (requiring `^22.22.2 || ^24.15.0 || >=26`), that step failed with `EBADENGINE` before the publish ran. The workflow now uses Node 24. This is why 3.3.0 has no published artifact — its tag exists, but the release never completed.
+
+*All 3.3.0 changes below are included in this release.*
+
+---
+
+## [3.3.0] - 2026-07-19
+
+### Added
+- **Chain of Density is now the real method.** `chain-of-density.md` was rewritten around entity densification at *fixed* length, scoped to summarization, and cited to Adams et al., "From Sparse to Dense" (arXiv 2309.04269, NewSum @ EMNLP 2023). The previous content described generic progressive shortening — the opposite of the published technique, which holds length constant.
+- **New framework: Iterative Compression.** The general multi-pass shortening technique that used to be filed under Chain of Density is preserved as its own framework, with its own reference doc and template, and is no longer attributed to CoD. Framework count is now 29.
+- **Quality scoring is implemented.** `SKILL.md` and `adapters/system-prompt.md` now instruct the model to score prompts 1-10 on the five dimensions the README advertises — Clarity, Specificity, Context, Completeness, Structure — with rubric anchors defining the 1-3 / 4-6 / 7-8 / 9-10 bands. Previously this was advertised in three places and implemented in none, and the skill's dimension list disagreed with the README's.
+- **Framework combination guidance.** A "Combining Frameworks" section with concrete pairings (CO-STAR + Self-Refine, RISEN + ReAct, BROKE + Devil's Advocate) that finally routes to `hybrid_template.txt`, previously the only template with no path leading to it.
+- **Self-Consistency citation and a corrected template** in `chain-of-thought.md`, now citing Wang et al. (arXiv 2203.11171, ICLR 2023) and describing a real majority vote over independently sampled reasoning paths rather than asking the model to judge which of three different approaches it liked best.
+- **Origin lines for 10 previously uncited frameworks**: CO-STAR, Chain-of-Thought, RISEN, APE, RTF, CTF, RACE, BAB, plus corrected provenance for RISE and TIDD-EC.
+- **Acronym-collision disambiguation** for APE (vs. "Automatic Prompt Engineer," Zhou et al., arXiv 2211.01910) and RACE (vs. Dave Chaffey's 2010 Reach-Act-Convert-Engage marketing model).
+
+### Changed
+- **Provenance is now stated honestly per framework.** Frameworks with peer-reviewed backing cite it; community conventions say so plainly rather than leaving a silent gap. CO-STAR is credited to GovTech Singapore's Data Science & AI team — as Sheila Teo's own article does — rather than to Teo, who popularized it.
+- `rise.md`: "RISE-IE" and "RISE-IX" are now labeled as this skill's internal shorthand, not established terminology. RISE-IX is identified as our own composition; its three previously cited sources do not support it. `ctf.md` no longer propagates "RISE-IE" as if it were standard vocabulary.
+- `tidd-ec.md`: dropped the "originally documented alongside CO-STAR" claim, which implied a shared provenance that does not exist, and reassessed its three "authoritative sources" as one origin post, one same-organization republication, and one passing mention.
+- `SKILL.md` step numbering fixed — it had two sections numbered `### 4.` and now runs 1-7, matching the adapter.
+- `SKILL.md` template section reduced from a 30-line filename listing to one line; filenames are mechanically derivable.
+- Installer `--force` now does something: it is required to replace a **symlinked** install path, which previously was deleted without warning.
+
+### Fixed
+- **Installer no longer installs to Claude Code only.** Mode 5 (the `postinstall` path most users hit) and Mode 3 (`--yes`) now install to every detected agent, as documented. Mode 5 previously hard-skipped every agent but Claude and ignored `detect()` entirely.
+- **Windsurf adapter no longer duplicates itself.** A fresh `.windsurfrules` was written without marker comments, so the next run could not find or remove it and appended a second copy; the marker-stripping regex also lacked the `g` flag. Verified stable across repeated installs.
+- **`--project` is no longer ignored** for the Gemini and universal Agent Skills targets — only the Claude entry honored it.
+- **`engines.node` raised to `>=20.19.0`.** It declared `>=14.0.0`, but `@clack/prompts@1.1.0` is ESM-only, so `require()` of it throws `ERR_REQUIRE_ESM` below 20.19 — the headline `npx` experience failed across most of the declared range with a bare "Installation error". The CI matrix floor was raised to match.
+- **Step-Back statistic corrected**: MuSiQue is +7%, not +25% (a 3.5x overstatement); MMLU is +7% Physics / +11% Chemistry, not a "7-27% range."
+- **Socratic Prompting citation corrected**: single author Edward Y. Chang, IEEE CCWC 2023 — not "Chang et al." and not EMNLP/NAACL.
+- **Pre-Mortem attribution corrected**: the ~30% finding belongs to Mitchell, Russo & Pennington (1989), popularized by Gary Klein (HBR 2007); it measures identification of "reasons for future outcomes" against a might-happen framing, not "failure causes" against forward risk analysis. The unsupported "Brookings Institution" affiliation was removed.
+- **Skeleton-of-Thought quality claim qualified**: parity in roughly 60% of cases, with degradation on writing, math, and coding — previously "maintained or improved quality."
+- **Constitutional AI claim scoped**: the critique-before-revision effect is strongest for smaller models; the authors found no noticeable difference at 52B and kept critiques for transparency.
+- README no longer instructs users to create an `.npmrc` and a GitHub token for a registry the package is not published to. It is on public npm and needs no authentication.
+- README: duplicate `## Quick Start` heading renamed to `## Verifying Your Installation` (the table of contents anchor resolved to the wrong section), and the TOC completed.
+
+### Removed
+- `framework_analyzer.py` and `prompt_evaluator.py` (~50 KB). Nothing invoked them, they had no CLI, and `framework_analyzer.py` had already drifted — its header read "all 27" above a 28-entry dict. Their scoring dimensions were carried into the SKILL.md rubric before removal.
+- `.github/workflows/version-bump.yml`. It ran `npm version`, which updates only `package.json`, then immediately pushed the tag — landing a broken release tag on the remote before anyone could intervene.
+
+### Validation
+- `validate-skill.js` now derives framework and template checks from the filesystem instead of a hardcoded 7-entry subset, cross-checks `claudeCode.frameworks` against what is on disk, and **asserts every advertised framework count agrees with reality**. This is the check whose absence let "27" ship while 28 frameworks existed.
+- `validate-skill.js` now verifies **all five version sites** — `package.json`, `claudeCode.version`, `plugin.json`, `marketplace.json`, and `SKILL.md` frontmatter. It previously checked only `plugin.json`, and did not check SKILL.md's version at all, despite documentation claiming otherwise.
+- `test.js` gained a **drift guard** asserting `SKILL.md` and `adapters/system-prompt.md` keep identical step headings, sequential numbering, and the same framework set. These two files are hand-maintained copies and had already diverged.
+
+---
+
+## [3.2.2] - 2026-03-30
+
+### Added
+- Prominent Quick Start at the top of the README with the `npx @ckelsoe/prompt-architect` command
+- Codex CLI installation instructions via `$skill-installer install`
+- `/install-skill` documented as the primary Claude Code installation method, with the plugin marketplace commands retained for update support
+
+### Changed
+- README installation section consolidated: separate per-tool sections for Gemini CLI and for Cursor/Copilot/Windsurf/Codex were replaced by a single "Other Agents" section pointing at `~/.agents/skills/`
+- npm demoted to an alternative installation method
+
+### Fixed
+- `.claude-plugin/plugin.json` and `.claude-plugin/marketplace.json` versions brought back in sync with `package.json`; both had been left behind at 3.2.1
+
+---
+
+## [3.2.1] - 2026-03-24
+
+### Fixed
+- **Direct download link for ChatGPT**: the `.skill` link now points at `releases/latest/download/prompt-architect.skill` rather than the releases page, making it a one-click download
+- **Nothing after the revised prompt**: SKILL.md now states explicitly that no text may follow the closing backticks — the revised prompt must be the last element of the response. The example interaction was updated to comply.
+
+### Changed
+- `prompt-architect.skill` removed from git tracking and added to a new `.gitignore` alongside `node_modules/`. It is a build artifact produced by `npm run build:skill` and attached to releases by CI.
+
+---
+
+## [3.2.0] - 2026-03-24
+
+### Changed
+- **SKILL.md "Present Improvements" restructured for copy-pasteable output.** Responses now follow a fixed order: (A) analysis — framework selected, changes made, components applied; (B) a usage-instructions block explaining how to use the prompt in a new chat or the same chat; (C) the revised prompt last, in a fenced code block.
+- **The revised prompt is now clean flat text**: no framework section headers (`BEFORE:`, `BRIDGE:`, `CONTEXT:`), no gratuitous indentation, and no internal markdown unless the prompt genuinely requires it — so it can be copied verbatim with zero editing.
+- Example interaction rewritten to model the new output structure
+- Version synced across SKILL.md, `package.json`, `plugin.json`, and `marketplace.json`
+
+---
+
+## [3.1.1] - 2026-03-24
+
+### Fixed
+- **CI pipeline**: committed `package-lock.json` so `npm ci` works, and removed the unreliable `npm ci || npm install` fallback
+- Test matrix moved to Node 18/20/22; Node 14/16 dropped, as `@clack/prompts` requires a newer runtime
+
+---
+
+## [3.1.0] - 2026-03-24
+
+> The 3.x restructure described in the `[3.0.0]` entry below shipped across the 3.0.x line and landed in git under the `v3.1.0` tag. The items here are the parts of that work not already listed there.
+
+### Added
+- **`.skill` builder**: `scripts/build-skill.js` and `npm run build:skill` produce a ZIP for ChatGPT upload
+- **`bin` entry**: `npx @ckelsoe/prompt-architect` runs the installer directly
+
+### Changed
+- `package.json` `files` array now ships `skills/`, `.claude-plugin/`, and `MIGRATION.md`
+- Removed the obsolete adapters `for-cursor.mdc`, `for-github-copilot.md`, and `for-openai-codex-cli.md` — those tools read `SKILL.md` natively. Only `system-prompt.md` (universal) and `for-windsurf.md` remain.
+
+---
+
 ## [3.0.0] - 2026-03-24
 
 ### Breaking Changes
@@ -14,7 +144,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 - **Claude Code Plugin System support**: `.claude-plugin/plugin.json` and `marketplace.json` — install via `/plugin marketplace add` and `/plugin install`
 - **Gemini CLI support**: Native Agent Skills compatibility. Install via `gemini skills install`
-- **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
+- **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, Zoo Code, Amp, OpenHands, and more
 - **Interactive multi-agent installer**: Detects installed AI agents (Claude Code, Gemini CLI, Cursor, Copilot, Windsurf, Codex) and presents a selection UI using @clack/prompts
 - **Universal install path**: `~/.agents/skills/` for Agent Skills standard compatible tools
 - **CLI flags**: `--all`, `--claude`, `--gemini`, `--agents`, `--cursor`, `--copilot`, `--windsurf`, `--codex`, `--yes`
@@ -258,7 +388,7 @@ The framework selection system in SKILL.md was completely restructured:
 
 ## Links
 
-- [npm Package](https://www.npmjs.com/package/@ckelsoe/claude-skill-prompt-architect)
-- [GitHub Repository](https://github.com/ckelsoe/claude-skill-prompt-architect)
-- [Issue Tracker](https://github.com/ckelsoe/claude-skill-prompt-architect/issues)
-- [Contributing Guidelines](https://github.com/ckelsoe/claude-skill-prompt-architect/blob/main/README.md#contributing)
+- [npm Package](https://www.npmjs.com/package/@ckelsoe/prompt-architect)
+- [GitHub Repository](https://github.com/ckelsoe/prompt-architect)
+- [Issue Tracker](https://github.com/ckelsoe/prompt-architect/issues)
+- [Contributing Guidelines](https://github.com/ckelsoe/prompt-architect/blob/main/README.md#contributing)

package/MIGRATION.md

@@ -54,7 +54,7 @@ skills/prompt-architect/SKILL.md
 
 ### The skill itself is unchanged
 
-The `SKILL.md` content, all 27 frameworks, reference docs, and templates are identical. Only the packaging and distribution have changed.
+The `SKILL.md` content, all framework reference docs, and all templates are identical. Only the packaging and distribution have changed.
 
 ## GitHub Repository
 

package/README.md

@@ -1,10 +1,10 @@
 # Prompt Architect
 
-Transform vague prompts into expert-level, structured prompts using 27 research-backed frameworks across 7 intent categories.
+Transform vague prompts into expert-level, structured prompts using 29 frameworks across 7 intent categories.
 
 Works with **Claude Code, ChatGPT, Gemini CLI, Cursor, GitHub Copilot, Windsurf, OpenAI Codex**, and [30+ Agent Skills compatible tools](https://agentskills.io).
 
-[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![npm](https://img.shields.io/npm/v/@ckelsoe/prompt-architect)](https://www.npmjs.com/package/@ckelsoe/prompt-architect) [![Agent Skills](https://img.shields.io/badge/Agent%20Skills-compatible-blue)](https://agentskills.io)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![npm](https://img.shields.io/npm/v/@ckelsoe/prompt-architect)](https://www.npmjs.com/package/@ckelsoe/prompt-architect) [![Agent Skills](https://img.shields.io/badge/Agent%20Skills-compatible-blue)](https://agentskills.io) [![Available on CodeGuilds](https://img.shields.io/badge/Available_on-CodeGuilds-6366f1)](https://codeguilds.dev/packages/prompt-architect)
 
 ## Quick Start
 
@@ -14,9 +14,9 @@ npx @ckelsoe/prompt-architect
 
 The interactive installer detects your AI agents (Claude Code, Gemini CLI, Cursor, Copilot, Codex, and more) and lets you choose where to install.
 
-> **Important:** Use `npx`, not `npm install`. The `npx` command runs the interactive multi-agent installer. Running `npm install` will only install to Claude Code silently via the postinstall hook.
+> **Tip:** Use `npx` rather than `npm install`. Both work — `npm install` runs the same installer via the postinstall hook and installs to every agent it detects — but only `npx` gives you the interactive menu to choose specific targets.
 
-> Requires `.npmrc` with `@ckelsoe:registry=https://npm.pkg.github.com` and a GitHub token with `read:packages` scope.
+> Published on the public npm registry. **No authentication required.**
 
 ---
 
@@ -28,11 +28,14 @@ The interactive installer detects your AI agents (Claude Code, Gemini CLI, Curso
 - [Supported Frameworks](#supported-frameworks)
 - [Quick Start](#quick-start)
 - [Installation](#installation)
+- [Verifying Your Installation](#verifying-your-installation)
+- [Updating](#updating)
 - [Usage](#usage)
 - [Framework Selection Guide](#framework-selection-guide)
 - [Project Structure](#project-structure)
 - [Documentation](#documentation)
 - [Contributing](#contributing)
+- [Support](#support)
 - [License](#license)
 
 ---
@@ -57,7 +60,7 @@ Prompt Architect is an [Agent Skills](https://agentskills.io) compatible skill t
 
 ## Key Features
 
-### 27 Research-Backed Frameworks Across 7 Intent Categories
+### 29 Frameworks Across 7 Intent Categories
 
 | Framework | Best For | Complexity |
 |-----------|----------|------------|
@@ -81,7 +84,8 @@ Prompt Architect is an [Agent Skills](https://agentskills.io) compatible skill t
 | **Least-to-Most** | Compositional multi-hop problems (simplest first) | Medium |
 | **Plan-and-Solve (PS+)** | Zero-shot numerical/calculation reasoning | Low |
 | **Chain of Thought** | Reasoning, problem-solving | Medium |
-| **Chain of Density** | Iterative refinement, summarization | Medium |
+| **Chain of Density** | Summarization at fixed length, maximum information density | Medium |
+| **Iterative Compression** | Shortening text toward a target length | Low |
 | **Self-Refine** | Iterative output quality improvement (any task) | Medium |
 | **CAI Critique-Revise** | Principle-based critique and revision (Anthropic) | Medium |
 | **Devil's Advocate** | Strongest opposing argument against a position | Low |
@@ -457,7 +461,7 @@ RESPONSE FORMAT:
 **Best for:** Identifying specific failure causes before they happen
 
 **Approach:** Assume the project has already failed → describe the failure → work backwards to specific causes with warning signs
-**Research:** Gary Klein's prospective hindsight — ~30% improvement over forward risk analysis
+**Research:** Mitchell, Russo & Pennington (1989), popularized by Gary Klein (HBR 2007) — prospective hindsight improves identification of reasons for future outcomes by ~30%; LLM application is practitioner-level, with no dedicated AI paper
 
 **Example Use Cases:** Project kickoffs, product launches, technical migrations, high-stakes strategic decisions
 
@@ -558,23 +562,33 @@ Choose the method that matches your AI tool:
 
 ### Claude Code
 
-**Option A: Plugin system (recommended)**
+```
+/install-skill https://github.com/ckelsoe/prompt-architect/tree/main/skills/prompt-architect
+```
+
+**Plugin system (enables updates):**
 ```
 /plugin marketplace add ckelsoe/prompt-architect
 /plugin install prompt-architect@prompt-architect-marketplace
 ```
 
-**Option B: npm**
-```bash
-npm install -g @ckelsoe/prompt-architect
+### Codex CLI
+
+```
+$skill-installer install https://github.com/ckelsoe/prompt-architect/tree/main/skills/prompt-architect
 ```
-The installer runs automatically and copies the skill to `~/.claude/skills/`. Restart Claude Code to load it.
 
-**Option C: Interactive multi-agent installer**
+### Other Agents (Gemini, Cursor, Copilot, Cline, Zoo Code, etc.)
+
+Copy `skills/prompt-architect/` from this repo to `~/.agents/skills/prompt-architect/`
+
+### npm (alternative)
+
 ```bash
 npx @ckelsoe/prompt-architect
 ```
-Detects all installed AI agents and lets you choose where to install.
+
+Installs to both `.claude/skills/` and `.agents/skills/` in one step.
 
 ### ChatGPT
 
@@ -585,30 +599,6 @@ ChatGPT natively supports [Agent Skills](https://agentskills.io). Available on B
 3. Click **New skill** → **Upload from your computer**
 4. Upload the `.skill` file
 
-### Gemini CLI
-
-```bash
-gemini skills install https://github.com/ckelsoe/prompt-architect.git
-```
-
-Or manually: copy `skills/prompt-architect/` to `~/.gemini/skills/prompt-architect/`
-
-### Cursor, Copilot, Windsurf, Codex CLI
-
-Use the interactive installer to auto-detect and install:
-```bash
-npx @ckelsoe/prompt-architect
-```
-
-Or copy `skills/prompt-architect/` to your tool's skills directory. All of these tools support the [Agent Skills standard](https://agentskills.io) natively:
-
-| Tool | Skills directory |
-|------|----------------|
-| **Cursor** | `.agents/skills/` or `.cursor/skills/` (project) |
-| **GitHub Copilot** | `.github/skills/` or `~/.copilot/skills/` |
-| **OpenAI Codex** | `.agents/skills/` (project) or `~/.agents/skills/` |
-| **VS Code, Roo Code, Kiro, Amp, Junie, Goose, 30+ others** | `~/.agents/skills/` (universal) |
-
 ### Windsurf
 
 Windsurf does not yet support Agent Skills natively:
@@ -624,7 +614,7 @@ See [`adapters/README.md`](adapters/README.md) for detailed instructions for eac
 
 ---
 
-## Quick Start
+## Verifying Your Installation
 
 After installing, test with:
 
@@ -851,11 +841,7 @@ prompt-architect/
 ├── LICENSE                            # MIT License
 │
 └── prompt-architect/                  # The skill
-    ├── SKILL.md                       # Core skill instructions (5 KB)
-    │
-    ├── scripts/                       # Analysis Utilities
-    │   ├── framework_analyzer.py      # Framework recommendation logic
-    │   └── prompt_evaluator.py        # Quality scoring system
+    ├── SKILL.md                       # Core skill instructions
     │
     ├── references/                    # Framework Documentation
     │   └── frameworks/                # Loaded on-demand
@@ -922,9 +908,8 @@ prompt-architect/
 
 **Core Components:**
 - **SKILL.md** - Main skill logic and instructions (intent-based selection system)
-- **27 Framework Docs** - Complete references with examples
-- **29 Templates** - Ready-to-use structures (27 frameworks + hybrid + chain variants)
-- **2 Python Scripts** - Analysis and scoring utilities
+- **Framework Reference Docs** - 28 files covering all 29 frameworks, with examples (RISE documents two variants)
+- **Templates** - 30 ready-to-use structures: one per framework, plus `hybrid_template.txt` for combinations
 
 ---
 

package/adapters/README.md

@@ -19,7 +19,7 @@ These tools read `SKILL.md` natively. No adapter needed — just install to thei
 | **GitHub Copilot** | Copy `skills/prompt-architect/` to `.github/skills/` or `~/.copilot/skills/` |
 | **OpenAI Codex** | Copy `skills/prompt-architect/` to `.agents/skills/` in your project |
 | **VS Code** | Copy `skills/prompt-architect/` to `.agents/skills/` in your project |
-| **Roo Code** | Copy `skills/prompt-architect/` to `.agents/skills/` or `~/.agents/skills/` |
+| **Zoo Code** | Copy `skills/prompt-architect/` to `.agents/skills/` or `~/.agents/skills/` |
 | **Kiro, Amp, Junie, Goose, OpenHands, etc.** | Copy to `~/.agents/skills/` (universal path) |
 
 Or use the interactive installer to auto-detect and install: