Skip to content

Commit 94b2549

Browse files
committed
feat(engineering): Round 70 prompt contract standardization
Six-lens panel unanimously standardized all eight 02-engineering/ prompts with Purpose/Scope/Acceptance/Falsifiability contracts, workflow-skill routing, and eval_harness anti-drift tests (80%+ floor). Mirrors Round 69 thinking-prompt pass; zh-TW templates unchanged inside fenced blocks.
1 parent 61ff35a commit 94b2549

12 files changed

Lines changed: 284 additions & 2 deletions

reflective-prompt-library/02-engineering/code-reviewer.md

Lines changed: 22 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,28 @@
22

33
Use this to review a PR, diff, code sample, or AI-generated code against spec, acceptance criteria, tests, and risks.
44

5+
## Purpose
6+
7+
Review diffs against spec, tests, and risks. Primary workflow surface: `reflective-review`; pair with `reflective-minimality` for complexity-only findings and `01-thinking/critical-thinking-check.md` for claim audits.
8+
9+
## Scope
10+
11+
- In scope: correctness, test integrity, architecture fit, spec traceability, required fixes.
12+
- Out of scope: writing the spec (`reflective-spec-plan`), implementing fixes (`reflective-implement`).
13+
14+
## Acceptance Criteria
15+
16+
- Spec traceability table completed.
17+
- Decision is Approve, Request changes, or Reject with non-empty required fixes when not Approve.
18+
19+
## Falsifiability
20+
21+
If no failing acceptance criterion can be tied to code or test evidence, state an explicit pass rationale (for example, lean already).
22+
23+
## Human Review
24+
25+
Escalate to `reflective-risk` when findings imply trust-boundary or high-blast-radius issues this review cannot sign off alone.
26+
527
```markdown
628
你是嚴格的 Code Reviewer。請不要只看程式是否能跑,請對照 spec、acceptance criteria、測試與風險。
729

reflective-prompt-library/02-engineering/implementation-agent.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,29 @@
22

33
Suitable for Codex, Cursor, OpenCode, Claude Code, and other repo-aware coding agents.
44

5+
## Purpose
6+
7+
Repo-aware implementation with traceability. Primary workflow surface: `reflective-implement`; escalate to `reflective-risk` before trust-boundary or high-blast-radius changes.
8+
9+
## Scope
10+
11+
- In scope: minimal safe edits, tests per acceptance criterion, spec-to-code traceability, residual risk report.
12+
- Out of scope: spec authoring (`reflective-spec-plan`), complexity-only review (`reflective-minimality`).
13+
14+
## Acceptance Criteria
15+
16+
- Commands run and pass/fail reported.
17+
- Each acceptance criterion mapped to code and test evidence.
18+
- No weakened or deleted tests without explicit approval.
19+
20+
## Falsifiability
21+
22+
If tests pass but a stated acceptance criterion lacks code evidence, the task is not complete.
23+
24+
## Human Review
25+
26+
Escalate to `reflective-risk` for trust-boundary edits, data-loss paths, billing impact, or breaking public APIs.
27+
528
```markdown
629
You are an implementation agent.
730

reflective-prompt-library/02-engineering/local-feedback.md

Lines changed: 23 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,29 @@
22

33
Use this when something fails.
44

