Package the canonical PQRST prompt faithfully

examples/pqrst-estimate was not the canonical PQRST prompt. The canonical one
is ~/pqrst-practice/PqrstPrompt.md, normatively specified in
spec/PqrstEstimationPractice.md, and hall-of-helix CLOSING.md requires pasting
that block unmodified. Ours was a paraphrase with a different output shape — no
Confidence, no Signature, no Dominant factors — and CANP-WP-0002-T03 made it
worse by prepending a house_style inclusion to a prompt whose governing
document says do not modify it.

A copied prompt that silently forked its source is the exact failure INTENT.md
opens with, sitting in this repo's own examples directory.

The template is now the canonical block extracted programmatically rather than
retyped, and the default render is byte-identical to it: 2886 bytes both ways.

The source documents two optional add-ons appended after the block. CPF has no
conditionals, so they are not a flag: `add_ons` is an input defaulting to the
empty string, and each sanctioned add-on is an example fixture. This is worth
noting as evidence about section 23's deferred "richer template syntax" — the
workaround is adequate here, but it is a workaround.

evals/canonical-fidelity.yaml guards the property with sixteen render checks,
including not_contains checks naming the paraphrase this package used to be, so
the drift cannot silently recur.

Version 0.2.1 -> 1.0.0: changed inputs and a materially different intended
output is the MAJOR case in section 17.

Section 22's worked example and the house-style README both claimed
pqrst-estimate composes the style fragment. It no longer does, by design, so
both are corrected; composition is illustrated in section 10.4 instead.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01Bjefh8NUiEiahN4JLwoSKM

Assistant: claude-code
Assistant-Model: opus
Assistant-Process: 388925@bnt-lap001
Assistant-Session: 3507023f-e0fd-4a1e-9d90-a0d4217d1502
This commit is contained in:
tegwick 2026-09-06 15:26:36 +02:00
parent 55b8600946
commit f55ef13c75
8 changed files with 144 additions and 151 deletions

View file

@ -1,54 +1,49 @@
format: canned-prompt/v0.2
id: practice/pqrst-estimate
name: PQRST Estimate
version: 0.2.1
summary: 'Produce a post-session estimate of effort distributed across the PQRST categories
for an agentic coding session.
'
version: 1.0.0
summary: >
The canonical end-of-session PQRST effort audit: allocate 100% of a completed
session's engineering effort across Problem, Quality, Research, Security and
Task organization.
type: template
template: prompt.md
dependencies:
prompts:
- id: practice/house-style
version: '>= 0.1.0'
requirement: required
inputs:
- name: house_style
- name: add_ons
type: content
required: false
description: 'Shared house-style block, composed from practice/house-style.
description: >
Optional text appended after the canonical block. Empty by default, so the
default render is the canonical prompt verbatim. The two sanctioned add-ons
are in examples/; see README.md.
default: ''
'
default:
include: practice/house-style
- name: session_summary
type: content
required: true
description: 'Session transcript, summary, or sufficiently detailed account of the
work performed during the coding session.
'
parameters:
include_rationale:
type: boolean
default: true
description: Explain the evidence behind the estimate.
output:
format: markdown
description: A 100% PQRST effort allocation with concise interpretation.
format: text
description: >
A PQRST-Estimate record — five integer percentages summing to 100, plus
Sum, Confidence, Signature, Dominant factors and an optional Notes line.
compatibility:
capabilities:
- long-context
license: MIT
examples:
- examples/basic.yaml
- examples/with-rationale.yaml
evals:
- evals/canonical-fidelity.yaml
tags:
- pqrst
- retrospective
- agentic-coding
- effort-estimation
license: MIT
provenance:
author: canned-prompts seed
examples:
- examples/basic.yaml
evals:
- evals/quality.yaml
author: pqrst-practice
source: ~/pqrst-practice/PqrstPrompt.md
normative_spec: ~/pqrst-practice/spec/PqrstEstimationPractice.md