@ckelsoe/prompt-architect 3.3.1 → 3.5.0

package/skills/prompt-architect/references/frameworks/co-star.md

@@ -2,14 +2,14 @@
 
 ## Overview
 
-CO-STAR is a comprehensive prompting framework that emphasizes context, audience, and communication style. It's particularly effective for content creation, writing tasks, and scenarios where tone and audience considerations significantly impact output quality.
+CO-STAR is a comprehensive prompting framework that emphasizes context, audience, and communication style. It's particularly effective for content creation, writing tasks, and scenarios where tone and audience considerations significantly impact output quality. Section headers are stripped at emission, so a CO-STAR prompt lands as a flat block of prose — a paragraph of context, a stated objective, and self-standing sentences for style, tone, audience, and response format — preceded by an optional source-material block whenever the content is built from an artifact the user already has. Because the `STYLE`, `TONE`, and `AUDIENCE` labels do not survive, those slots have to be written as complete sentences rather than the bare descriptors ("professional yet friendly," "senior executives") they would otherwise collapse to.
 
 **Origin:** Developed by the Data Science & AI team at GovTech (Government Technology Agency of Singapore), and popularized by Sheila Teo, who won GovTech's "Prompt Royale" — Singapore's first GPT-4 prompt engineering competition, 400+ participants, finale 8 November 2023. Teo credits the framework to GovTech rather than to herself: "The CO-STAR framework, a brainchild of GovTech Singapore's Data Science & AI team, is a handy template for structuring prompts." Practitioner framework — no controlled evaluation of CO-STAR has been published.
 
 ## Components
 
 ### C - Context
-**Purpose:** Provide background information, situational details, and constraints.
+**Purpose:** Provide background information, situational details, and constraints. It fills as a self-contained paragraph and survives header stripping on its own, so long as it reads as description of a situation rather than a bare label.
 
 **Questions to Ask:**
 - What's the background situation?
@@ -19,12 +19,12 @@ CO-STAR is a comprehensive prompting framework that emphasizes context, audience
 - Are there any limitations or restrictions?
 
 **Examples:**
-- "You're working with a startup that has limited resources..."
-- "This is for a formal government report..."
-- "The user base is primarily non-technical..."
+- "You're working with a startup that has limited resources."
+- "This is for a formal government report."
+- "The user base is primarily non-technical."
 
 ### O - Objective
-**Purpose:** Define the clear, specific goal to be achieved.
+**Purpose:** Define the clear, specific goal to be achieved, as one complete imperative sentence. Nothing else in the prompt states the task, so once the `OBJECTIVE` header is gone a bare goal fragment leaves the emitted prompt without an instruction.
 
 **Questions to Ask:**
 - What exactly do you want accomplished?
@@ -33,12 +33,12 @@ CO-STAR is a comprehensive prompting framework that emphasizes context, audience
 - Are there secondary goals?
 
 **Examples:**
-- "Create a comprehensive product comparison..."
-- "Generate ideas for reducing customer churn..."
-- "Explain the concept in simple terms..."
+- "Create a comprehensive product comparison of the three tools above."
+- "Generate ideas for reducing customer churn."
+- "Explain the concept in simple terms."
 
 ### S - Style
-**Purpose:** Specify the writing style, format, and structural preferences.
+**Purpose:** Specify the writing style, format, and structural preferences. Phrase it as an instruction ("Write in…", "Follow…"), not a bare descriptor, because the `STYLE` header is stripped and a fragment like "journalistic, short paragraphs" no longer reads as a directive on its own.
 
 **Questions to Ask:**
 - What writing style is appropriate?
@@ -48,12 +48,12 @@ CO-STAR is a comprehensive prompting framework that emphasizes context, audience
 - Any style guides to follow?
 
 **Examples:**
-- "Use a journalistic style with short paragraphs..."
-- "Follow AP style guidelines..."
-- "Write in a conversational, blog-post style..."
+- "Use a journalistic style with short paragraphs."
+- "Follow AP style guidelines."
+- "Write in a conversational, blog-post style."
 
 ### T - Tone
