jpmschweitzer/settled-reach
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

docs(economics): Sprint 32 planning — commodity catalog + D-171 through D-187 #114

Closed
jpmschweitzer wants to merge 0 commits from sprint-32/planning into main
pull from: sprint-32/planning
merge into: :main
Conversation 2 Commits - Files Changed -
jpmschweitzer commented 2026-04-05 22:01:58 +02:00
Owner
Copy Link
Copy Source

Summary

  • Economics design workshop #796: 17 D-records (D-171–D-187), R-011 rejected alternative
  • Commodity catalog workshop #801: 36 commodities in TOML, 21 production chains, SQL schema spec
  • Wiki stub pages for all 36 commodities
  • Sprint 32 briefing updates (joint, planning, copy, visual)
  • Burnelli-Sheldon economist agent added
  • Follow-up tickets #811–#815 created, #801 closed

Key design decisions

  • D-184 Commodity catalog: 9 raw, 10 intermediate, 9 final, 5 professional services, 3 luxury services
  • D-185 Brands (luxury goods) are NOT commodities — separate brand/cultural value layer (future DLC)
  • D-186 Gate transmission: mass + data + energy. Energy-over-gate is a Gate Corp commercial service, not Assembly policy. Compact defaults to gate_energy_connected = false
  • D-187 Fusion fuel is an intermediate refined from water at 8:1 yield, input to 3 energy-intensive chains

Test plan

  • Verify decisions/economics.md D-records are well-formed (IDs sequential, cross-references valid)
  • Verify wiki/economics/commodities.toml parses as valid TOML
  • Verify wiki/economics/production_chains.toml parses as valid TOML
  • Verify all chain inputs reference valid commodity IDs
  • Verify wiki commodity pages match TOML data
## Summary - Economics design workshop #796: 17 D-records (D-171–D-187), R-011 rejected alternative - Commodity catalog workshop #801: 36 commodities in TOML, 21 production chains, SQL schema spec - Wiki stub pages for all 36 commodities - Sprint 32 briefing updates (joint, planning, copy, visual) - Burnelli-Sheldon economist agent added - Follow-up tickets #811–#815 created, #801 closed ## Key design decisions - **D-184** Commodity catalog: 9 raw, 10 intermediate, 9 final, 5 professional services, 3 luxury services - **D-185** Brands (luxury goods) are NOT commodities — separate brand/cultural value layer (future DLC) - **D-186** Gate transmission: mass + data + energy. Energy-over-gate is a Gate Corp commercial service, not Assembly policy. Compact defaults to `gate_energy_connected = false` - **D-187** Fusion fuel is an intermediate refined from water at 8:1 yield, input to 3 energy-intensive chains ## Test plan - [ ] Verify `decisions/economics.md` D-records are well-formed (IDs sequential, cross-references valid) - [ ] Verify `wiki/economics/commodities.toml` parses as valid TOML - [ ] Verify `wiki/economics/production_chains.toml` parses as valid TOML - [ ] Verify all chain inputs reference valid commodity IDs - [ ] Verify wiki commodity pages match TOML data
jpmschweitzer added 4 commits 2026-04-05 22:01:59 +02:00
docs(meta): update Sprint 32 briefings after workshop #796 b4e4c65830 
Post-workshop briefing updates: joint notes with dependency chain,
planning team task list, copy/visual team scope adjustments, TEAM.md
roster update.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
docs(decisions): economics design workshop #796 — D-171 through D-187 9b1258568e 
Workshop #796 produced 13 D-records (D-171–D-183) defining the Phase 2
economics layer: three-currency system, commodity taxonomy, shadow
economy, corporation tiers, productivity seeding, simulation
architecture, TOML data pipeline.

Workshop #801 added D-184–D-187: commodity catalog (36 types), brands
are not commodities, gate transmission levels (mass+data+energy),
fusion fuel as intermediate (8:1 water yield).

R-011 filed (single currency rejected). Burnelli-Sheldon agent added.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
data(economics): commodity catalog — 36 types, 21 production chains ac05dbd21f 
Workshop #801 deliverable: commodities.toml (36 commodities across
5 tiers), production_chains.toml (21 Leontief recipes including
2 substitution routes), schema.md (SQL DDL + validation rules).

Key design choices: brands are not commodities (separate layer),
water→fuel at 8:1 yield, 3 political sub-flags replacing single
boolean, gate energy-over-gate as commercial service. Wiki stub
pages generated for all 36 commodities.

Tickets #811–#815 created for follow-up work. #801 closed.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
chore(meta): update changelog 69d0659066 
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
jpmschweitzer commented 2026-04-05 22:11:13 +02:00
Author
Owner
Copy Link
Copy Source

Review: sprint-32/planning → main (type: planning/economics design)

