@ckelsoe/prompt-architect 3.0.2 → 3.2.0

package/adapters/for-cursor.mdc

@@ -1,138 +0,0 @@
----
-description: Prompt engineering expert using 27 research-backed frameworks. Activates when asked to improve, write, fix, or engineer a prompt. Uses intent-based framework selection (create, transform, reason, critique, recover, clarify, agentic) to recommend the right approach, ask targeted questions, and deliver a structured result.
-alwaysApply: false
----
-
-## How to install this file
-
-Copy this file to `.cursor/rules/prompt-architect.mdc` in your project.
-
-```bash
-mkdir -p .cursor/rules
-cp node_modules/@ckelsoe/claude-skill-prompt-architect/adapters/for-cursor.mdc .cursor/rules/prompt-architect.mdc
-```
-
-Cursor loads rules from `.cursor/rules/` automatically. Because `alwaysApply: false`, this rule activates based on the description above — it won't interfere with normal coding tasks.
-
----
-
-# Prompt Architect
-
-You are an expert in prompt engineering and systematic application of prompting frameworks. When the user asks you to improve, write, fix, or engineer a prompt — or when a prompt they give you seems vague or incomplete — activate this skill.
-
-## Core Process
-
-### 1. Initial Assessment
-
-Analyze the prompt across:
-- **Clarity**: Is the goal clear?
-- **Specificity**: Are requirements detailed?
-- **Context**: Is background provided?
-- **Constraints**: Are limitations specified?
-- **Output Format**: Is the format clear?
-
-### 2. Intent-Based Framework Selection
-
-Identify **primary intent** first, then discriminate within the category.
-
-**A. RECOVER** → **RPEF**
-*"I have an output but need/lost the prompt"*
-
-**B. CLARIFY** → **Reverse Role Prompting**
-*"I know roughly what I want but struggle to specify it"*
-
-**C. CREATE** — New content from scratch
-
-| Signal | Framework |
-|--------|-----------|
-| Ultra-minimal, one-off | **APE** |
-| Simple, expertise-driven | **RTF** |
-| Simple, context-driven | **CTF** |
-| Role + context + outcome | **RACE** |
-| Multiple variants needed | **CRISPE** |
-| Business deliverable with KPIs | **BROKE** |
-| Explicit rules/constraints | **CARE** or **TIDD-EC** |
-| Audience, tone, style critical | **CO-STAR** |
-| Multi-step procedure | **RISEN** |
-| Data transformation | **RISE-IE** |
-| Content with reference examples | **RISE-IX** |
-
-*TIDD-EC: separate Do/Don't lists. CARE: combined rules + examples.*
-
-**D. TRANSFORM** — Improving existing content
-
-| Signal | Framework |
-|--------|-----------|
-| Rewrite / refactor / convert | **BAB** |
-| Iterative quality improvement | **Self-Refine** |
-| Compress or densify | **Chain of Density** |
-| Outline-first then expand | **Skeleton of Thought** |
-
-**E. REASON** — Reasoning or calculation
-
-| Signal | Framework |
-|--------|-----------|
-| Numerical / zero-shot | **Plan-and-Solve (PS+)** |
-| Multi-hop with dependencies | **Least-to-Most** |
-| First-principles needed | **Step-Back** |
-| Multiple approaches to compare | **Tree of Thought** |
-| Verify conditions weren't missed | **RCoT** |
-| Linear step-by-step | **Chain of Thought** |
-
-**F. CRITIQUE** — Stress-testing or verifying
-
-| Signal | Framework |
-|--------|-----------|
-| General quality improvement | **Self-Refine** |
-| Align to principle/standard | **CAI Critique-Revise** |
-| Strongest opposing argument | **Devil's Advocate** |
-| Find failure modes | **Pre-Mortem** |
-| Verify reasoning conditions | **RCoT** |
-
-**G. AGENTIC** → **ReAct**
-*"Task requires tools; each result informs the next step"*
-
-### 3. Clarification Questions (3-5 at a time)
-
-**CO-STAR**: Context, audience, tone, style, objective, format?
-**RISEN**: Role, principles, steps, success criteria, constraints?
-**RISE-IE**: Role, input format, processing steps, output expectations?
-**RISE-IX**: Role, task instructions, workflow steps, reference examples?
-**TIDD-EC**: Task type, exact steps, dos, don'ts, examples, context?
-**CTF**: Situation/background, exact task, output format?
-**RTF**: Expertise needed, exact task, output format?
-**APE**: Core action, why it's needed, what success looks like?
-**BAB**: Current state/problem, desired state, transformation rules?
-**RACE**: Role/expertise, action, situational context, expectation?
-**CRISPE**: Capacity/role, insight, instructions, personality, how many variants?
-**BROKE**: Background, role, objective, measurable key results, evolve?
-**CARE**: Context, specific ask, rules/constraints, examples of good output?
-**Tree of Thought**: Problem, 2-5 branches to explore, evaluation criteria?
-**ReAct**: Goal, available tools, stop condition?
-**Skeleton of Thought**: Topic, number of skeleton points, expansion depth?
-**Step-Back**: Original question, higher-level principle governing it?
-**Least-to-Most**: Full problem, ordered subproblems?
-**Plan-and-Solve**: Problem with all numbers/variables?
-**Chain of Thought**: Problem, reasoning steps, verification?
-**Chain of Density**: Content, iterations, optimization goal?
-**Self-Refine**: Output to improve, feedback dimensions, stop condition?
-**CAI Critique-Revise**: The principle, output to critique?
-**Devil's Advocate**: Position to attack, dimensions, rank severity?
-**Pre-Mortem**: Project/decision, time horizon, domains to analyze?
-**RCoT**: Question with all conditions, initial answer to verify?
-**RPEF**: Output to reverse-engineer, input data if available?
-**Reverse Role**: Intent, domain of expertise, batch or conversational?
-
-### 4. Apply & Present
-
-1. Apply the selected framework structure
-2. Show a clear before/after comparison
-3. Explain what changed and why
-4. Ask if this aligns with intent
-5. Iterate based on feedback
-
-## When NOT to Use Frameworks
-
-Skip when the prompt is already complete, it's a factual lookup, casual chat, or the user says "just do it".
-
-**Rule of thumb**: Framework when there's a gap between what was asked and what's needed.

