@ckelsoe/prompt-architect 3.2.2 → 3.4.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (70) hide show
  1. package/.claude-plugin/marketplace.json +3 -3
  2. package/.claude-plugin/plugin.json +2 -2
  3. package/CHANGELOG.md +135 -5
  4. package/MIGRATION.md +1 -1
  5. package/README.md +32 -47
  6. package/adapters/README.md +1 -1
  7. package/adapters/system-prompt.md +115 -59
  8. package/package.json +5 -4
  9. package/scripts/install.js +52 -22
  10. package/scripts/test.js +88 -40
  11. package/scripts/validate-skill.js +184 -56
  12. package/skills/prompt-architect/SKILL.md +94 -79
  13. package/skills/prompt-architect/assets/templates/ape_template.txt +14 -3
  14. package/skills/prompt-architect/assets/templates/bab_template.txt +23 -10
  15. package/skills/prompt-architect/assets/templates/broke_template.txt +31 -6
  16. package/skills/prompt-architect/assets/templates/cai-critique-revise_template.txt +16 -8
  17. package/skills/prompt-architect/assets/templates/care_template.txt +4 -0
  18. package/skills/prompt-architect/assets/templates/chain-of-density_template.txt +64 -35
  19. package/skills/prompt-architect/assets/templates/chain-of-thought_template.txt +8 -0
  20. package/skills/prompt-architect/assets/templates/co-star_template.txt +8 -0
  21. package/skills/prompt-architect/assets/templates/crispe_template.txt +6 -0
  22. package/skills/prompt-architect/assets/templates/ctf_template.txt +8 -0
  23. package/skills/prompt-architect/assets/templates/devils-advocate_template.txt +7 -0
  24. package/skills/prompt-architect/assets/templates/hybrid_template.txt +44 -24
  25. package/skills/prompt-architect/assets/templates/iterative-compression_template.txt +74 -0
  26. package/skills/prompt-architect/assets/templates/least-to-most_template.txt +4 -0
  27. package/skills/prompt-architect/assets/templates/plan-and-solve_template.txt +4 -0
  28. package/skills/prompt-architect/assets/templates/pre-mortem_template.txt +24 -14
  29. package/skills/prompt-architect/assets/templates/race_template.txt +9 -0
  30. package/skills/prompt-architect/assets/templates/rcot_template.txt +8 -0
  31. package/skills/prompt-architect/assets/templates/react_template.txt +38 -16
  32. package/skills/prompt-architect/assets/templates/rise-ie_template.txt +4 -0
  33. package/skills/prompt-architect/assets/templates/rise-ix_template.txt +3 -3
  34. package/skills/prompt-architect/assets/templates/risen_template.txt +7 -0
  35. package/skills/prompt-architect/assets/templates/rpef_template.txt +16 -11
  36. package/skills/prompt-architect/assets/templates/rtf_template.txt +9 -0
  37. package/skills/prompt-architect/assets/templates/skeleton-of-thought_template.txt +18 -10
  38. package/skills/prompt-architect/assets/templates/step-back_template.txt +4 -0
  39. package/skills/prompt-architect/assets/templates/tidd-ec_template.txt +54 -31
  40. package/skills/prompt-architect/assets/templates/tree-of-thought_template.txt +37 -21
  41. package/skills/prompt-architect/references/frameworks/ape.md +145 -57
  42. package/skills/prompt-architect/references/frameworks/bab.md +139 -58
  43. package/skills/prompt-architect/references/frameworks/broke.md +157 -57
  44. package/skills/prompt-architect/references/frameworks/cai-critique-revise.md +184 -76
  45. package/skills/prompt-architect/references/frameworks/care.md +67 -36
  46. package/skills/prompt-architect/references/frameworks/chain-of-density.md +111 -417
  47. package/skills/prompt-architect/references/frameworks/chain-of-thought.md +45 -19
  48. package/skills/prompt-architect/references/frameworks/co-star.md +102 -44
  49. package/skills/prompt-architect/references/frameworks/crispe.md +7 -5
  50. package/skills/prompt-architect/references/frameworks/ctf.md +75 -37
  51. package/skills/prompt-architect/references/frameworks/devils-advocate.md +105 -58
  52. package/skills/prompt-architect/references/frameworks/iterative-compression.md +448 -0
  53. package/skills/prompt-architect/references/frameworks/least-to-most.md +35 -13
  54. package/skills/prompt-architect/references/frameworks/plan-and-solve.md +38 -9
  55. package/skills/prompt-architect/references/frameworks/pre-mortem.md +182 -72
  56. package/skills/prompt-architect/references/frameworks/race.md +93 -38
  57. package/skills/prompt-architect/references/frameworks/rcot.md +1 -1
  58. package/skills/prompt-architect/references/frameworks/react.md +230 -97
  59. package/skills/prompt-architect/references/frameworks/reverse-role.md +23 -16
  60. package/skills/prompt-architect/references/frameworks/rise.md +120 -77
  61. package/skills/prompt-architect/references/frameworks/risen.md +82 -28
  62. package/skills/prompt-architect/references/frameworks/rpef.md +227 -58
  63. package/skills/prompt-architect/references/frameworks/rtf.md +4 -2
  64. package/skills/prompt-architect/references/frameworks/self-refine.md +4 -2
  65. package/skills/prompt-architect/references/frameworks/skeleton-of-thought.md +68 -22
  66. package/skills/prompt-architect/references/frameworks/step-back.md +48 -16
  67. package/skills/prompt-architect/references/frameworks/tidd-ec.md +129 -51
  68. package/skills/prompt-architect/references/frameworks/tree-of-thought.md +112 -37
  69. package/skills/prompt-architect/scripts/framework_analyzer.py +0 -807
  70. package/skills/prompt-architect/scripts/prompt_evaluator.py +0 -336