Reviewers: Tyre (architecture), Miri (world consistency), Hoshe (QA)

Hoshe (QA): REQUEST_CHANGES

Referential integrity is clean — all 21 chains validate, all 36 wiki pages exist and match TOML keys. But:

# File Issue
1 commodities.toml Build-breaker: V-13 hard failure. legal_services has demand_model = "compliance" but commission_certified = false. make economy-db would abort.
2 decisions/economics.md (D-184) Wrong political flag names. Says politically_sensitive, contraband_risk, sanctions_applicable — actual TOML fields are commission_certified, compact_contested, shadow_viable.
3 decisions/economics.md (D-184) Wrong professional services list. Lists "logistics management, data brokerage" — actual TOML has medical_services, commission_certification.
4 decisions/economics.md (D-173) Wrong elasticity count. Says "5 categories" — there are 4.
5 decisions/economics.md R-011 appears twice — inline between D-183/D-184 AND in Rejected Alternatives section.
6 Ticket #801 Stale description — still says "~30 types (7/8/7)" vs actual 36 (9/10/9).

Tyre (Architecture): REQUEST_CHANGES

Design is architecturally sound — 17 D-records form a coherent economics layer. TOML and schema are internally consistent with each other. But D-records drifted from implementation:

# File Issue
1–4 (same as Hoshe 1–4) (confirmed independently — D-184 flags/services, D-173 elasticity, V-13)
5 decisions/economics.md header D-166 domain link wrong. Points to scope.md — D-166 lives in architecture.md.
6 docs/sprints/sprint-32/joint.md Stale D-record count. Says "D-171 through D-183" — should be D-171 through D-187.
7 docs/sprints/sprint-32/planning.md Same stale count. Says "13 D-records" — should be 17.
8 .claude/agents/README.md Burnelli-Sheldon not in agent roster table.
9 docs/briefings/ Missing burnelli-sheldon.md briefing file. Convention requires it.
10 decisions/questions-architecture.md Footer tally/date not updated after Q-094 resolution.

Miri (World Consistency): REQUEST_CHANGES

Economics design is lore-coherent — currencies, Compact shadow economy, cascade mechanics all fit the setting. Production chain logic holds. But:

# File Issue
1–2 (same as Hoshe 2–3) (D-184 flag names and services list — confirmed)
3 workshop-outcomes.md (D-187) Self-contradicting fusion fuel statement. Says "does not appear in any Leontief chain" then immediately says it was adopted into 3 chains. Will mislead server team.
4 decisions/economics.md (D-171) "Sirius / Groombridge origin" is ambiguous. Is Groombridge a co-issuer or just the clearing house? Matters for political storylines.
5 commodities.toml (medical_services) demand_model = utility is wrong for a scarce, discretionary service. Should be market.
6 commodities.toml (timber) Slug/display-name mismatch. Slug is timber, display is "Timber/Biomass" — but biomass is handled by organic_compounds. Drop "/Biomass" from display name.
7 commodities.toml (hospitality) Generic description with no Reach texture. "Restaurants, hotels, gastronomy" reads like a placeholder.
8 decisions/economics.md (D-173) Superseded counts not annotated. D-173 says "~7 final goods" — actual is 9. No cross-ref to D-184.
9 commodities.toml (commission_certification) shadow_viable = false needs explicit rationale. Is certification fraud possible in this setting? The description gives no guidance.

Verdict: CHANGES REQUESTED

Deduplicated issue count: 17 unique issues across 3 reviewers.

Blocking (fix before merge):

  1. V-13 validation failure on legal_services — build-breaking
  2. D-184 political flag names don't match TOML (all 3 reviewers flagged)
  3. D-184 professional services list doesn't match TOML (all 3 reviewers flagged)
  4. D-173 elasticity count wrong (Hoshe + Tyre)
  5. Workshop outcomes self-contradicting fusion fuel statement (Miri)
  6. R-011 duplicate placement (Hoshe)

Should-fix (convention/accuracy):
7. D-166 domain link wrong (Tyre)
8. Stale D-record counts in joint.md + planning.md (Tyre)
9. Burnelli-Sheldon missing from agent roster + no briefing file (Tyre)
10. questions-architecture.md footer stale (Tyre)
11. medical_services demand_model should be market (Miri)
12. timber display name drop "/Biomass" (Miri)

Polish/ticket (non-blocking):
13. D-171 Groombridge ambiguity — clarify (Miri)
14. hospitality description needs Reach texture (Miri)
15. D-173 superseded counts need annotation (Miri)
16. commission_certification shadow_viable rationale (Miri)
17. Ticket #801 stale description (Hoshe)