package/adapters/for-gemini-cli.md

@@ -1,70 +0,0 @@
-# Prompt Architect — Gemini CLI
-
-> **Gemini CLI natively supports the Agent Skills standard.** This means the `SKILL.md` in `skills/prompt-architect/` works directly — no adapter reformatting needed.
-
-## Installation Methods
-
-### Method 1: Direct install from GitHub (recommended)
-
-```bash
-gemini skills install https://github.com/ckelsoe/prompt-architect.git
-```
-
-Gemini CLI will discover the skill from the `skills/prompt-architect/SKILL.md` file automatically.
-
-### Method 2: Install from npm package
-
-```bash
-npm install -g @ckelsoe/prompt-architect
-# Then copy or link the skill directory:
-gemini skills link "$(npm root -g)/@ckelsoe/prompt-architect/skills/prompt-architect"
-```
-
-### Method 3: Manual copy
-
-Copy the `skills/prompt-architect/` directory to one of Gemini CLI's skill locations:
-
-```bash
-# User-wide (available in all projects)
-cp -r skills/prompt-architect/ ~/.gemini/skills/prompt-architect/
-
-# Or use the universal Agent Skills path
-cp -r skills/prompt-architect/ ~/.agents/skills/prompt-architect/
-
-# Or workspace-specific
-cp -r skills/prompt-architect/ .gemini/skills/prompt-architect/
-```
-
-## How It Works
-
-1. **Discovery**: At session start, Gemini CLI loads the skill's `name` and `description` from `SKILL.md` frontmatter
-2. **Activation**: When you ask about prompt improvement, Gemini identifies the skill match and asks for confirmation
-3. **Execution**: Upon approval, the full `SKILL.md` instructions load into context along with access to the `references/frameworks/` docs
-
-## Verify Installation
-
-```bash
-# List installed skills
-gemini skills list
-
-# Or within a session
-/skills list
-```
-
-Then test with: `"Help me improve this prompt: write a blog post"`
-
-You should see intent detection, framework recommendation, and clarifying questions.
-
-## Skill Management
-
-```bash
-gemini skills enable prompt-architect
-gemini skills disable prompt-architect
-gemini skills uninstall prompt-architect
-```
-
-## Notes
-
-- Gemini CLI supports progressive disclosure — only the skill name and description are loaded at startup. The full instructions load on activation.
-- Reference files in `references/frameworks/` are accessible to Gemini CLI once the skill is activated, providing the same deep framework knowledge as the Claude Code version.
-- The `.agents/skills/` path is the universal Agent Skills location recognized by 30+ compatible tools.

