feat(workflows): enforce research checkpoints across development phases

This commit is contained in:
Julian lechner committed 2026-10-08 14:38:05 +02:00
1 parent fe7a4d7a25
commit 3586245408
12 files changed
+19 -10

No files matched your search

@@ -12,7 +12,7 @@ Use before a change when its consumers, compatibility effects, or blast radius a
1. Define the proposed change and the behavior or contract it affects.
2. Locate direct callers, related implementations, shared helpers, configuration, generated output, and relevant tests. Start with exact-path and symbol searches; broaden only when the flow is unclear.
3. Trace likely impact through runtime paths, persisted data, client integrations, deployment, and documentation as applicable.
4. Identify compatibility concerns, failure modes, security or data-loss risks, and dependencies on version or environment.
4. Identify compatibility concerns, failure modes, security or data-loss risks, and dependencies on version or environment. Before confirming external compatibility or recommending an approach, MUST apply the planning checkpoint in `technical-research` and attach matching evidence or mark the assumption unresolved.
5. Separate confirmed impacts from assumptions and unknowns. Do not treat a possible downstream effect as a fact without evidence.
6. Recommend proportionate verification tied to the risks found.
@@ -12,7 +12,7 @@ Use when a request lacks enough detail to estimate or verify the intended techni
1. State the user or system outcome in concrete terms.
2. Define what is in scope and what is explicitly out of scope based on the request and current behavior.
3. Write observable acceptance criteria, including relevant failure or edge cases.
4. Record constraints, dependencies, compatibility requirements, and assumptions separately.
4. Record constraints, dependencies, compatibility requirements, and assumptions separately. Before accepting external technology constraints as established, MUST apply the planning checkpoint in `technical-research`; carry its evidence or unresolved gaps into the work item.
5. Ask only questions whose answers would materially change behavior, contracts, permissions, or acceptance. Choose safe reversible defaults for minor implementation details.
6. Identify unresolved risks and a proportionate verification approach.