tegwick
96d11431dc
Assistant: codex Assistant-Model: gpt-6-astra Assistant-Session: 01a0cffe-206f-7323-89d3-b20ca4cf4bf9
51 lines
3.8 KiB
Markdown
51 lines
3.8 KiB
Markdown
# Validation cases
|
|
|
|
Status: synthetic briefs · VC-01 and VC-02 have drafts/self-reviews; other cases remain planned.
|
|
|
|
[VC-01 draft](../walkthroughs/VC01-TransactionalAdministration.md) and [VC-02 draft](../walkthroughs/VC02-OfflineFieldNotes.md) are reasoning exercises,
|
|
not runtime validation or M1 acceptance.
|
|
|
|
These briefs are inputs for reasoning tests, not claims about real systems. Keep
|
|
inputs fixed when comparing approaches. Record all additional assumptions.
|
|
|
|
| Case | Fixed starting constraints | Key challenge | Phase |
|
|
| --- | --- | --- | --- |
|
|
| VC-01 Transactional administration | Shared records; server validates writes; concurrent edits; deep links; keyboard operation; failed requests recoverable | Distinguish drafts, optimistic feedback, committed state and stale observations | M1 |
|
|
| VC-02 Offline field notes | Create and edit without connectivity; restart without losing work; later multi-device sync; conflicting edits possible | Local authority, persistence, identity and explicit reconciliation | M1 |
|
|
| VC-03 Content publication | Mostly read-only; shareable URLs; useful content before scripts; slow network | Avoid unnecessary client execution; preserve accessible navigation | M2 |
|
|
| VC-04 Collaborative editor | Concurrent editing; presence; reconnect; undo; access changes | Distinguish durable document changes, ephemeral presence and authorization | M2 |
|
|
| VC-05 Real-time dashboard | Frequent updates; disconnects; stale indicators; bounded client compute | Communication lifetime, freshness and overload | M2 |
|
|
| VC-06 Microfrontend estate | Independent teams/releases; shared navigation; partial outages | Separate ownership, composition and deployment boundaries | M2 |
|
|
| VC-07 Storefront | Crawlable catalog; price changes; cart; authoritative checkout | Cacheability versus transaction correctness | M2 coverage |
|
|
| VC-08 SaaS workspace | Dense interaction; multiple views; shared data; long sessions | Derived state, component boundaries and interaction continuity | M2 coverage |
|
|
| VC-09 Local-first personal tool | Private local data; optional sync; backup and restore | Separate local ownership from replication and recovery | M2 coverage |
|
|
| VC-10 Mobile web application | Intermittent network; constrained memory; interrupted sessions | Persistence, startup cost and recoverability | M2 coverage |
|
|
|
|
M2 completes VC-03 through VC-06 and explicitly marks VC-07 through VC-10 covered,
|
|
partially covered or unresolved with evidence. Coverage is not a completed walkthrough.
|
|
M3 selects real repositories with accessible source/history and records exact revisions.
|
|
Do not treat synthetic results as empirical confirmation.
|
|
|
|
## Required result for each completed case
|
|
|
|
Use [ArchitectureWalkthrough](../../templates/ArchitectureWalkthrough.md). Include:
|
|
|
|
- constraints and assumptions, including cross-cutting quality requirements;
|
|
- ordered decisions with pattern references, alternatives and rationale;
|
|
- at least one branch caused by a changed constraint;
|
|
- failure/recovery behavior and unresolved forces;
|
|
- evidence links and distinction between observation and inference;
|
|
- comparison with an architecture narrative without the pattern language.
|
|
|
|
Assess traceability, coherence, decision usefulness, quality coverage and handling
|
|
of the changed constraint as pass/revise/unknown, with reasons. Do not combine
|
|
these into an unsupported numerical confidence score.
|
|
|
|
## Held-out retrieval evaluation (M3)
|
|
|
|
Freeze a corpus revision before preparing at least six new prompts derived from
|
|
unseen variants. Include incompatible constraints, an underspecified brief and an
|
|
out-of-scope problem. Record expected acceptable patterns, prohibited claims and
|
|
when to ask for context or abstain. Compare retrieval with manual navigation;
|
|
report unsupported recommendations, missed constraints and unresolved references.
|
|
Keep development examples separate from the held-out set.
|