-**Purpose:** Set the emotional quality and attitude of the response.
+**Purpose:** Set the emotional quality and attitude of the response. Because the `TONE` header does not survive emission, write the slot as a complete sentence ("Keep the tone…", "Sound…") — a bare adjective phrase like "professional yet friendly" dangles once the label is deleted.
 
 **Questions to Ask:**
 - What emotional quality should it have?
@@ -62,13 +62,13 @@ CO-STAR is a comprehensive prompting framework that emphasizes context, audience
 - Urgent or measured?
 
 **Examples:**
-- "Professional yet friendly..."
-- "Urgent and action-oriented..."
-- "Empathetic and supportive..."
-- "Confident and authoritative..."
+- "Keep the tone professional yet friendly."
+- "Make it urgent and action-oriented."
+- "Keep it empathetic and supportive."
+- "Sound confident and authoritative."
 
 ### A - Audience
-**Purpose:** Identify who will consume the output and their characteristics.
+**Purpose:** Identify who will consume the output and their characteristics. Name the audience in a complete sentence ("The audience is…"), because the `AUDIENCE` header is stripped and a bare noun phrase like "senior executives" would otherwise sit in the flat block with nothing marking it as the reader.
 
 **Questions to Ask:**
 - Who is the target audience?
@@ -78,12 +78,12 @@ CO-STAR is a comprehensive prompting framework that emphasizes context, audience
 - What's their context?
 
 **Examples:**
-- "Senior executives with limited technical knowledge..."
-- "Junior developers learning the framework..."
-- "Parents of elementary school children..."
+- "The audience is senior executives with limited technical knowledge."
+- "The audience is junior developers learning the framework."
+- "The audience is parents of elementary school children."
 
 ### R - Response
-**Purpose:** Define the expected output format and structure.
+**Purpose:** Define the expected output format and structure. Phrase it as an instruction about the output ("Provide…", "Format the result as…") so it still reads as a directive once the `RESPONSE FORMAT` header is removed.
 
 **Questions to Ask:**
 - What format should the output take?
@@ -93,61 +93,117 @@ CO-STAR is a comprehensive prompting framework that emphasizes context, audience
 - What level of detail is needed?
 
 **Examples:**
-- "Provide a 500-word article with 3 main sections..."
-- "Create a bulleted list of 10 items..."
-- "Generate a table comparing features..."
+- "Provide a 500-word article with 3 main sections."
+- "Format the result as a bulleted list of 10 items."
+- "Generate a table comparing features."
 
 ## Template Structure
 
+Section headers are stripped at emission, so every slot's meaning is carried by the prose
+around and inside it rather than by the header above it. Context is a self-contained
+paragraph and survives on its own; Objective must be a complete imperative sentence; and
+Style, Tone, Audience, and Response Format each have to be phrased as a full sentence,
+because the labels that would otherwise mark them as style, tone, audience, or format are
+the first thing deleted.
+
 ```
+SOURCE MATERIAL:
+[OPTIONAL — include only if the content is built from material the user already has.
+If so, emit a literal paste instruction naming the specific artifact, e.g. "[Paste the Q3 revenue report here]"
+or "[Paste the blog post whose voice should be matched here]" — never a generic word like "content" —
+then one line of prose tying it to what follows, e.g. "Use the material above as the factual and stylistic
+basis for what you produce; do not invent details it does not support."
+If the content is written entirely from scratch, omit this section — do not emit an empty placeholder.]
+
 CONTEXT:
-[Background information, situation, constraints]
+[Provide background information, situation, and any relevant constraints. What's the setting? What's happened before? What limitations exist?]
 
 OBJECTIVE:
-[Clear, specific goal to achieve]
+[State the clear, specific goal you want to achieve. What exactly do you want accomplished? What does success look like?]
 
 STYLE:
-[Writing style, format preferences]
+[Specify the writing style, format preferences, and structural approach. Should it follow a particular style guide? What format is needed?]
 
 TONE:
-[Emotional quality, formality level]
+[Define the emotional quality and attitude. Should it be professional, casual, urgent, friendly, authoritative, empathetic, etc.?]
 
 AUDIENCE:
-[Target audience characteristics]
+[Identify who will consume this output. What's their expertise level? What do they care about? What are their characteristics?]
 
 RESPONSE FORMAT:
-[Expected output structure and format]
+[Specify the expected output structure. How long? What sections? What level of detail? Any specific format requirements?]
 ```
 
