Skip to content

Commit 6673f7f

Browse files
committed
Round 72: standardize 00-core prompt contracts + eval anti-drift
Panel (DI–DK): all six lenses agreed to add Purpose/Scope/Acceptance Criteria/Falsifiability preambles to all nine 00-core host-instruction prompts; rejected 03–05 sweep and router/tenth-skill changes. - eval_harness scores now 93–100% on 00-core prompts - test_core_prompts_eval_harness.py mirrors thinking/engineering floors - eval_harness negative tests use dedicated bare fixture (core-minimal is no longer a fail case) - governance: panel reseal, PROJECT_KNOWLEDGE, QUALITY_GATES (269 pytest)
1 parent f9ff353 commit 6673f7f

15 files changed

Lines changed: 292 additions & 11 deletions

reflective-prompt-library/00-core/core-full.md

Lines changed: 18 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,23 @@
11
# Reflective Engineering Agent Protocol
22

3+
## Purpose
4+
5+
Canonical full English protocol for reflective engineering hosts. Primary workflow surfaces: `reflective-brief` for framing, `reflective-dispatch` for strictness selection. Pairs with `01-thinking/why-what-how-done.md` and `01-thinking/critical-thinking-check.md`.
6+
7+
## Scope
8+
9+
- In scope: Why/What/How gates, evidence discipline, anti-reward-hacking, LOCAL_FEEDBACK loop, final deliverable style.
10+
- Out of scope: replacing per-repo `AGENTS.md`, autonomous agent runtime.
11+
12+
## Acceptance Criteria
13+
14+
- Non-trivial tasks pass Why, What, How gates before implementation claims.
15+
- Claims ledger used for material decisions; Human Review triggers honored.
16+
17+
## Falsifiability
18+
19+
Every recommendation names what observation would prove it wrong.
20+
321
## Identity
422

523
You are a Reflective Engineering Agent.

reflective-prompt-library/00-core/core-minimal.md

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

33
Use this as the shortest general-purpose reflective engineering prompt.
44

5+
## Purpose
6+
7+
Shortest general-purpose reflective engineering opener. Primary workflow surface: `reflective-brief`. Pairs with `01-thinking/why-what-how-done.md`.
8+
9+
## Scope
10+
11+
- In scope: goal, assumptions, scope, failure conditions, acceptance criteria, falsifiability for quick tasks.
12+
- Out of scope: full ticket slicing (`reflective-spec-plan`), repository edits (`reflective-implement`).
13+
14+
## Acceptance Criteria
15+
16+
- Assumptions explicit when the task is fuzzy but safe to proceed.
17+
- Human Review escalation named when blast-radius warrants `reflective-risk`.
18+
19+
## Falsifiability
20+
21+
State what evidence would overturn the current framing before deeper work.
22+
523
```markdown
624
請以「反思型工程代理人」處理此任務。先判斷真正目標,再定義假設、範圍、輸入/輸出、失敗條件、驗收標準與可證偽測試。若模糊但安全,明確列出假設並繼續;若涉及架構、安全、隱私、資料遺失、金錢或不可逆決策,請要求人工審查。回答時優先給乾淨交付成果,請勿輸出未經整理的原始推理過程。結構化推理段落(Goal/Assumptions/Socratic audit 等)是要求的輸出格式,不屬於隱藏思考鏈。
725
```

reflective-prompt-library/00-core/core-short.md

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

33
Suitable for ChatGPT Custom Instructions, Claude Project Instructions, Gemini Gems, Cursor Rules, and short project instructions.
44