@@ -1,15 +1,40 @@
1
+ This is a business task with a defined success bar. Everything below describes one
2
+ deliverable.
3
+
4
+ SOURCE MATERIAL:
5
+ [Optional — paste the material this task works from here, named specifically: the current
6
+ process document, the performance data, the existing draft. If you have nothing to paste,
7
+ delete this bracketed block along with the sentence directly below it.]
8
+ Use the material above as the factual basis for the work described below.
9
+
1
10
  BACKGROUND:
2
- [Current situation, why this task exists, relevant history and constraints]
11
+ Here is the situation this task arises from:
12
+ [Describe the current state as narrative prose: what the organization is, what is
13
+ happening now, and why this task exists. Add prior attempts and constraints only where the
14
+ user supplied them; never invent them.]
3
15
 
4
16
  ROLE:
5
- [Professional persona and expertise to embody]
17
+ Take on this professional persona for the work:
18
+ [One second-person sentence beginning "You are…", naming the domain expertise and level of
19
+ experience this task requires.]
6
20
 
7
21
  OBJECTIVE:
8
- [The specific task and deliverable]
22
+ Your task is to do the following:
23
+ [One imperative sentence naming what to analyze or produce and what the finished artifact
24
+ is.]
25
+
26
+ OUTPUT FORMAT:
27
+ Deliver your response in this shape:
28
+ [Name the sections the response should contain, its approximate length or item count, and
29
+ how much supporting detail each part carries.]
9
30
 
10
31
  KEY RESULTS:
11
- [Measurable outcomes this output should help achieve how success is defined in business terms]
32
+ Your response will be judged on whether it can plausibly move the measurable outcomes
33
+ below. They are the success bar, not tasks to carry out:
34
+ [List each outcome as a statement naming the metric and its target. Add a baseline or time
35
+ frame only where the user gave one; never invent one — write "[you fill this in: current
36
+ value of <metric>]" instead.]
12
37
 
13
38
  EVOLVE:
14
- After completing your response, provide 3 specific suggestions for improving
15
- this output or approach in a follow-up iteration.
39
+ After completing your response, provide 3 specific suggestions for improving this output
40
+ or approach in a follow-up iteration.
@@ -1,18 +1,26 @@
1
+ You are enforcing a stated principle against an existing piece of writing. This is a
2
+ two-phase task: write a critique, then write a revision. Do not skip the critique and go
3
+ straight to the rewrite, and do not merge the two.
4
+
1
5
  PRINCIPLE:
2
- [State the specific standard the output must satisfy — be precise and measurable]
6
+ The principle to enforce is this:
7
+ [State the standard the output must satisfy — one principle or a small set — as complete
8
+ sentences whose compliance a reader could check. Be precise and measurable.]
3
9
 