-## Complete Example
+`SOURCE MATERIAL` is a seventh block in a six-letter acronym, and it carries no letter
+because it is optional. Much CO-STAR work rewrites, repurposes, or matches the voice of
+something that already exists — a report to summarize, a press release to adapt, a post
+whose style should be echoed — and that artifact is pasted here, named concretely (never
+the generic word "content"), and referred to as "the … above" from inside the Objective.
+Delete the block whenever the content is written entirely from scratch; do not leave an
+empty placeholder.
+
+## Complete Examples
 
-### Before CO-STAR:
+Every example below is shown in emitted form: each slot carries its own role in prose.
+Read the headers as scaffolding that will be deleted — the examples are written so that
+nothing is lost when it is, which is why Style, Tone, Audience, and Response Format each
+read as a complete sentence.
+
+### Example 1: Health Blog Article
+
+**Before CO-STAR:**
 "Write about the benefits of exercise."
 
-### After CO-STAR:
+**After CO-STAR** (no source material — the article is written from scratch, so the
+`SOURCE MATERIAL` block is omitted):
 ```
 CONTEXT:
 I'm creating content for a health blog aimed at busy professionals who struggle to find time for fitness. Previous articles have focused on nutrition, and this is part of a series on lifestyle improvements.
 
 OBJECTIVE:
-Create an engaging article that convinces time-pressed professionals that exercise is worth prioritizing, focusing on benefits beyond just physical health.
+Write an engaging article that convinces time-pressed professionals that exercise is worth prioritizing, focusing on benefits beyond just physical health.
 
 STYLE:
 Use a conversational blog style with short paragraphs (2-3 sentences), subheadings every 150-200 words, and occasional bullet points for key takeaways. Include specific examples and avoid medical jargon.
 
 TONE:
-Encouraging and motivating without being preachy. Acknowledge their time constraints and show empathy for their challenges. Be practical and realistic rather than idealistic.
+Keep the tone encouraging and motivating without being preachy. Acknowledge their time constraints and show empathy for their challenges, and stay practical and realistic rather than idealistic.
+
+AUDIENCE:
+The audience is professionals aged 30-50 who work 50+ hour weeks, have limited free time, may have families, and currently don't exercise regularly. They're skeptical of fitness advice that seems unrealistic for their lifestyle.
+
+RESPONSE FORMAT:
+Produce an 800-word article with an engaging headline, a brief 2-3 sentence introduction, 4-5 main sections with subheadings, bullet points highlighting key benefits, and a practical conclusion with next steps.
+```
+
+### Example 2: Executive Summary from a Report
+
+**Before CO-STAR:**
+"Summarize this report for the board."
+
+**After CO-STAR** (source material supplied):
+```
+SOURCE MATERIAL:
+[Paste the Q3 revenue report here]
+Use the material above as the factual and stylistic basis for what you produce; do not invent details it does not support.
+
+CONTEXT:
+I'm the head of finance at a mid-size SaaS company, preparing a summary of our Q3 performance for the board's quarterly meeting. The full report above is 20 pages of financial detail, and the board sees dozens of documents per meeting.
+
+OBJECTIVE:
+Distill the Q3 revenue report above into a one-page summary the board can absorb in two minutes, surfacing the numbers and trends that bear on strategic decisions.
+
+STYLE:
+Write in a crisp executive-brief style: lead with the conclusion, use short declarative sentences, and support each claim with a figure drawn from the report above rather than a general statement.
+
+TONE:
+Keep the tone measured and factual — neither alarmist about the misses nor promotional about the wins.
 
 AUDIENCE:
-Professionals aged 30-50 who work 50+ hour weeks, have limited free time, may have families, and currently don't exercise regularly. They're skeptical of fitness advice that seems unrealistic for their lifestyle.
+The audience is board members who are financially literate but not close to day-to-day operations; they care about growth, runway, and risk, not implementation detail.
 
 RESPONSE FORMAT:
-800-word article with:
-- Engaging headline
-- Brief introduction (2-3 sentences)
-- 4-5 main sections with subheadings
-- Bullet points highlighting key benefits
-- Practical conclusion with next steps
+Produce a single page: three sentences of headline takeaways, then a short table of the key metrics with quarter-over-quarter change, then a four-item bulleted list of the decisions or risks that need the board's attention.
 ```
 
 ## Best Use Cases