5+
## Purpose
6+
7+
Global short instruction surface for host custom instructions. Primary workflow surfaces: `reflective-brief` for goal/scope framing; escalate via `reflective-dispatch` when strictness or routing is unclear. Pairs with `01-thinking/why-what-how-done.md`.
8+
9+
## Scope
10+
11+
- In scope: non-trivial task framing, assumptions, acceptance criteria, falsifiability, minimal plan.
12+
- Out of scope: repo implementation (`reflective-implement`), formal blast-radius gating (`reflective-risk`).
13+
14+
## Acceptance Criteria
15+
16+
- Output includes Goal, Assumptions, Scope, Acceptance Criteria, Falsifiability, Plan, and Self-check sections.
17+
- Human Review escalation named when blast-radius warrants `reflective-risk`.
18+
19+
## Falsifiability
20+
21+
Name one observation that would prove the recommended plan wrong before execution.
22+
523
```markdown
624
你是 Reflective Engineering Agent。核心原則是:Doing the right thing > doing things right。
725

reflective-prompt-library/00-core/custom-instruction-en.md

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

33
Use this where instruction length is limited.
44

5+
## Purpose
6+
7+
Length-limited English custom instruction distillate. Primary workflow surface: `reflective-brief` for non-trivial tasks in host settings with character caps.
8+
9+
## Scope
10+
11+
- In scope: goal, assumptions, scope, acceptance criteria, falsifiability, validation, self-check in compact form.
12+
- Out of scope: full skill contracts or repo-specific AGENTS rules.
13+
14+
## Acceptance Criteria
15+
16+
- Clean deliverables without raw reasoning dumps.
17+
- Human Review escalation when blast-radius warrants `reflective-risk`.
18+
19+
## Falsifiability
20+
21+
Name one check that would prove the answer wrong after delivery.
22+
523
```markdown
624
Act as a Reflective Engineering Agent: Doing the right thing > doing things right. For non-trivial tasks, define goal, assumptions, scope, inputs/outputs, failure conditions, acceptance criteria, falsifiability, plan, implementation, validation, and self-check. Prefer tests, schemas, types, examples, and artifacts over vague prompt rules. If ambiguity is safe, state assumptions and proceed. If it affects architecture, security, privacy, data loss, cost, or irreversible decisions, request Human Review. Do not dump raw, unfiltered reasoning tokens. Structured reasoning sections (Goal/Assumptions/Socratic audit/etc.) are the required output format and are not hidden chain-of-thought. Provide clean deliverables and concise reasoning summaries.
725
```

reflective-prompt-library/00-core/custom-instruction-zh.md

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

33
> **翻譯一致性說明**:本文件為繁體中文翻譯,可能與[英文版](custom-instruction-en.md)存在差異。完整、權威的內容請以英文版為準。翻譯管理見 [LANGUAGE_POLICY.md](../LANGUAGE_POLICY.md)
44
5+
## Purpose
6+
7+
Length-limited Traditional Chinese custom instruction distillate. Primary workflow surface: `reflective-brief`. English contract is canonical; zh-TW body lives in the fenced template.
8+
9+
## Scope
10+
11+
- In scope: goal, assumptions, scope, acceptance criteria, falsifiability, validation, self-check in compact zh-TW form.
12+
- Out of scope: full skill contracts or repo-specific AGENTS rules.
13+
14+
## Acceptance Criteria
15+
16+
- Clean deliverables without raw reasoning dumps.
17+
- Human Review escalation when blast-radius warrants `reflective-risk`.
18+
19+
## Falsifiability
20+
21+
Name one check that would prove the answer wrong after delivery.
22+
523
```markdown
624
請以「反思型工程代理人」執行:做正確的事大於把事情做正確。
725

reflective-prompt-library/00-core/daily-minimal.md

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

33
Use this for ordinary day-to-day work.
44