## Review: sprint-32/planning → main (type: planning/economics design) **Reviewers:** Tyre (architecture), Miri (world consistency), Hoshe (QA) --- ### Hoshe (QA): REQUEST_CHANGES Referential integrity is clean — all 21 chains validate, all 36 wiki pages exist and match TOML keys. But: | # | File | Issue | |---|------|-------| | 1 | `commodities.toml` | **Build-breaker: V-13 hard failure.** `legal_services` has `demand_model = "compliance"` but `commission_certified = false`. `make economy-db` would abort. | | 2 | `decisions/economics.md` (D-184) | **Wrong political flag names.** Says `politically_sensitive`, `contraband_risk`, `sanctions_applicable` — actual TOML fields are `commission_certified`, `compact_contested`, `shadow_viable`. | | 3 | `decisions/economics.md` (D-184) | **Wrong professional services list.** Lists "logistics management, data brokerage" — actual TOML has `medical_services`, `commission_certification`. | | 4 | `decisions/economics.md` (D-173) | **Wrong elasticity count.** Says "5 categories" — there are 4. | | 5 | `decisions/economics.md` | **R-011 appears twice** — inline between D-183/D-184 AND in Rejected Alternatives section. | | 6 | Ticket #801 | **Stale description** — still says "~30 types (7/8/7)" vs actual 36 (9/10/9). | ### Tyre (Architecture): REQUEST_CHANGES Design is architecturally sound — 17 D-records form a coherent economics layer. TOML and schema are internally consistent with each other. But D-records drifted from implementation: | # | File | Issue | |---|------|-------| | 1–4 | *(same as Hoshe 1–4)* | *(confirmed independently — D-184 flags/services, D-173 elasticity, V-13)* | | 5 | `decisions/economics.md` header | **D-166 domain link wrong.** Points to `scope.md` — D-166 lives in `architecture.md`. | | 6 | `docs/sprints/sprint-32/joint.md` | **Stale D-record count.** Says "D-171 through D-183" — should be D-171 through D-187. | | 7 | `docs/sprints/sprint-32/planning.md` | **Same stale count.** Says "13 D-records" — should be 17. | | 8 | `.claude/agents/README.md` | **Burnelli-Sheldon not in agent roster table.** | | 9 | `docs/briefings/` | **Missing burnelli-sheldon.md briefing file.** Convention requires it. | | 10 | `decisions/questions-architecture.md` | **Footer tally/date not updated** after Q-094 resolution. | ### Miri (World Consistency): REQUEST_CHANGES Economics design is lore-coherent — currencies, Compact shadow economy, cascade mechanics all fit the setting. Production chain logic holds. But: | # | File | Issue | |---|------|-------| | 1–2 | *(same as Hoshe 2–3)* | *(D-184 flag names and services list — confirmed)* | | 3 | `workshop-outcomes.md` (D-187) | **Self-contradicting fusion fuel statement.** Says "does not appear in any Leontief chain" then immediately says it was adopted into 3 chains. Will mislead server team. | | 4 | `decisions/economics.md` (D-171) | **"Sirius / Groombridge origin" is ambiguous.** Is Groombridge a co-issuer or just the clearing house? Matters for political storylines. | | 5 | `commodities.toml` (`medical_services`) | **`demand_model = utility` is wrong for a scarce, discretionary service.** Should be `market`. | | 6 | `commodities.toml` (`timber`) | **Slug/display-name mismatch.** Slug is `timber`, display is "Timber/Biomass" — but biomass is handled by `organic_compounds`. Drop "/Biomass" from display name. | | 7 | `commodities.toml` (`hospitality`) | **Generic description with no Reach texture.** "Restaurants, hotels, gastronomy" reads like a placeholder. | | 8 | `decisions/economics.md` (D-173) | **Superseded counts not annotated.** D-173 says "~7 final goods" — actual is 9. No cross-ref to D-184. | | 9 | `commodities.toml` (`commission_certification`) | **`shadow_viable = false` needs explicit rationale.** Is certification fraud possible in this setting? The description gives no guidance. | --- ### Verdict: CHANGES REQUESTED **Deduplicated issue count: 17 unique issues across 3 reviewers.** **Blocking (fix before merge):** 1. V-13 validation failure on `legal_services` — build-breaking 2. D-184 political flag names don't match TOML (all 3 reviewers flagged) 3. D-184 professional services list doesn't match TOML (all 3 reviewers flagged) 4. D-173 elasticity count wrong (Hoshe + Tyre) 5. Workshop outcomes self-contradicting fusion fuel statement (Miri) 6. R-011 duplicate placement (Hoshe) **Should-fix (convention/accuracy):** 7. D-166 domain link wrong (Tyre) 8. Stale D-record counts in joint.md + planning.md (Tyre) 9. Burnelli-Sheldon missing from agent roster + no briefing file (Tyre) 10. questions-architecture.md footer stale (Tyre) 11. `medical_services` demand_model should be `market` (Miri) 12. `timber` display name drop "/Biomass" (Miri) **Polish/ticket (non-blocking):** 13. D-171 Groombridge ambiguity — clarify (Miri) 14. `hospitality` description needs Reach texture (Miri) 15. D-173 superseded counts need annotation (Miri) 16. `commission_certification` shadow_viable rationale (Miri) 17. Ticket #801 stale description (Hoshe)
jpmschweitzer added 1 commit 2026-04-05 22:18:59 +02:00
fix(economics): address 17 PR review comments on #114 f1b97d4a88 
Blocking fixes:
- V-13: legal_services demand_model compliance→market (build-breaker)
- D-184: political flag names match TOML (commission_certified etc.)
- D-184: professional services list matches TOML
- D-173: elasticity count 5→4, cross-ref to D-184
- Workshop outcomes: fix self-contradicting fusion fuel statement
- R-011: move to end of file (was between D-183 and D-184)