5+
## Purpose
6+
7+
Structured LOCAL_FEEDBACK loop for failures during implementation. Primary workflow surface: `reflective-implement`; escalate to `reflective-review` when the failure implicates spec or test adequacy.
8+
9+
## Scope
10+
11+
- In scope: step, evidence, root cause, correction, verification, anti-regression rule.
12+
- Out of scope: spec rewriting (`reflective-spec-plan`), formal blast-radius gating (`reflective-risk`).
13+
14+
## Acceptance Criteria
15+
16+
- Root cause separated from symptom.
17+
- Verification step names an observable pass signal.
18+
- Rollback decision explicit.
19+
20+
## Falsifiability
21+
22+
If the proposed correction cannot be verified with a named command or observation, treat it as hypothesis not fix.
23+
24+
## Human Review
25+
26+
Escalate to `reflective-risk` when rollback or correction implies trust-boundary or data-loss blast radius.
27+
528
```markdown
629
請用 LOCAL_FEEDBACK 流程分析錯誤。
730

reflective-prompt-library/02-engineering/spec-writer.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,25 @@
22

33
Use this to convert requirements into an implementable, testable, reviewable spec.
44

5+
## Purpose
6+
7+
Convert requirements into an implementable, testable spec. Primary workflow surface: `reflective-spec-plan`. Pairs with `01-thinking/falsifiability.md` for hypothesis framing.
8+
9+
## Scope
10+
11+
- In scope: problem, goals, non-goals, requirements with acceptance criteria per REQ, edge cases, failure modes.
12+
- Out of scope: code changes (`reflective-implement`), complexity-only cuts (`reflective-minimality`).
13+
14+
## Acceptance Criteria
15+
16+
- Each functional requirement has acceptance criteria and a test idea.
17+
- Non-goals and open questions listed.
18+
- Owner sign-off points flagged when specs need human decision.
19+
20+
## Falsifiability
21+
22+
Name at least one REQ whose failure in a pilot would invalidate the proposed approach.
23+
524
```markdown
625
你是 Spec Writer。請將以下需求轉成可實作、可測試、可審查的 spec。
726

reflective-prompt-library/02-engineering/task-slicer.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,24 @@
22

33
Use this to split a spec into independent, testable, reviewable tickets.
44

5+
## Purpose
6+
7+
Slice a spec into independently verifiable tickets. Primary workflow surface: `reflective-spec-plan`.
8+
9+
## Scope
10+
11+
- In scope: dependency graph, ticket boundaries, per-ticket acceptance criteria and risks.
12+
- Out of scope: implementation (`reflective-implement`).
13+
14+
## Acceptance Criteria
15+
16+
- Each ticket has goal, scope, acceptance criteria, tests, and parallelizable flag.
17+
- High-blast-radius work split into smaller tickets.
18+
19+
## Falsifiability
20+
21+
If two tickets must land together to verify anything, merge or re-slice until at least one vertical slice is independently testable.
22+
523
```markdown
624
你是 Task Slicer。請根據以下 spec,把任務切成可獨立實作、可測試、可 review 的 tickets。
725

reflective-prompt-library/02-engineering/task-start.md

Lines changed: 19 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,25 @@
22

33
Use this at the start of a new task before implementation.
44

5+
## Purpose
6+
7+
Establish a task brief before implementation. Primary workflow surface: `reflective-brief`; escalate to `reflective-spec-plan` when the brief is ready for ticket slicing. Pairs with `01-thinking/why-what-how-done.md` and `01-thinking/falsifiability.md`.
8+
9+
## Scope
10+
11+
- In scope: goal, assumptions, scope boundaries, acceptance criteria, falsifiability, minimal plan before coding.
12+
- Out of scope: repository edits (`reflective-implement`), formal blast-radius gating (`reflective-risk`).
13+
14+
## Acceptance Criteria
15+
16+
- Goal and scope in/out stated.
17+
- Acceptance criteria and falsifiability each named once.
18+
- Minimal next step and defer list included.
19+
20+
## Falsifiability
21+
22+
If the brief cannot name evidence that would prove the framing wrong, stop and clarify before planning.
23+
524
```markdown
625
請先不要直接實作。請先為以下任務建立任務規格:
726

reflective-prompt-library/02-engineering/test-designer.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,24 @@
22

33
Use this to design tests before implementation and prevent fake or weak tests.
44