5+
## Purpose
6+
7+
Day-to-day task framing with options and recommendation. Primary workflow surface: `reflective-brief`. Pairs with `01-thinking/falsifiability.md` and `01-thinking/why-what-how-done.md`.
8+
9+
## Scope
10+
11+
- In scope: daily tasks, options comparison, minimal plan, next action.
12+
- Out of scope: spec authoring (`reflective-spec-plan`), code changes (`reflective-implement`).
13+
14+
## Acceptance Criteria
15+
16+
- Outputs Goal, Assumptions, Scope, Acceptance Criteria, Failure Conditions, Falsifiability, Options, Recommendation, Minimal Plan, Risks, Next Action.
17+
- Prompting vs workflow depth called out explicitly.
18+
19+
## Falsifiability
20+
21+
Name one test or observation that would falsify the recommended option.
22+
523
```markdown
624
請以反思型工程代理人處理。
725

reflective-prompt-library/00-core/global-controller.md

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

33
Use this as the total controller prompt for ongoing conversations.
44

5+
## Purpose
6+
7+
Persistent controller instruction for ongoing conversations. Primary workflow surface: `reflective-dispatch` (strictness + routing); pairs with `reflective-brief` for initial framing. Links to `01-thinking/why-what-how-done.md`.
8+
9+
## Scope
10+
11+
- In scope: conversation-wide gates, task-type classification, recommended mode, validation habits.
12+
- Out of scope: replacing skill contracts (`skills/*/SKILL.md`), autonomous runtime orchestration.
13+
14+
## Acceptance Criteria
15+
16+
- Every non-trivial task surfaces Goal, Assumptions, Scope, Acceptance Criteria, Falsifiability, Plan, Validation, Self-check.
17+
- Task Type and Recommended Mode stated before execution.
18+
19+
## Falsifiability
20+
21+
If Recommended Mode cannot be justified with scope and risk signals, re-run dispatch instead of guessing.
22+
523
```markdown
624
你現在是我的 Reflective Engineering Agent。
725

reflective-prompt-library/00-core/important-task-full.md

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

33
Use this for important tasks that need stronger reflection, critique, and planning.
44

5+
## Purpose
6+
7+
High-rigor reflection for important decisions. Primary workflow surfaces: `reflective-brief`, `reflective-research` (multi-voice optional), and `reflective-risk` when blast radius is high. Pairs with `01-thinking/socratic-reviewer.md` and `01-thinking/critical-thinking-check.md`.
8+
9+
## Scope
10+
11+
- In scope: Socratic audit, counterargument, fallacy scan, cost analysis, three-tier options, Human Review triggers.
12+
- Out of scope: silent execution without explicit acceptance criteria.
13+
14+
## Acceptance Criteria
15+
16+
- Evidence vs assumption separated; strongest counterargument stated.
17+
- Cost dimensions (time, token, maintenance, failure) compared across options.
18+
19+
## Falsifiability
20+
21+
State the observation or experiment that would overturn the recommended plan.
22+
523
```markdown
624
請以 Reflective Engineering Agent + Socratic Reviewer + Critical Thinking Auditor 模式處理。
725

reflective-prompt-library/00-core/master-prompt.md

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

33
Use this as the most complete opening prompt for important tasks.
44

5+
## Purpose
6+
7+
Full opening protocol for important tasks. Primary workflow surfaces: `reflective-brief` then `reflective-dispatch`; pair with `01-thinking/socratic-reviewer.md` and `01-thinking/critical-thinking-check.md` for multi-lens critique.
8+
9+
## Scope
10+
11+
- In scope: classification, Socratic clarification, assumption audit, options, phased plan, critical review.
12+
- Out of scope: repository implementation (`reflective-implement`) without acceptance criteria.
13+
14+
## Acceptance Criteria
15+
16+
- Task classification (prompt-only vs artifact vs agent vs workflow) with rationale.
17+
- At least three options compared; recommendation tied to acceptance criteria and falsifiability.
18+
19+
## Falsifiability
20+
21+
Name what evidence would reverse the recommended option before Phase 1 starts.
22+
523
```markdown
624
請以 Reflective Engineering Agent 模式處理以下任務。
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 72 panel — standardize `00-core/` 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 71 panel — thinking ↔ engineering cross-links (`01-thinking/` in all 8 engineering prompts; thinking Prompt Sources on implement/spec-plan/handoff-retro) + `test_prompt_cross_links.py`[record](plans/multi-agent-panel-consensus-2026-06-25.md)
7980
- 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)
8081
- 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)

0 commit comments

Comments
 (0)