package/skills/prompt-architect/references/frameworks/crispe.md

@@ -4,11 +4,13 @@
 
 CRISPE is a comprehensive general-purpose prompting framework covering six dimensions: Capacity and Role, Insight, Instructions, Personality, and Experiment. Its defining feature — the **Experiment** component — sets it apart from similar frameworks by explicitly asking the AI to produce multiple variants, approaches, or versions, enabling the user to compare and choose the best output rather than accepting a single answer.
 
-**Origin:** Developed by Matt Nigh (community framework, 2022). Since adopted in clinical AI literature (cited in PMC peer-reviewed medical AI studies, 2024-2025) and educational technology research (Springer, 2025).
+**Origin:** Community framework, commonly attributed to Matt Nigh (2022). No primary source for that attribution has been verified for this package. Practitioner framework — no controlled evaluation of CRISPE has been published.
+
+*Correction:* an earlier version of this file stated that CRISPE was "cited in PMC peer-reviewed medical AI studies, 2024-2025" and in "educational technology research (Springer, 2025)." Those claims named no title, author, DOI, or PMCID and were not checkable as written, so they have been removed. Being *mentioned* in a paper would not constitute evaluation of the framework in any case.
 
 ## Components
 
-### C — Capacity and Role
+### C, R — Capacity and Role
 **Purpose:** Define the expertise level and professional role the AI should embody. More specific than a simple "you are a..." — it combines the *type* of expertise with the *level* of sophistication expected.
 
 **Questions to Ask:**
@@ -21,7 +23,7 @@ CRISPE is a comprehensive general-purpose prompting framework covering six dimen
 - "You are a senior software architect specializing in distributed systems..."
 - "Act as a world-class UX researcher who has run hundreds of user interviews..."
 
-### R — Insight
+### I — Insight
 **Purpose:** Provide the background context, data, or knowledge the AI needs to perform the task effectively. This is the "briefing" — what you'd tell a new consultant before they start work.
 
 **Questions to Ask:**
@@ -34,7 +36,7 @@ CRISPE is a comprehensive general-purpose prompting framework covering six dimen
 - "Context: our team uses Python exclusively, we have a 3-month deadline, and our infrastructure is AWS..."
 - "Background: this is for a Series A startup pitching to enterprise buyers for the first time..."
 
-### I — Instructions
+### S — Instructions
 **Purpose:** State clearly and specifically what the AI should do. The task itself, with enough detail to remove ambiguity.
 
 **Questions to Ask:**
@@ -47,7 +49,7 @@ CRISPE is a comprehensive general-purpose prompting framework covering six dimen
 - "Create a technical design document for this feature..."
 - "Analyze this data and identify the top 3 risk factors..."
 
-### S — Personality (Style)
+### P — Personality (Style)
 **Purpose:** Define the tone, voice, and communication style of the response. Sets how the output should *feel* — the personality it should embody.
 
 **Questions to Ask:**

package/skills/prompt-architect/references/frameworks/ctf.md

@@ -2,14 +2,14 @@
 
 ## Overview
 
-CTF is a simple 3-component framework focused on situational context, task clarity, and output format. It is ideal for tasks where background/situation is more important than AI persona framing, and the primary concern is getting a clearly defined output from a well-understood context.
+CTF is a simple 3-component framework focused on situational context, task clarity, and output format. It is ideal for tasks where background/situation is more important than AI persona framing, and the primary concern is getting a clearly defined output from a well-understood context. Section headers are stripped when the prompt is emitted, so a CTF prompt lands as a short flat block — a paragraph of situation, a sentence naming the task, and a format specification — preceded by an optional source-material block whenever the task operates on an artifact that already exists.
 
 **Origin:** No single documented originator. CTF appears in the community framework literature as a variant of RTF, with Context substituted for Role, documented alongside it in unattributed practitioner listings from 2024 onward (e.g. fvivas.com, 15 March 2024). No academic treatment; absent from The Prompt Report (arXiv 2406.06608).
 
 ## Components
 
 ### C - Context
