Establish phased research program with evidence and validation gates

Assistant: codex
Assistant-Model: gpt-6-astra
Assistant-Session: 01a0cffe-206f-7323-89d3-b20ca4cf4bf9
This commit is contained in:
tegwick 2026-09-24 07:58:09 +02:00
parent 2a5dabdc85
commit 8a141b7fe5
12 changed files with 438 additions and 113 deletions

View file

@ -0,0 +1,42 @@
# Architecture walkthrough — <case>
Status: planned | drafted | reviewed
Case and corpus revision:
Author / reviewer / date:
Synthetic brief or observed repository (URL and revision):
## Fixed brief and assumptions
Include authority, latency, offline, concurrency, accessibility, security, privacy,
performance and recovery constraints. Mark unspecified requirements explicitly.
## Baseline narrative without the pattern catalog
Describe a plausible architecture and its trade-offs for comparison.
## Decisions
| Order | Context and forces | Pattern references | Alternatives and rejection reasons | Resulting context | Evidence |
| --- | --- | --- | --- | --- | --- |
## Change one constraint
State the change and trace its impact through the decisions and pattern relations.
## Failure and recovery
Describe stale reads, rejected mutations, interruption and partial failure as applicable.
## Review
| Criterion | Pass / revise / unknown | Evidence and reason |
| --- | --- | --- |
| Traceability | | |
| Coherence of configuration | | |
| Decision usefulness beyond baseline | | |
| Quality constraints | | |
| Changed-constraint branch | | |
## Gaps and follow-up
Record missing patterns, invalid relations, ordering failures and work record links.

34
templates/SourceReview.md Normal file
View file

@ -0,0 +1,34 @@
# Source review — <title>
Status: queued | extracted | reviewed
Reviewer and review date:
Research question / hypothesis:
Potential disconfirming evidence:
## Source identity
- Author / publisher:
- Title:
- URL or bibliographic locator:
- Publication date / version:
- Access date:
- Primary or secondary source; independence from other sources:
## Claims
| Label | Source claim (paraphrase) | Section/page/revision | Assumptions | Our interpretation |
| --- | --- | --- | --- | --- |
| C01 | | | | |
## Candidate patterns and forces
Link candidates and explain competing forces, recurrence and resulting contexts.
## Counterevidence and limits
Separate observed counterexamples from hypothetical ones. Record inaccessible evidence.
## Conclusion and next action
Support, revise, reject or defer the hypothesis; explain why. Link the question
ledger, candidate/source catalogs and any follow-up work record.