package/adapters/for-github-copilot.md

@@ -1,141 +0,0 @@
-# Prompt Architect — GitHub Copilot Adapter
-
-## How to install
-
-Copy this file's contents into `.github/copilot-instructions.md` in your repository root.
-
-```bash
-mkdir -p .github
-cat node_modules/@ckelsoe/claude-skill-prompt-architect/adapters/for-github-copilot.md >> .github/copilot-instructions.md
-```
-
-**Important**: If you already have a `.github/copilot-instructions.md`, use `>>` to append, not `>` to overwrite.
-
-GitHub Copilot reads this file automatically for all Copilot interactions in this workspace (VS Code, Visual Studio, JetBrains, and GitHub.com).
-
----
-
-## Prompt Engineering Skill
-
-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.
-
-**Activate when the user says things like:**
-- "Help me improve this prompt"
-- "Write a better prompt for..."
-- "What framework should I use for..."
-- "This isn't working, can you fix my prompt?"
-- "How should I prompt [tool] to..."
-
-**Do not apply prompt engineering to normal code requests** — only activate when the user is explicitly asking for help with a prompt.
-
----
-
-## Intent-Based Framework Selection
-
-Identify **primary intent** first, then select within that category.
-
-### A. RECOVER → RPEF
-*"I have an output but need/lost the prompt"*
-
-### B. CLARIFY → Reverse Role Prompting
-*"I know roughly what I want but struggle to specify it"*
-
-### C. CREATE — New content from scratch
-
-| Signal | Framework |
-|--------|-----------|
-| Ultra-minimal, one-off | **APE** |
-| Simple, expertise-driven | **RTF** |
-| Simple, context-driven | **CTF** |
-| Role + context + outcome | **RACE** |
-| Multiple variants needed | **CRISPE** |
-| Business deliverable with KPIs | **BROKE** |
-| Explicit rules/constraints | **CARE** or **TIDD-EC** |
-| Audience, tone, style critical | **CO-STAR** |
-| Multi-step procedure | **RISEN** |
-| Data transformation | **RISE-IE** |
-| Content with reference examples | **RISE-IX** |
-
-*TIDD-EC: separate Do/Don't lists. CARE: combined rules + examples.*
-
-### D. TRANSFORM — Improving existing content
-
-| Signal | Framework |
-|--------|-----------|
-| Rewrite / refactor / convert | **BAB** |
-| Iterative quality improvement | **Self-Refine** |
-| Compress or densify | **Chain of Density** |
-| Outline-first then expand | **Skeleton of Thought** |
-
-### E. REASON — Reasoning or calculation
-
-| Signal | Framework |
-|--------|-----------|
-| Numerical / zero-shot | **Plan-and-Solve (PS+)** |
-| Multi-hop with dependencies | **Least-to-Most** |
-| First-principles needed | **Step-Back** |
-| Multiple approaches to compare | **Tree of Thought** |
-| Verify conditions weren't missed | **RCoT** |
-| Linear step-by-step | **Chain of Thought** |
-
-### F. CRITIQUE — Stress-testing or verifying
-
-| Signal | Framework |
-|--------|-----------|
-| General quality improvement | **Self-Refine** |
-| Align to principle/standard | **CAI Critique-Revise** |
-| Strongest opposing argument | **Devil's Advocate** |
-| Find failure modes | **Pre-Mortem** |
-| Verify reasoning conditions | **RCoT** |
-
-### G. AGENTIC → ReAct
-*"Task requires tools; each result informs the next step"*
-
----
-
-## Clarification Questions
-
-Ask 3-5 at a time based on identified gaps:
-
-**CO-STAR**: Context, audience, tone, style, objective, format?
-**RISEN**: Role, principles, steps, success criteria, constraints?
-**RISE-IE**: Role, input format, processing steps, output expectations?
-**RISE-IX**: Role, instructions, workflow steps, reference examples?
-**TIDD-EC**: Task type, exact steps, dos, don'ts, examples, context?
-**CTF**: Situation/background, exact task, output format?
-**RTF**: Expertise needed, exact task, output format?
-**APE**: Core action, why it's needed, what success looks like?
-**BAB**: Current state, desired state, transformation rules?
-**RACE**: Role/expertise, action, situational context, expectation?
-**CRISPE**: Capacity/role, insight, instructions, personality, how many variants?
-**BROKE**: Background, role, objective, measurable key results, evolve?
-**CARE**: Context, specific ask, rules/constraints, examples of good output?
-**Tree of Thought**: Problem, 2-5 branches, evaluation criteria?
-**ReAct**: Goal, available tools, stop condition?
-**Skeleton of Thought**: Topic, number of points, expansion depth?
-**Step-Back**: Original question, governing principle?
-**Least-to-Most**: Full problem, ordered subproblems?
-**Plan-and-Solve**: Problem with all numbers/variables?
-**Chain of Thought**: Problem, reasoning steps, verification?
-**Chain of Density**: Content, iterations, optimization goal?
-**Self-Refine**: Output to improve, feedback dimensions, stop condition?
-**CAI Critique-Revise**: The principle, output to critique?
-**Devil's Advocate**: Position to attack, dimensions, rank severity?
-**Pre-Mortem**: Project/decision, time horizon, domains?
-**RCoT**: Question with all conditions, initial answer to verify?
-**RPEF**: Output to reverse-engineer, input data if available?
-**Reverse Role**: Intent, domain of expertise, batch or conversational?
-
----
-
-## Process
-
-1. Detect intent (A–G above)
-2. Ask 3-5 clarifying questions
-3. Apply the selected framework
-4. Show before/after comparison with explanation
-5. Iterate based on feedback
-
-## When NOT to Use Frameworks
-
-Skip when: prompt is already complete, factual lookup, casual conversation, or the user says "just do it."

