Skip to content

Commit c9808e8

Browse files
committed
Round 83: composable prompt Primary workflow surface parity
Panel EU–EX: strict Primary workflow surface(s) ↔ *_SKILL_LINKS for 02-engineering–06-repo, engineering prompt trim, supporting-lens guard for runtime-trust-boundary; defer holdout expansion; reject router/benchmark CI. - Trim engineering prompts; add Escalate/Adjacent scope bullets - Extend test_prompt_cross_links with ENGINEERING_SKILL_LINKS and parity tests - Sync governance docs to Round 83; pytest anti-drift floor 500+
1 parent e30d358 commit c9808e8

14 files changed

Lines changed: 159 additions & 16 deletions

README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -21,7 +21,7 @@ Full library docs: [reflective-prompt-library/README.md](reflective-prompt-libra
2121
## Governance
2222

2323
- **Contributing:** [CONTRIBUTING.md](CONTRIBUTING.md) — quality gates, routing maintenance (R8–R12), `make all`
24-
- **Panel record:** [multi-agent-panel-consensus](reflective-prompt-library/plans/multi-agent-panel-consensus-2026-06-25.md) — six-lens Socratic consensus (Rounds 1–82)
24+
- **Panel record:** [multi-agent-panel-consensus](reflective-prompt-library/plans/multi-agent-panel-consensus-2026-06-25.md) — six-lens Socratic consensus (Rounds 1–83)
2525
- **Operator playbook:** [GLOSSARY.md](reflective-prompt-library/GLOSSARY.md) — Governance Maintenance Playbook
2626

2727
The repository contains:

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

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,12 @@ Use this to review a PR, diff, code sample, or AI-generated code against spec, a
44

55
## Purpose
66

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.
7+
Review diffs against spec, tests, and risks. Primary workflow surface: `reflective-review`. Pairs with `01-thinking/critical-thinking-check.md` for claim audits.
88

99
## Scope
1010

1111
- In scope: correctness, test integrity, architecture fit, spec traceability, required fixes.
12+
- Escalate: pair with `reflective-minimality` for complexity-only findings.
1213
- Out of scope: writing the spec (`reflective-spec-plan`), implementing fixes (`reflective-implement`).
1314

1415
## Acceptance Criteria

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

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,12 @@ Suitable for Codex, Cursor, OpenCode, Claude Code, and other repo-aware coding a
44

55
## Purpose
66

7-
Repo-aware implementation with traceability. Primary workflow surface: `reflective-implement`; escalate to `reflective-risk` before trust-boundary or high-blast-radius changes. Pairs with `01-thinking/counterargument.md` for simpler alternatives before adding code.
7+
Repo-aware implementation with traceability. Primary workflow surface: `reflective-implement`. Pairs with `01-thinking/counterargument.md` for simpler alternatives before adding code.
88

99
## Scope
1010

1111
- In scope: minimal safe edits, tests per acceptance criterion, spec-to-code traceability, residual risk report.
12+
- Escalate: route to `reflective-risk` before trust-boundary or high-blast-radius changes.
1213
- Out of scope: spec authoring (`reflective-spec-plan`), complexity-only review (`reflective-minimality`).
1314

1415
## Acceptance Criteria

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

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,12 @@ Use this when something fails.
44

55
## Purpose
66

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. Pairs with `01-thinking/critical-thinking-check.md` for evidence and assumption audits.
7+
Structured LOCAL_FEEDBACK loop for failures during implementation. Primary workflow surface: `reflective-implement`. Pairs with `01-thinking/critical-thinking-check.md` for evidence and assumption audits.
88

99
## Scope
1010

1111
- In scope: step, evidence, root cause, correction, verification, anti-regression rule.
12+
- Escalate: route to `reflective-review` when the failure implicates spec or test adequacy.
1213
- Out of scope: spec rewriting (`reflective-spec-plan`), formal blast-radius gating (`reflective-risk`).
1314

1415
## Acceptance Criteria

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

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,12 @@ Use this at the start of a new task before implementation.
44

55
## Purpose
66

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`.
7+
Establish a task brief before implementation. Primary workflow surface: `reflective-brief`. Pairs with `01-thinking/why-what-how-done.md` and `01-thinking/falsifiability.md`.
88

99
## Scope
1010

1111
- In scope: goal, assumptions, scope boundaries, acceptance criteria, falsifiability, minimal plan before coding.
12+
- Escalate: route to `reflective-spec-plan` when the brief is ready for ticket slicing.
1213
- Out of scope: repository edits (`reflective-implement`), formal blast-radius gating (`reflective-risk`).
1314

1415
## Acceptance Criteria

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

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -4,11 +4,12 @@ Use this to avoid specs that look good but are awkward in practice.
44

55
## Purpose
66

7-
Derive usage-driven spec fixes before implementation. Primary workflow surface: `reflective-spec-plan`; pair with `reflective-brief` when goals are still fuzzy. Pairs with `01-thinking/socratic-reviewer.md` to clarify the real user problem.
7+
Derive usage-driven spec fixes before implementation. Primary workflow surface: `reflective-spec-plan`. Pairs with `01-thinking/socratic-reviewer.md` to clarify the real user problem.
88

99
## Scope
1010

1111
- In scope: personas, scenarios, I/O examples, confusion points, spec revisions from usage narrative.
12+
- Adjacent: pair with `reflective-brief` when goals are still fuzzy.
1213
- Out of scope: code changes (`reflective-implement`).
1314

1415
## Acceptance Criteria

reflective-prompt-library/GLOSSARY.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -337,7 +337,7 @@ Curated top-of-cheatsheet summary of high-confusion routing traps (ROUTE-002 hol
337337

338338
## Governance Maintenance Playbook / 治理維護手冊
339339

340-
Ongoing upkeep after panel close (Rounds 1–82). Not agent instructions — operator checklist.
340+
Ongoing upkeep after panel close (Rounds 1–83). Not agent instructions — operator checklist.
341341

342342
**Operational test:** Before router tuning, add fresh ROUTE-002/003 holdout phrases; run `make all`; record decisions in `PROJECT_KNOWLEDGE.md` Decision Index when governance surface changes.
343343

@@ -355,3 +355,4 @@ Ongoing upkeep after panel close (Rounds 1–82). Not agent instructions — ope
355355
12. When adding or editing `01-thinking/` lenses, keep `## Human Review` in the preamble (routes to `reflective-risk`) and run `test_thinking_prompts_eval_harness.py`.
356356
13. When editing workflow skill Escalation bullets, cite only frozen `reflective-*` skills; run `test_skill_module_contract.py` escalation route guard.
357357
14. When editing `01-thinking/` Purpose preambles, keep `Primary workflow surfaces` aligned exactly with `SKILL_THINKING_SOURCES` via `test_thinking_lens_primary_surfaces_match_consumer_graph`; put escalations and adjacent workflow notes in Scope or Human Review, not on the primary line.
358+
15. When editing composable prompts (`02-engineering``06-repo`), keep `Primary workflow surface(s)` aligned with `*_SKILL_LINKS` in `test_prompt_cross_links.py`; use Supporting lens for cross-cutting lenses like `runtime-trust-boundary.md`; put escalate/pair notes in Scope.

reflective-prompt-library/PROJECT_KNOWLEDGE.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -72,6 +72,7 @@ deferred promotions are recurrence-gated — see [panel backlog](plans/multi-age
7272

7373
## Decision Index
7474

75+
- 2026-06-25 Round 83 panel — composable prompt Primary workflow surface parity (`02-engineering``06-repo`) + supporting-lens exemption → [record](plans/multi-agent-panel-consensus-2026-06-25.md)
7576
> Pointers to the causal trail — plans, reflections, tests, commits. Detail is
7677
> not duplicated here; this is a map, not an archive.
7778

reflective-prompt-library/README.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -30,7 +30,7 @@ Pick **Strictness L1–L6** first (`skills/reflective-dispatch/SKILL.md`, [GLOSS
3030

3131
## Governance Panel Record
3232

33-
Multi-agent Socratic consensus on project goals and the nine skills (Rounds 1–82, options A–ET) is recorded in [plans/multi-agent-panel-consensus-2026-06-25.md](plans/multi-agent-panel-consensus-2026-06-25.md). Run `make all` before claiming routing or governance changes are verified.
33+
Multi-agent Socratic consensus on project goals and the nine skills (Rounds 1–83, options A–EU) is recorded in [plans/multi-agent-panel-consensus-2026-06-25.md](plans/multi-agent-panel-consensus-2026-06-25.md). Run `make all` before claiming routing or governance changes are verified.
3434

3535
## Directory Map
3636

reflective-prompt-library/plans/QUALITY_GATES_SUMMARY.md

Lines changed: 2 additions & 2 deletions
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`, `test_engineering_prompts_eval_harness.py`, `test_prompt_cross_links.py`, `test_core_prompts_eval_harness.py`, `test_agent_prompts_eval_harness.py`, `test_context_prompts_eval_harness.py`, `test_domain_prompts_eval_harness.py`, `test_repo_prompts_eval_harness.py`, `test_validate_governance.py`, `test_validate_links.py`, `test_lint_skills.py`, `test_skill_module_contract.py` (Escalation subsection + Trigger/Methods/Output/Never; 450+ pytest anti-drift suite in CI); reciprocal thinking-lens ↔ skill checks in `test_prompt_cross_links.py` (including strict Primary workflow surfaces parity via `test_thinking_lens_primary_surfaces_match_consumer_graph`); Human Review + Escalation route-target guards in thinking/skill contract tests
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`, `test_prompt_cross_links.py`, `test_core_prompts_eval_harness.py`, `test_agent_prompts_eval_harness.py`, `test_context_prompts_eval_harness.py`, `test_domain_prompts_eval_harness.py`, `test_repo_prompts_eval_harness.py`, `test_validate_governance.py`, `test_validate_links.py`, `test_lint_skills.py`, `test_skill_module_contract.py` (Escalation subsection + Trigger/Methods/Output/Never; 500+ pytest anti-drift suite in CI); reciprocal thinking-lens ↔ skill checks and composable `Primary workflow surface(s)``*_SKILL_LINKS` parity in `test_prompt_cross_links.py` (including strict Primary workflow surfaces parity via `test_thinking_lens_primary_surfaces_match_consumer_graph`); Human Review + Escalation route-target guards in thinking/skill contract tests
318318

319319
### Ongoing maintenance (not blockers)
320320

@@ -384,4 +384,4 @@ Phase 1 quality-gate tooling and documentation are **complete**. Routing consist
384384
- ✅ Benchmark fixture gate plus optional manual benchmark runs
385385
- ✅ Research-backed design decisions
386386

387-
The project is positioned to grow sustainably with quality discipline built in from the start. **No open implementation blockers** remain from panel Rounds 1–82; work is recurrence-gated maintenance per playbook. The next measurable quality target is **holdout expansion before router tuning** and optional manual baseline-vs-skill benchmark runs — not shipping new core skills without promotion evidence.
387+
The project is positioned to grow sustainably with quality discipline built in from the start. **No open implementation blockers** remain from panel Rounds 1–83; work is recurrence-gated maintenance per playbook. The next measurable quality target is **holdout expansion before router tuning** and optional manual baseline-vs-skill benchmark runs — not shipping new core skills without promotion evidence.

0 commit comments

Comments
 (0)