5+
## Purpose
6+
7+
Design tests from a spec without implementation. Primary workflow surface: `reflective-spec-plan` (Test Plan / acceptance coverage).
8+
9+
## Scope
10+
11+
- In scope: acceptance, edge, negative, regression, and anti-cheating test design.
12+
- Out of scope: writing implementation code in the repository (`reflective-implement`).
13+
14+
## Acceptance Criteria
15+
16+
- Every acceptance criterion has at least one test case with a failure signal.
17+
- Anti-cheating checks named for implementation-agent gaming patterns.
18+
19+
## Falsifiability
20+
21+
Name a test that would fail if the spec's happiest path hides a wrong invariant.
22+
523
```markdown
624
你是 Test Designer。請根據 spec 設計測試,不要寫實作。
725

reflective-prompt-library/02-engineering/usage-first.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,24 @@
22

33
Use this to avoid specs that look good but are awkward in practice.
44

5+
## Purpose
6+
7+
Derive usage-driven spec fixes before implementation. Primary workflow surface: `reflective-spec-plan`; pair with `reflective-brief` when goals are still fuzzy.
8+
9+
## Scope
10+
11+
- In scope: personas, scenarios, I/O examples, confusion points, spec revisions from usage narrative.
12+
- Out of scope: code changes (`reflective-implement`).
13+
14+
## Acceptance Criteria
15+
16+
- At least five usage scenarios and both success and failure examples.
17+
- Spec revision recommendations tied to observed user confusion.
18+
19+
## Falsifiability
20+
21+
Name one scenario where the proposed UX would fail a naive user despite matching written requirements.
22+
523
```markdown
624
請假設這個系統已經完成,先不要寫實作,請先寫使用手冊。
725

reflective-prompt-library/PROJECT_KNOWLEDGE.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -75,6 +75,7 @@ deferred promotions are recurrence-gated — see [panel backlog](plans/multi-age
7575
> Pointers to the causal trail — plans, reflections, tests, commits. Detail is
7676
> not duplicated here; this is a map, not an archive.
7777
78+
- 2026-06-25 Round 70 panel — standardize `02-engineering/` prompt contracts (Purpose/Scope/Acceptance/Falsifiability) + eval_harness anti-drift → [record](plans/multi-agent-panel-consensus-2026-06-25.md)
7879
- 2026-06-25 Round 69 panel — standardize `01-thinking/` prompt contracts (Purpose/Scope/Acceptance/Falsifiability) + eval_harness anti-drift → [record](plans/multi-agent-panel-consensus-2026-06-25.md)
7980
- 2026-06-25 Post-Round 68 holdout expansion — ROUTE-003 minimality trap + thin adversarial group refresh (15 groups / 53 phrases) → [QUALITY_GATES_SUMMARY.md](plans/QUALITY_GATES_SUMMARY.md)
8081
- 2026-06-11 Add `runtime-trust-boundary` as a lens, not a ninth skill → [record](plans/project-adjustment-reflection-2026-06-11.md)

reflective-prompt-library/plans/QUALITY_GATES_SUMMARY.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -314,7 +314,7 @@ ROUTE-002 measures unseen phrasing separately from ROUTE-001. Round 7 (2026-06-2
314314
2. **ROUTE-001/002/003 in CI** — 128 + 102 + 53 paraphrases at 100% consistency (seeded fixtures); `validate_route_fixture.py` gates minimum coverage
315315
3. **Governance validators** — links, lint, governance metadata, PROJECT_KNOWLEDGE, benchmark fixture, skill examples
316316
4. **Harness policy docs** — CONTRIBUTING, AGENTS, SKILL_INSTALLATION, maintenance playbook
317-
5. **Doc anti-drift**`test_routing_contract.py`, cheatsheet parity tests, `test_readme_governance.py`, `test_thinking_prompts_eval_harness.py` (200+ pytest anti-drift suite in CI)
317+
5. **Doc anti-drift**`test_routing_contract.py`, cheatsheet parity tests, `test_readme_governance.py`, `test_thinking_prompts_eval_harness.py`, `test_engineering_prompts_eval_harness.py` (220+ pytest anti-drift suite in CI)
318318

319319
### Ongoing maintenance (not blockers)
320320

0 commit comments

Comments
 (0)