Should-fix:
- D-166 domain link scope.md→architecture.md
- Sprint briefing counts updated (13→17 D-records, #801 marked done)
- Burnelli-Sheldon added to agent roster + briefing created
- questions-architecture.md footer tally updated
- medical_services demand_model utility→market
- timber display name drop "/Biomass"

Polish:
- D-171 Groombridge clarified (clearing house, not co-issuer)
- hospitality description has Reach texture
- commission_certification shadow_viable=false rationale in description
- Ticket #801 description updated
- Wiki pages regenerated

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
jpmschweitzer commented 2026-04-05 22:21:03 +02:00
Author
Owner
Copy Link
Copy Source

Re-review: sprint-32/planning → main (round 2)

Commit: f1b97d4a — fix(economics): address 17 PR review comments on #114

All 17 issues from the first review have been addressed:

Blocking (6/6 fixed)

  1. V-13 legal_services demand_model compliance→market
  2. D-184 political flag names match TOML
  3. D-184 professional services list matches TOML
  4. D-173 elasticity count 5→4 + cross-ref to D-184
  5. Workshop outcomes fusion fuel rewritten (no contradiction)
  6. R-011 moved to Rejected Alternatives section (no duplicate)

Should-fix (6/6 fixed)

  1. D-166 domain link scope.md→architecture.md
  2. Sprint briefing counts updated to 17 D-records
  3. Burnelli-Sheldon in agent roster + briefing file created
  4. questions-architecture.md footer updated
  5. medical_services demand_model utility→market
  6. timber display name "Timber" (dropped "/Biomass")

Polish (5/5 fixed)

  1. D-171 Groombridge clarified as clearing house
  2. hospitality description has Reach texture
  3. D-173 superseded counts annotated with D-184 cross-ref
  4. commission_certification shadow_viable rationale in description
  5. Ticket #801 description updated in planning.md

Both source TOML and workshop archive TOML updated in sync. Wiki pages regenerated.

Verdict: APPROVED

No new issues. Ready to merge.

## Re-review: sprint-32/planning → main (round 2) **Commit:** `f1b97d4a` — fix(economics): address 17 PR review comments on #114 All 17 issues from the first review have been addressed: ### Blocking (6/6 fixed) 1. V-13 `legal_services` demand_model compliance→market 2. D-184 political flag names match TOML 3. D-184 professional services list matches TOML 4. D-173 elasticity count 5→4 + cross-ref to D-184 5. Workshop outcomes fusion fuel rewritten (no contradiction) 6. R-011 moved to Rejected Alternatives section (no duplicate) ### Should-fix (6/6 fixed) 7. D-166 domain link scope.md→architecture.md 8. Sprint briefing counts updated to 17 D-records 9. Burnelli-Sheldon in agent roster + briefing file created 10. questions-architecture.md footer updated 11. `medical_services` demand_model utility→market 12. `timber` display name "Timber" (dropped "/Biomass") ### Polish (5/5 fixed) 13. D-171 Groombridge clarified as clearing house 14. `hospitality` description has Reach texture 15. D-173 superseded counts annotated with D-184 cross-ref 16. `commission_certification` shadow_viable rationale in description 17. Ticket #801 description updated in planning.md Both source TOML and workshop archive TOML updated in sync. Wiki pages regenerated. ### Verdict: APPROVED No new issues. Ready to merge.
jpmschweitzer closed this pull request 2026-04-05 22:21:16 +02:00

Pull request closed

This pull request cannot be reopened because the branch was deleted.
Sign in to join this conversation.
Reviewers
No Reviewers
Labels
No items
No labels
Milestone
No items
No Milestone
Projects
Clear projects
No projects
Assignees
Clear assignees
jpmschweitzer (Jeroen Schweitzer)
No Assignees
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: jpmschweitzer/settled-reach#114