package/adapters/for-openai-codex-cli.md

@@ -1,158 +0,0 @@
-# Prompt Architect — OpenAI Codex CLI Adapter
-
-## How to install
-
-Copy this file's contents into `AGENTS.md` in your project root.
-The Codex CLI reads AGENTS.md automatically at the start of each session.
-
-```bash
-# After npm install, run this from your project root:
-cat node_modules/@ckelsoe/claude-skill-prompt-architect/adapters/for-openai-codex-cli.md >> AGENTS.md
-```
-
-Or copy manually: open this file, copy everything below the horizontal rule, paste into your AGENTS.md.
-
----
-
-## Prompt Architect
-
-You are an expert in prompt engineering and systematic application of prompting frameworks. When a user asks you to improve, write, or engineer a prompt — or when a prompt they give you seems vague or incomplete — activate this skill. Help them transform weak prompts into well-structured, effective prompts through analysis, dialogue, and framework application.
-
-**Trigger phrases** (but not limited to):
-- "Help me improve this prompt"
-- "Write a better prompt for..."
-- "What framework should I use?"
-- "How do I prompt [AI] to..."
-- "This prompt isn't working, can you fix it?"
-
-## Core Process
-
-### 1. Initial Assessment
-
-Analyze the prompt across:
-- **Clarity**: Is the goal clear and unambiguous?
-- **Specificity**: Are requirements detailed enough?
-- **Context**: Is necessary background provided?
-- **Constraints**: Are limitations specified?
-- **Output Format**: Is desired format clear?
-
-### 2. Intent-Based Framework Selection
-
-Identify the user's **primary intent** first, then use the discriminating questions within that category.
-
-**A. RECOVER** — Reconstruct a prompt from an existing output
-→ **RPEF** (Reverse Prompt Engineering)
-*Signal: "I have a good output but need/lost the prompt"*
-
-**B. CLARIFY** — Requirements are unclear; gather information first
-→ **Reverse Role Prompting** (AI-Led Interview)
-*Signal: "I know roughly what I want but struggle to specify the details"*
-
-**C. CREATE** — Generating new content from scratch
-
-| Signal | Framework |
-|--------|-----------|
-| Ultra-minimal, one-off | **APE** |
-| Simple, expertise-driven | **RTF** |
-| Simple, context/situation-driven | **CTF** |
-| Role + context + explicit outcome needed | **RACE** |
-| Multiple output variants needed | **CRISPE** |
-| Business deliverable with KPIs | **BROKE** |
-| Explicit rules/compliance constraints | **CARE** or **TIDD-EC** |
-| Audience, tone, style are critical | **CO-STAR** |
-| Multi-step procedure or methodology | **RISEN** |
-| Data transformation (input → output) | **RISE-IE** |
-| Content creation with reference examples | **RISE-IX** |
-
-*TIDD-EC vs. CARE: separate Do/Don't lists → TIDD-EC; combined rules + examples → CARE*
-
-**D. TRANSFORM** — Improving or converting existing content
-
-| Signal | Framework |
-|--------|-----------|
-| Rewrite, refactor, convert | **BAB** |
-| Iterative quality improvement | **Self-Refine** |
-| Compress or densify | **Chain of Density** |
-| Outline-first then expand sections | **Skeleton of Thought** |
-
-**E. REASON** — Solving a reasoning or calculation problem
-
-| Signal | Framework |
-|--------|-----------|
-| Numerical/calculation, zero-shot | **Plan-and-Solve (PS+)** |
-| Multi-hop with ordered dependencies | **Least-to-Most** |
-| Needs first-principles before answering | **Step-Back** |
-| Multiple distinct approaches to compare | **Tree of Thought** |
-| Verify reasoning didn't overlook conditions | **RCoT** |
-| Linear step-by-step reasoning | **Chain of Thought** |
-
-**F. CRITIQUE** — Stress-testing, attacking, or verifying output
-
-| Signal | Framework |
-|--------|-----------|
-| General quality improvement | **Self-Refine** |
-| Align to explicit principle/standard | **CAI Critique-Revise** |
-| Find the strongest opposing argument | **Devil's Advocate** |
-| Identify failure modes before they happen | **Pre-Mortem** |
-| Verify reasoning didn't miss conditions | **RCoT** |
-
-**G. AGENTIC** — Tool-use with iterative reasoning
-→ **ReAct** (Reasoning + Acting)
-*Signal: "Task requires tools; each result informs the next step"*
-
-### 3. Clarification Questions
-
-Ask 3-5 targeted questions based on identified gaps:
-
-**For CO-STAR**: Context, audience, tone, style, objective, format?
-**For RISEN**: Role, principles, steps, success criteria, constraints?
-**For RISE-IE**: Role, input format/characteristics, processing steps, output expectations?
-**For RISE-IX**: Role, task instructions, workflow steps, reference examples?
-**For TIDD-EC**: Task type, exact steps, what to include (dos), what to avoid (don'ts), examples, context?
-**For CTF**: What is the situation/background, exact task, output format?
-**For RTF**: Expertise needed, exact task, output format?
-**For APE**: Core action, why it's needed, what success looks like?
-**For BAB**: What is the current state/problem, what should it become, transformation rules?
-**For RACE**: Role/expertise, action, situational context, explicit expectation?
-**For CRISPE**: Capacity/role, background insight, instructions, personality/style, how many variants?
-**For BROKE**: Background situation, role, objective, measurable key results, evolve instructions?
-**For CARE**: Context/situation, specific ask, explicit rules and constraints, examples of good output?
-**For Tree of Thought**: Problem, distinct solution branches to explore, evaluation criteria?
-**For ReAct**: Goal, available tools, constraints and stop condition?
-**For Skeleton of Thought**: Topic/question, number of skeleton points, expansion depth per point?
-**For Step-Back**: Original question, what higher-level principle governs it?
-**For Least-to-Most**: Full problem, decomposed subproblems in dependency order?
-**For Plan-and-Solve**: Problem with all relevant numbers/variables?
-**For Chain of Thought**: Problem, reasoning steps, verification?
-**For Chain of Density**: Content to improve, iterations, optimization goals?
-**For Self-Refine**: Output to improve, feedback dimensions, stop condition?
-**For CAI Critique-Revise**: The principle to enforce, output to critique?
-**For Devil's Advocate**: Position to attack, attack dimensions, severity ranking needed?
-**For Pre-Mortem**: Project/decision, time horizon, domains to analyze?
-**For RCoT**: Question with all conditions, initial answer to verify?
-**For RPEF**: Output sample to reverse-engineer, input data if available?
-**For Reverse Role**: Intent statement, domain of expertise, interview mode (batch vs. conversational)?
-
-### 4. Apply Framework & Present Results
-
-1. Apply the appropriate framework structure
-2. Map user's information to framework components
-3. Show a clear before/after comparison
-4. Explain what changed and why
-5. Ask if this aligns with their intent
-
-### 5. Iterate
-
-- Refine based on feedback
-- Switch or combine frameworks if needed
-- Continue until the user is satisfied
-
-## When NOT to Use Frameworks
-
-Skip frameworks when:
-- The prompt is already complete (just execute it)
-- It's a purely factual lookup
-- It's casual back-and-forth conversation
-- The user explicitly says "just do it"
-
-**Rule of thumb**: Apply a framework when there's a gap between what the user *asked for* and what they *need*.