-**Purpose:** Describe the situation, background, or circumstances surrounding the task.
+**Purpose:** Describe the situation, background, or circumstances surrounding the task. It fills naturally as a self-contained paragraph of situational prose, so it survives header stripping on its own — but keep it descriptive narrative, not a bare label like "legacy code," so the paragraph still reads as a situation once the `CONTEXT` header is gone.
 
 **Questions to Ask:**
 - What is the current situation?
@@ -19,12 +19,12 @@ CTF is a simple 3-component framework focused on situational context, task clari
 - What constraints or circumstances apply?
 
 **Examples:**
-- "We are mid-sprint and the client has changed the acceptance criteria for the login flow..."
-- "I'm a junior developer onboarding to a legacy Python codebase with no documentation..."
-- "Our team writes internal status reports weekly and we need to standardize the format..."
+- "We are mid-sprint and the client has revised the acceptance criteria in the requirements doc above; the dev team has not been told yet."
+- "I am a junior developer onboarding to the legacy Python module above, which nobody has documented."
+- "Our team writes internal status reports weekly and the format drifts every time, so we want one reusable structure."
 
 ### T - Task
-**Purpose:** State exactly what needs to be done.
+**Purpose:** State exactly what needs to be done, as one complete imperative sentence. Nothing else in a CTF prompt states the task, so once the `TASK` header is stripped a bare noun phrase ("a summary") leaves the emitted prompt with no instruction in it.
 
 **Questions to Ask:**
 - What exactly needs to be done?
@@ -32,12 +32,12 @@ CTF is a simple 3-component framework focused on situational context, task clari
 - What's the core action?
 
 **Examples:**
-- "Write a summary of the changed requirements for the team..."
-- "Explain what this function does in plain language..."
-- "Create a template for our weekly status report..."
+- "Summarize the changed requirements in the doc above for the development team."
+- "Explain in plain language what the function above does."
+- "Create a reusable weekly status report template the team can fill out in under 10 minutes."
 
 ### F - Format
-**Purpose:** Specify how the output should be structured.
+**Purpose:** Specify how the output should be structured. Phrase it as an instruction about the output rather than a bare descriptor — a fragment like "markdown table" dangles once the `FORMAT` header is deleted, whereas "Provide the output as a markdown table" still reads as a directive.
 
 **Questions to Ask:**
 - What format should the output take?
@@ -46,46 +46,80 @@ CTF is a simple 3-component framework focused on situational context, task clari
 - Any specific formatting requirements?
 
 **Examples:**
-- "Provide as a markdown table..."
-- "Format as a bulleted list under three headings..."
-- "Write as a concise paragraph, 100 words max..."
+- "Provide the output as a markdown table."
+- "Format the answer as a bulleted list under three headings."
+- "Write the answer as a single paragraph of 100 words or fewer."
 
 ## Template Structure
 
+Section headers are stripped at emission, so every slot's meaning is carried by the prose
+around and inside it rather than by the header above it. Context is a self-contained
+paragraph and survives on its own; Task must be a complete imperative sentence, and Format
+must be phrased as an instruction about the output, because neither has a header to lean on
+once emitted.
+
 ```
+SOURCE MATERIAL:
+[Optional — include only if this task operates on material you already have. Paste the
+specific artifact here and name it in this line, e.g. "Paste the legacy authentication
+function here", "Paste the revised requirements doc here" — the artifact itself, not a
+description of it. If this task generates from scratch, delete this bracketed block along
+with the sentence directly below it.]
+Use the material above as the basis for the task described below.
+
 CONTEXT:
-[Situation, background, circumstances]
+[Describe the situation, background, or circumstances surrounding this task.
+Include relevant details like: current state, constraints, what's already been done,
+why this is needed, and any important background the AI should know.]
 
 TASK:
-[What needs to be done]
+[State clearly and specifically what needs to be done. Be explicit about the deliverable.]
 
 FORMAT:
-[How output should be structured]
+[Specify exactly how the output should be structured:
+- Overall format (document, code, list, table, etc.)
+- Required sections or components
+- Length constraints
+- Style requirements
+- Any specific formatting rules]
 ```
 
