blue/.blue/dialogues/ukfs-spec-review/round-1/context-brief.md
Eric Garcia 6e8f0db6c0 chore: add dialogues, RFCs, docs and minor improvements
- Add dialogue prompt file writing for audit/debugging
- Update README install instructions
- Add new RFCs (0053, 0055-0059, 0062)
- Add recorded dialogues and expert pools
- Add ADR 0018 dynamodb-portable-schema
- Update TODO with hook configuration notes

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-26 08:51:56 -05:00

43 lines
2.2 KiB
Markdown

# Round 1 Context Brief
## Round 0 Summary
12 experts analyzed the UKFS specification. Key findings:
### Emerging Consensus
1. **Naming Convention**: Symlink aliases providing both forms (e/ AND entities/) is gaining support
2. **Relation Modeling**: Reification for n-ary + canonical ordering for symmetric + `--` delimiter instead of `+`
3. **Scalability**: Hash-prefix sharding (e/person/a8/alice/) + secondary index files
4. **Event Entity Type**: Add /e/event/ as first-class type
5. **Schema Layer**: Add /.schema/ for type definitions
### Open Tensions Requiring Resolution
| ID | Tension | Key Question |
|----|---------|--------------|
| T01 | Single-char vs full names | Lock the naming decision |
| T04 | Binary relations insufficient | Confirm reification approach |
| T05 | Closed entity types | Define extensibility mechanism |
| T08 | Determinism vs semantic ambiguity | Clarify what "deterministic" means |
| T14 | No implementation evidence | Define proof-of-concept scope |
### Key Perspectives from Round 0
- **Muffin**: "Single-char roots are correct. Hash-prefix sharding for scale. Relations should be directories, not files."
- **Cupcake**: "Add Event entity type. Use reification for n-ary relations. Define extensibility via /_custom/."
- **Eclair**: "Provide symlink aliases for both forms. Require MANIFEST.md in each directory."
- **Brioche**: "Add relation index manifests per entity. Define state semantics explicitly."
- **Cannoli**: "Canonical lexicographic ordering for symmetric relations. Accept O(n) scan cost for attributes."
- **Beignet**: "Adopt faceted auxiliary layer (/f/). Implement authority control for synonyms."
- **Churro**: "Prove it first. Define anti-goals. Determinism claim is overstated."
### Round 1 Objectives
1. **Lock T01**: Decide naming convention (single-char canonical + symlink aliases?)
2. **Lock T04**: Confirm relation modeling (reification + `--` delimiter + canonical ordering?)
3. **Lock T05**: Define extensibility (/_custom/? /f/ facets? Both?)
4. **Address T08**: Reframe "deterministic" claim accurately
5. **Address T14**: Define minimum viable proof-of-concept
Experts should build on Round 0 insights and drive toward convergence on these decisions.