jpmschweitzerandClaude Opus 4.6
eebc151b9f
- CLAUDE.md: add docs/diagrams/ to project structure, add diagram file conventions for D-record changes - qatux.md: add priority 5 for diagram creation/updates - workshop-start SKILL.md: add diagram step in wrap-up sequence Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
59 lines
3.9 KiB
Markdown
59 lines
3.9 KiB
Markdown
# Qatux - Project Briefing
|
|
Last updated: 2026-02-11
|
|
|
|
## Current Project State
|
|
The Settled Reach: top-down immersive sim, single-character perspective, asymmetric information core mechanic, Rimworld-style storyteller. 40 confirmed decisions, 17 discussion rounds + 1 workshop complete. Engine selected (D-020: Godot 4 + Rust/bevy_ecs via subprocess/IPC). Vertical slice defined (D-027). v0.1 Content Gap Analysis Workshop complete.
|
|
|
|
## Decisions Relevant to Your Role
|
|
All decisions (D-001 through D-040) — maintains decision domain files in `decisions/` as the canonical record. Indexes and retrieves decision context for the team.
|
|
|
|
**D-022 (Process change):** Discussions now captured directly in round documents at `docs/discussions/round-NN-topic.md` instead of DISCUSSION.md. Qatux must be included in all team interactions to ensure documentation.
|
|
|
|
### Decision Domain Structure
|
|
Decisions are split across domain files in `decisions/`:
|
|
- `decisions/architecture.md` — D-008, D-009, D-010, D-012, D-020, D-026, D-030, D-031
|
|
- `decisions/perception.md` — D-011, D-015, D-016, D-017, D-018, D-019, D-033
|
|
- `decisions/content.md` — D-023, D-024, D-025, D-028, D-029, D-032, D-034, D-035, D-036, D-037
|
|
- `decisions/scope.md` — D-001, D-003, D-005, D-006, D-007, D-013, D-014, D-027, D-038, D-039
|
|
- `decisions/process.md` — D-004, D-021, D-022, D-040
|
|
- `decisions/questions.md` — Q-001 through Q-017
|
|
- `decisions/rejected.md` — R-001 through R-010
|
|
- `decisions/README.md` — domain index and query examples
|
|
|
|
### Workshop Summary (Latest — v0.1 Content Gap Analysis)
|
|
**Date:** 2026-02-11
|
|
**Format:** 6-agent workshop (Mellanie, Paula, Araminta, Miri, Gestalt, Ozzie), 2 rounds
|
|
**Decisions produced:** 9 (D-032 through D-040)
|
|
**Key themes:** Dual-lens content architecture, THE FRIEND NPC pattern, converged tag taxonomy (6+3), Sova Transit District as first concrete setting, entity color = relationship to player, audio specification, wow moment budget, wiki taxonomy
|
|
**Open questions added:** Q-012 through Q-017
|
|
|
|
## Open Questions Assigned to You
|
|
None assigned directly.
|
|
|
|
## Current Priorities
|
|
1. Maintain decision domain files in `decisions/` with any new confirmed decisions after each discussion round
|
|
2. Create round documents directly at `docs/discussions/round-NN-topic.md` (D-022 workflow)
|
|
3. Update `docs/discussions/README.md` with new round entries after formal closure
|
|
4. Update relevant agent briefing files with new decision references
|
|
5. **Create and update diagrams** whenever D-records are added or modified — use the `/d2-diagram` skill to generate d2 source + PNG. New decisions get a diagram if they describe systems, flows, or relationships. Existing diagrams in `docs/diagrams/{category}/` must be updated when their source decisions change. Categories: architecture, data-flow, entity, state, ui.
|
|
6. Re-index changed documents in Qdrant after updates
|
|
7. Verify briefing freshness against decision domain files
|
|
|
|
## Key Documents
|
|
- `decisions/` — domain-split decision files (see `decisions/README.md` for index)
|
|
- `docs/discussions/` — archived rounds (including active rounds per D-022)
|
|
- `docs/briefings/` — agent briefing files (you maintain these)
|
|
- `docs/diagrams/` — decision diagrams (architecture, data-flow, entity, state, ui) — `.d2` source + `.png` renders
|
|
- `docs/workshops/` — workshop briefs, outputs, and summaries
|
|
- `TEAM.md` — team roster
|
|
|
|
## Recent Archive Activity
|
|
- 2026-02-11: v0.1 Content Gap Analysis Workshop documented
|
|
- Created `docs/workshops/content-gap-analysis_v0_1/SUMMARY.md`
|
|
- Added D-032 through D-040 to decision domain files
|
|
- Added Q-012 through Q-017 to `decisions/questions.md`
|
|
- Updated all 6 workshop participant briefings (mellanie, paula, araminta, miri, gestalt, ozzie)
|
|
- Updated all 12 non-workshop briefings for decision count and resolved questions
|
|
- 2026-02-10: Round 17 archived to `docs/discussions/round-17-content-architecture.md`
|
|
- 2026-02-10: All agent briefings updated with Round 17 decisions
|