4
- INITIAL OUTPUT:
5
- [The output to evaluate — AI-generated or human-written]
10
+ SOURCE MATERIAL:
11
+ [Paste the output to be critiqued here — AI-generated or human-written.]
12
+ Use the material above as the text to be critiqued and revised for the work described
13
+ below.
6
14
 
7
15
  CRITIQUE:
8
- Identify specific ways the output above violates or falls short of the
9
- principle stated above.
16
+ Before rewriting anything, identify the specific ways the material above violates or falls
17
+ short of the principle.
10
18
  - Quote the specific passages that are problematic
11
19
  - Explain precisely why each passage violates the principle
12
- - Focus only on failures against the principle (not general quality)
20
+ - Focus only on failures against the principle, not general quality
13
21
 
14
22
  REVISION:
15
- Rewrite the output to fully satisfy the principle.
23
+ Then rewrite the material above so it fully satisfies the principle.
16
24
  - Address every critique point identified above
17
25
  - Preserve all content that already satisfies the principle
18
- - Do not introduce new violations of the principle
26
+ - Do not introduce new violations
@@ -1,3 +1,7 @@
1
+ SOURCE MATERIAL:
2
+ [Optional — include only if this task works from material you already have. Paste the source document, data, or draft this task operates on here. If you have nothing to paste, delete this bracketed block along with the sentence directly below it.]
3
+ Use the material above as the factual basis for the work described below.
4
+
1
5
  CONTEXT:
2
6
  [Who you are, the situation you're in, and why this task exists]
3
7
 
@@ -1,46 +1,75 @@
1
1
  === CHAIN OF DENSITY (CoD) TEMPLATE ===
2
2
 
3
- Use when: iterative compression or quality improvement is the goal
4
- summarization, explanation optimization, content densification.
3
+ Everything down to the first divider rule is guidance for whoever assembles this
4
+ prompt and never belongs in the finished prompt. The prompt itself runs from that
5
+ divider to the end of the file: fill in every bracketed field there, and drop the
6
+ section headers and divider rules when emitting it. 'Step 1.', 'Step 2.' and
7
+ 'Guidelines:' are literal labels in this protocol, not headings — keep them exactly
8
+ as written. [TARGET] is the fixed word budget and [N] the number of summaries, both
9
+ as bare numerals; substitute the same numeral at every occurrence of each.
5
10
 
6
- ─────────────────────────────────────────────
7
- SOURCE CONTENT:
8
- [Paste the content to be refined/compressed here]
11
+ Use when: summarizing a document and you want maximum information in a fixed
12
+ length — articles, papers, reports, executive summaries, abstracts.
9
13
 
10
- ─────────────────────────────────────────────
11
- OPTIMIZATION GOAL:
12
- [What should improve with each pass?]
13
- Examples:
14
- - "Reduce word count by 20% each pass while retaining all key information"
15
- - "Increase information density — remove filler, make every sentence earn its place"
16
- - "Improve clarity — each pass should be more direct and easier to understand"
14
+ NOT for: general rewriting (use Self-Refine), or progressive shortening to a
15
+ target word count (use Iterative Compression). CoD holds length FIXED
16
+ and raises density if your text is getting shorter, this is the
17
+ wrong template.
17
18
 
18
- ─────────────────────────────────────────────
19
- NUMBER OF ITERATIONS:
20
- [How many refinement passes? Typical: 2-4]
21
- Iteration 1: [First pass initial improvement]
22
- Iteration 2: [Second pass — tighten further]
23
- Iteration 3: [Optional — final polish]
19
+ Based on Adams et al., "From Sparse to Dense: GPT-4 Summarization with Chain of
20
+ Density Prompting" (arXiv 2309.04269, NewSum @ EMNLP 2023). The paper's settings are
21
+ [TARGET] = 80 and [N] = 5; fewer summaries works, more gives diminishing returns. Use
22
+ those if the user gave no numbers of their own.
24
23
 
25
- ─────────────────────────────────────────────
26
- ITERATION INSTRUCTIONS:
27
- For each iteration:
28
- 1. Identify what can be cut, compressed, or clarified
29
- 2. Apply the changes
30
- 3. Verify: does this version better meet the optimization goal than the previous?
31
- 4. Stop when: [define your stopping criterion]
32
- Examples: "length < 150 words", "no filler words remain", "3 iterations complete"
24
+ The padded first summary is intentional, not a mistake — the filler is the slack that
25
+ later iterations convert into entities. A dense first summary leaves no room and the
26
+ chain stalls.
33
27
 
34
28
  ─────────────────────────────────────────────
35
- OUTPUT FORMAT:
36
- [What format should the final result be in?]
37
- Examples: paragraph, bullet list, 1-sentence summary, structured sections
29
+ SOURCE MATERIAL:
30
+ [Paste the full document to be summarized here.]
31
+ Use the material above as the article to be summarized for the work described below.
38
32
 
39
33
  ─────────────────────────────────────────────
40
- OPTIONAL SHOW INTERMEDIATE VERSIONS:
41
- Set to YES if you want to see each iteration's output.
42
- Set to NO if you only want the final result.
34
+ You will generate increasingly concise, entity-dense summaries of the article above.
35
+ Produce [N] summaries in total, each denser than the last, all in a single response.
36
+ Every summary must be exactly [TARGET] words long.
43
37
 
44
- ─────────────────────────────────────────────
45
- NOTE: Use Self-Refine when the improvement goal is multi-dimensional quality
46
- (e.g., accuracy + tone + completeness). CoD is specifically for density/compression.
38
+ Repeat the following 2 steps [N] times.
39
+
40
+ Step 1. Identify 1-3 informative entities (";" delimited) from the article which
41
+ are missing from the previously generated summary.
42
+ Step 2. Write a new, denser summary of identical length which covers every entity
43
+ and detail from the previous summary plus the missing entities.
44
+
45
+ A missing entity is:
46
+ - Relevant: to the main story.
47
+ - Specific: descriptive yet concise (5 words or fewer).
48
+ - Novel: not in the previous summary.
49
+ - Faithful: present in the article.
50
+ - Anywhere: located anywhere in the article.
51
+
52
+ Guidelines:
53
+ - The first summary should be long (4-5 sentences, ~[TARGET] words) yet highly
54
+ non-specific, containing little information beyond the entities marked as missing.
55
+ Use overly verbose language and fillers (e.g., "this article discusses") to reach
56
+ ~[TARGET] words.
57
+ - Make every word count: re-write the previous summary to improve flow and make
58
+ space for additional entities.
59
+ - Make space with fusion, compression, and removal of uninformative phrases like
60
+ "the article discusses".
61
+ - The summaries should become highly dense and concise yet self-contained, e.g.,
62
+ easily understood without the article.
63
+ - Missing entities can appear anywhere in the new summary.
64
+ - Never drop entities from the previous summary. If space cannot be made, add
65
+ fewer new entities.
66
+
67
+ Remember, use the exact same number of words for each summary.
68
+
69
+ Answer in JSON. The JSON should be a list (length [N]) of dictionaries whose keys are
70
+ "Missing_Entities" and "Denser_Summary".
71
+
72
+ After the JSON, and outside it, add one short paragraph naming which summary you
73
+ recommend and why. Do not default to the last one: in the paper's human evaluation,
74
+ summary 2 (30.8% of first-place votes) and summary 3 (23.0%) were preferred over the
75
+ sparse summary 1 (8.3%), because past a point density costs readability.
@@ -8,6 +8,14 @@ PROBLEM / QUESTION:
8
8
  [State the problem clearly. Include all relevant numbers, conditions,
9
9
  or constraints — everything needed to reason from.]
10
10
 
11
+ ─────────────────────────────────────────────
12
+ SOURCE MATERIAL:
13
+ [Optional — paste the material the problem refers to here (the code, data,
14
+ document, or transcript to reason over). If the problem stated above is fully
15
+ self-contained, delete this bracketed block and the sentence below it.]
16
+ The reasoning that follows must work from the material above, not from
17
+ assumptions about it.
18
+
11
19
  ─────────────────────────────────────────────
12
20
  REASONING INSTRUCTION:
13
21
  Solve this step-by-step. For each step:
@@ -1,3 +1,11 @@
1
+ SOURCE MATERIAL:
2
+ [OPTIONAL — include only if the content is built from material the user already has.
3
+ If so, emit a literal paste instruction naming the specific artifact, e.g. "[Paste the Q3 revenue report here]"
4
+ or "[Paste the blog post whose voice should be matched here]" — never a generic word like "content" —
5
+ then one line of prose tying it to what follows, e.g. "Use the material above as the factual and stylistic
6
+ basis for what you produce; do not invent details it does not support."
7
+ If the content is written entirely from scratch, omit this section — do not emit an empty placeholder.]
8
+
1
9
  CONTEXT:
2
10
  [Provide background information, situation, and any relevant constraints. What's the setting? What's happened before? What limitations exist?]
3
11
 
@@ -1,3 +1,9 @@
1
+ SOURCE MATERIAL:
2
+ [Optional — paste the material the briefing draws on here, named concretely (the customer
3
+ research deck, the writing sample whose voice should be matched). If you have nothing to
4
+ paste, delete this bracketed block along with the sentence directly below it.]
5
+ Use the material above as the factual and stylistic basis for the work described below.
6
+
1
7
  CAPACITY AND ROLE:
2
8
  [Define the expertise level and professional role to embody — be specific about domain and level]
3
9
 
@@ -1,3 +1,11 @@
1
+ SOURCE MATERIAL:
2
+ [Optional — include only if this task operates on material you already have. Paste the
3
+ specific artifact here and name it in this line, e.g. "Paste the legacy authentication
4
+ function here", "Paste the revised requirements doc here" — the artifact itself, not a
5
+ description of it. If this task generates from scratch, delete this bracketed block along
6
+ with the sentence directly below it.]
7
+ Use the material above as the basis for the task described below.
8
+
1
9
  CONTEXT:
2
10
  [Describe the situation, background, or circumstances surrounding this task.
3
11
  Include relevant details like: current state, constraints, what's already been done,
@@ -4,6 +4,13 @@ your task is to generate the strongest possible case against the following posit
4
4
  POSITION TO ATTACK:
5
5
  [State the position, plan, decision, or proposal clearly]
6
6
 
7
+ SUPPORTING MATERIAL (optional):
8
+ [Optional — paste the proposal, design doc, strategy memo, or other document
9
+ that sets out this position here. If you have nothing to paste, delete this
10
+ bracketed block and the sentence below it.]
11
+ Treat the document above as the detailed source of the position's claims,
12
+ assumptions, and reasoning.
13
+
7
14
  ATTACK INSTRUCTIONS:
8
15
  - Do not acknowledge positives or offer a balanced view
9
16
  - Attack every assumption the position depends on
@@ -1,7 +1,8 @@
1
1
  === HYBRID / COMBINED FRAMEWORK TEMPLATE ===
2
2
 
3
- Use this when a single framework doesn't fully cover your needs.
4
- Include only the sections that add valueremove the rest.
3
+ Use this when a single framework doesn't fully cover your needs. Include only the sections
4
+ that add value and delete the resta hybrid with 4 focused sections beats one that uses
5
+ all 15.
5
6
 
6
7
  ─────────────────────────────────────────────
7
8
  COMMON COMBINATION PATTERNS
@@ -35,6 +36,15 @@ Use when: create content → then verify it meets an explicit principle/standard
35
36
  HYBRID TEMPLATE STRUCTURE
36
37
  ─────────────────────────────────────────────
37
38
 
39
+ [Headers are stripped at emission, so fill every slot below with complete sentences that name
40
+ their own subject.]
41
+
42
+ SOURCE MATERIAL:
43
+ [Optional — paste the artifact this task operates on here, named concretely (the current job
44
+ posting, the Q3 revenue report). If you have nothing to paste, delete this bracketed block
45
+ along with the sentence directly below it.]
46
+ Use the material above as the factual basis for the work described below.
47
+
38
48
  CONTEXT / BACKGROUND:
39
49
  [From CTF / CO-STAR / CARE — situation, background, why this task exists]
40
50
 
@@ -44,32 +54,42 @@ ROLE:
44
54
  OBJECTIVE:
45
55
  [From CO-STAR / RISEN — specific goal to achieve]
46
56
 
47
- INPUT (if applicable):
48
- [From RISE-IE — what's being provided, format, characteristics]
57
+ INPUT CHARACTERISTICS:
58
+ [From RISE-IE's "About the material above" slot — the format, structure, and quirks of
59
+ whatever you pasted under SOURCE MATERIAL, not the material itself. If you pasted nothing
60
+ there, delete this bracketed block.]
49
61
 
50
62
  INSTRUCTIONS / STEPS:
51
63
  [From RISEN / RISE — guiding principles, methodology, step sequence]
52
64
 
53
65
  CONSTRAINTS / RULES:
54
- [From CARE / TIDD-EC / RISEN — what must/must not happen, boundaries]
66
+ [From CARE / TIDD-EC / RISEN — boundaries on the work, each stated as a requirement or a
67
+ prohibition]
55
68
 
56
69
  DO:
57
- [From TIDD-EC — explicit positive guidance]
70
+ [From TIDD-EC — required behaviors, each a complete imperative sentence]
58
71
 
59
72
  DON'T:
60
- [From TIDD-EC — explicit negative guidance]
73
+ [From TIDD-EC — prohibitions, each phrased as "Do not…" or "Never…" so it stands on its own
74
+ line]
61
75
 
62
- AUDIENCE (if relevant):
63
- [From CO-STAR — who this is for, characteristics]
76
+ AUDIENCE:
77
+ [From CO-STAR — who this is for and what they already know]
64
78
 
65
- TONE & STYLE (if relevant):
79
+ TONE & STYLE:
66
80
  [From CO-STAR / CRISPE — voice and communication style]
67
81
 
68
- EXAMPLES (if relevant):
69
- [From RISE-IX / CARE — reference samples]
82
+ EXAMPLES:
83
+ [From RISE-IX / CARE — reference samples. If you have none, delete this bracketed block along
84
+ with the sentence directly below it.]
85
+ Match the form and quality of the samples above; do not reuse their content.
70
86
 
71
- KEY RESULTS (if relevant):
72
- [From BROKE measurable business outcomes]
87
+ KEY RESULTS:
88
+ Your response will be judged on whether it can plausibly move the measurable outcomes
89
+ below. They are the success bar, not tasks to carry out:
90
+ [From BROKE — measurable business outcomes, each a complete sentence naming the metric and
91
+ its target. If the task has no measurable business outcome, delete this bracketed block along
92
+ with the two sentences directly above it.]
73
93
 
74
94
  END GOAL / EXPECTATION:
75
95
  [From RISEN / RACE / BROKE — success criteria, final outcome, output format]
@@ -78,24 +98,24 @@ FORMAT:
78
98
  [From RTF / CTF / APE — exactly how output should be structured]
79
99
 
80
100
  ─────────────────────────────────────────────
81
- CRITIQUE / VERIFICATION LAYER (optional)
101
+ CRITIQUE / VERIFICATION LAYER
82
102
  ─────────────────────────────────────────────
83
- Add after generation if needed:
103
+
104
+ [Optional — if the task has a distinct verification phase, keep exactly one of the three
105
+ blocks below and append it after the generation instructions above. Otherwise delete all
106
+ three.]
84
107
 
85
108
  FEEDBACK DIMENSIONS (Self-Refine):
86
- Review for: [dimension 1], [dimension 2], [dimension 3]
87
- Refine addressing all feedback.
109
+ Review your own draft for [dimension 1], [dimension 2], and [dimension 3], then revise it to
110
+ address every point you raised.
88
111
 
89
112
  OR
90
113
 
91
114
  PRINCIPLE (CAI Critique-Revise):
92
- [State the standard] Critique Revise.
115
+ Measure your draft against this principle, then revise the draft until it complies: [the
116
+ explicit standard the output must meet].
93
117
 
94
118
  OR
95
119
 
96
120
  POSITION ATTACK (Devil's Advocate):
97
- Argue against the above recommendation as forcefully as possible.
98
-
99
- ─────────────────────────────────────────────
100
- NOTE: Use only sections relevant to your task.
101
- A hybrid with 4 focused sections beats a hybrid that uses all 15.
121
+ Argue against the recommendation above as forcefully as possible.
@@ -0,0 +1,74 @@
1
+ === ITERATIVE COMPRESSION TEMPLATE ===
2
+
3
+ Everything down to the first divider rule is guidance for whoever assembles this
4
+ prompt and never belongs in the finished prompt. The prompt itself runs from that
5
+ divider to the end of the file: fill in every bracketed field there, and drop the
6
+ section headers and divider rules when emitting it. 'Iteration 1:', 'Iteration 2:'
7
+ and 'Iteration 3:' are literal labels in this protocol, not headings — keep them
8
+ exactly as written wherever they appear.
9
+
10
+ Use when: text needs to get tighter and shorter through successive passes —
11
+ trimming to a word limit, cutting filler, sharpening explanations.
12
+
13
+ NOT for: summarization at a FIXED length with rising information density —
14
+ that is Chain of Density (chain-of-density_template.txt), a distinct
15
+ published method. Use this template when the text should SHRINK.
16
+ Use Self-Refine when the goal is multi-dimensional quality
17
+ (accuracy + tone + completeness), not compression.
18
+
19
+ ─────────────────────────────────────────────
20
+ SOURCE MATERIAL:
21
+ [Paste the full text to be compressed here.]
22
+ Use the material above as the text to be compressed for the work described below.
23
+ Every version must be a rewrite of that material — never introduce a claim it does
24
+ not support.
25
+
26
+ ─────────────────────────────────────────────
27
+ OPTIMIZATION GOAL:
28
+ Every pass must move the text toward this goal:
29
+ [A full sentence naming what improves and by how much, not a bare label like
30
+ "concision." For example: "Reduce word count by 20% each pass while retaining all key
31
+ information," or "Raise information density — cut filler until every sentence earns
32
+ its place."]
33
+
34
+ ─────────────────────────────────────────────
35
+ TARGET:
36
+ The final version must reach this end state:
37
+ [A phrase completing the sentence above, e.g. "under 150 words and readable by a
38
+ non-specialist." Name the unit, not a bare number.]
39
+
40
+ ─────────────────────────────────────────────
41
+ NUMBER OF ITERATIONS:
42
+ Run this many passes in total:
43
+ [The count as a phrase completing the sentence above, e.g. "three passes."
44
+ Typical: 2-4]
45
+ Iteration 1: [What this first pass must do to the source text, as a full sentence.]
46
+ Iteration 2: [How this pass tightens the result of pass 1, as a full sentence.]
47
+ Iteration 3: [Optional — what this final polish pass must do, as a full sentence.
48
+ Delete this line if running fewer than three passes; add further Iteration lines in
49
+ the same form if running more.]
50
+
51
+ ─────────────────────────────────────────────
52
+ ITERATION INSTRUCTIONS:
53
+ In each pass, identify what can be cut, compressed, or clarified, apply the changes,
54
+ then check both that the result serves the goal above better than the version before
55
+ it and that nothing the goal requires keeping was lost. Stop when [a clause completing
56
+ this sentence, e.g. "no filler words remain" or "all three passes are complete"].
57
+
58
+ ─────────────────────────────────────────────
59
+ OUTPUT FORMAT:
60
+ Deliver the final version in this format:
61
+ [A phrase completing the sentence above, e.g. "a single paragraph of continuous
62
+ prose," a bullet list, or a one-sentence summary.]
63
+
64
+ ─────────────────────────────────────────────
65
+ INTERMEDIATE VERSIONS:
66
+ [Optional — keep exactly one of these two sentences as the entire content of this
67
+ block, or delete the block: "Show the output of every iteration in order, labelled by
68
+ pass number." / "Show only the final version — do not print the intermediate
69
+ passes."]
70
+
71
+ ─────────────────────────────────────────────
72
+ Compression has a floor. Past a point, passes strip meaning rather than filler. If a
73
+ pass would remove something a reader needs, stop at the previous version and deliver
74
+ that.
@@ -1,6 +1,10 @@
1
1
  PROBLEM:
2
2
  [The full, complex problem to solve]
3
3
 
4
+ SOURCE MATERIAL:
5
+ [Optional — paste the source material this problem depends on here (the dataset, figures, code, or document the subproblems must reason over). Delete this line and the one below it if the problem above is self-contained.]
6
+ Every subproblem below must be answered against the material above, not from assumption.
7
+
4
8
  DECOMPOSE:
5
9
  Break this problem into ordered subproblems, from simplest prerequisite to most complex.
6
10
  Each later subproblem should build on the answer to the previous.
@@ -1,6 +1,10 @@
1
1
  PROBLEM:
2
2
  [Your question, calculation, or reasoning problem]
3
3
 
4
+ SOURCE MATERIAL:
5
+ [Optional — paste the source data the problem depends on here (the dataset, table, figures, or constraint list the calculation runs on). Delete this line and the one below it if the problem above already states every value needed.]
6
+ The figures and constraints in the material above are authoritative — extract from them rather than from assumed or recalled values.
7
+
4
8
  Let's first understand the problem, extract relevant variables and their
5
9
  corresponding numerals, and devise a complete plan. Then, let's carry out
6
10
  the plan, calculate intermediate values, pay attention to computation,
@@ -1,27 +1,37 @@
1
- PRE-MORTEM ANALYSIS
1
+ You are conducting a pre-mortem on the project described below. The failure stated further
2
+ down is settled fact, not a possibility — work backwards from it and explain why it happened.
3
+ Do not hedge with "could," "might," or "may."
4
+
5
+ SOURCE MATERIAL:
6
+ [Optional — paste the project plan, proposal, or decision document here. If you have nothing
7
+ to paste, delete this bracketed block along with the sentence directly below it.]
8
+ Use the material above as the factual basis for the work described below.
2
9
 
3
10
  PROJECT/DECISION:
4
- [Describe the project, plan, or decision being analyzed — include team size,
5
- timeline, resources, key goals, and any relevant constraints]
11
+ [Describe the project, plan, or decision being analyzed in full sentences what is being
12
+ attempted, plus team size, timeline, resources, goals, and constraints]
6
13
 
7
14
  FAILURE ASSUMPTION:
8
- It is [DATE — e.g., 12 months from now] and [project/decision] has completely
9
- and catastrophically failed. It did not achieve [primary goal].
15
+ It is [DATE — e.g., 12 months from now] and [project/decision] has completely and
16
+ catastrophically failed. It did not achieve [primary goal].
10
17
 
11
18
  FAILURE NARRATIVE:
12
- Describe the failure in 2-3 sentences from the perspective of someone
13
- looking back on it.
19
+ Begin by describing how that failure unfolded, in 2-3 sentences, in past tense from the
20
+ perspective of someone looking back on it.
14
21
 
15
22
  FAILURE CAUSES:
16
- Identify [8-12] specific reasons this failed. For each:
23
+ Then identify [8-12] specific reasons it failed, each stated as something that already went
24
+ wrong. Cover technical/product, team/organizational, market/adoption, financial/resource,
25
+ external dependencies, and timeline/scope. Give each cause three lines:
17
26
  - CAUSE: [What specifically went wrong — be specific, not generic]
18
27
  - DOMAIN: [Technical / People / Market / Financial / External / Timeline]
19
28
  - WARNING SIGN: [What was the earliest observable indicator this was happening?]
20
-
21
- Cover these domains: technical/product, team/organizational, market/adoption,
22
- financial/resource, external dependencies, timeline/scope.
29
+ "CAUSE:", "DOMAIN:" and "WARNING SIGN:" are literal labels in this protocol, not headings —
30
+ keep them exactly as written.
23
31
 
24
32
  PRIORITY ASSESSMENT:
25
- 1. The 3 most LIKELY failure causes given our specific situation
26
- 2. The 3 most PREVENTABLE causes where action now would help most
27
- 3. Any single point of failure that could kill the project alone
33
+ After listing every cause, close by singling out three things:
34
+ 1. The 3 causes most LIKELY to be what actually happened, given the situation above.
35
+ 2. The 3 most PREVENTABLE causes where action taken today would have made the most
36
+ difference.
37
+ 3. Any single point of failure that could have killed the project on its own.
@@ -1,3 +1,12 @@
1
+ SOURCE MATERIAL:
2
+ [OPTIONAL — include only if this task operates on something the user already has.
3
+ If so, emit a literal paste instruction naming the specific artifact, e.g. "[Paste the REST API design here]"
4
+ or "[Paste the migration plan here]" — then one line of prose tying it to what follows,
5
+ e.g. "The material above is what the task below applies to."
6
+ When this section is used, word ACTION to refer to the material ABOVE ("the migration plan above"),
7
+ never "described below" — the artifact precedes it and a downward reference would dangle.
8
+ If the task generates entirely from scratch, omit this section — do not emit an empty placeholder.]
9
+
1
10
  ROLE:
2
11
  [Define the expertise or persona needed — who should do this task and at what level]
3
12
 
@@ -1,6 +1,14 @@
1
1
  STEP 1 — INITIAL ANSWER:
2
2
  Answer the following question using step-by-step reasoning. Show your work.
3
3
 
4
+ SOURCE MATERIAL:
5
+ [Optional — paste the document the question below is grounded in here (the
6
+ requirements list, contract, specification, or dataset that states the
7
+ conditions to be satisfied). If every condition is already stated in the
8
+ question itself, delete this bracketed block and the sentence directly below
9
+ it.]
10
+ Treat the material above as part of the original question at every step below.
11
+
4
12
  QUESTION:
5
13
  [Your question with all conditions and constraints]
6
14