+`SOURCE MATERIAL` is a fourth block in a three-letter acronym, and it carries no letter
+because it is optional. CTF is often pointed at something that already exists — a legacy
+function, a revised requirements doc, a draft — and that artifact is pasted here and
+referred to as "the … above" from inside the Task. Delete the block and the sentence
+beneath it whenever the task generates something from scratch.
+
 ## Complete Examples
 
+Every example below is shown in emitted form: each slot carries its own role in prose.
+Read the headers as scaffolding that will be deleted — the examples are written so that
+nothing is lost when it is.
+
 ### Example 1: Requirement Change Summary
 
 **Before CTF:**
 "Summarize the new requirements."
 
-**After CTF:**
+**After CTF** (source material supplied):
 ```
+SOURCE MATERIAL:
+[Paste the client's revised login-flow requirements here]
+Use the material above as the basis for the task described below.
+
 CONTEXT:
 We are in sprint 3 of a 6-sprint project. The client just revised the login flow
-requirements: they now want SSO via Google instead of email/password. The dev team
-hasn't been told yet and we need to communicate this clearly without causing panic.
+requirements in the document above: they now want SSO via Google instead of
+email/password. The dev team hasn't been told yet and we need to communicate this
+clearly without causing panic.
 
 TASK:
-Write a brief summary of the requirement change to share with the development team
+Write a brief summary of the requirement change above to share with the development team
 in Slack.
 
 FORMAT:
-- 3-5 bullet points
-- Plain language, no jargon
-- End with a single action item
-- Keep total under 150 words
+Format the summary as 3-5 bullet points in plain language with no jargon, ending with a
+single action item, and keep the total under 150 words.
 ```
 
 ### Example 2: Code Explanation
@@ -93,21 +127,24 @@ FORMAT:
 **Before CTF:**
 "Explain this code."
 
-**After CTF:**
+**After CTF** (source material supplied):
 ```
+SOURCE MATERIAL:
+[Paste the undocumented legacy authentication function here]
+Use the material above as the basis for the task described below.
+
 CONTEXT:
-I'm a junior developer new to this codebase. The function below is from a legacy
+I'm a junior developer new to this codebase. The function above is from a legacy
 authentication module that nobody has documented. I need to understand it before
 refactoring it next week.
 
 TASK:
-Explain what this function does, why each section exists, and flag any potential
+Explain what the function above does, why each section exists, and flag any potential
 issues I should know before touching it.
 
 FORMAT:
-- Short plain-language summary (2-3 sentences)
-- Line-by-line breakdown as a numbered list
-- Potential issues section at the end (bullet points)
+Open with a short plain-language summary of 2-3 sentences, then give a line-by-line
+breakdown as a numbered list, and end with a bulleted "Potential issues" section.
 ```
 
 ### Example 3: Template Creation
@@ -115,7 +152,8 @@ FORMAT:
 **Before CTF:**
 "Create a status report template."
 
-**After CTF:**
+**After CTF** (no source material — the template is designed from scratch, so the
+`SOURCE MATERIAL` block and the sentence below it are both deleted):
 ```
 CONTEXT:
 Our team of 6 engineers sends weekly status reports to a non-technical product
@@ -126,11 +164,9 @@ TASK:
 Create a weekly status report template that balances completeness with brevity.
 
 FORMAT:
-Markdown template with:
-- Section headers with fill-in placeholders
-- Brief instruction comment under each header
-- Total estimated fill-in time: under 10 minutes
-- Length when filled: 200-300 words
+Produce a markdown template with section headers, a fill-in placeholder under each header,
+and a brief instruction comment beneath it. Aim for under 10 minutes of fill-in time and a
+filled length of 200-300 words.
 ```
 
 ## Best Use Cases
@@ -170,7 +206,7 @@ Markdown template with:
 - ❌ Audience and tone are critical (use CO-STAR)
 - ❌ Multi-step process with methodology needed (use RISEN)
 - ❌ Explicit dos/don'ts required (use TIDD-EC)
-- ❌ Input→output transformation (use RISE — the Role/Input/Steps/Expectation form)
+- ❌ Input→output transformation (use RISE-IE — the Role/Input/Steps/Expectation form)
 
 ## CTF vs RTF