tractatus/SITE_IMPROVEMENT_PRIORITIES.md

# Website Improvement Priorities
## Audit Results & Implementation Plan

**Date:** 2025-10-20
**Session:** Continued from pressure monitor/timeline work

---

## AUDIT FINDINGS

### 1. **About Page - 5 vs 6 Components Issue** ✅ CONFIRMED

**Location:** `/public/about.html:124`

**Current text:**
> "The Tractatus Framework consists of five integrated components that work together to enforce structural safety:"

**Components currently listed** (lines 128-162):
1. InstructionPersistenceClassifier
2. CrossReferenceValidator
3. BoundaryEnforcer
4. ContextPressureMonitor
5. MetacognitiveVerifier

**Missing component:**
6. **PluralisticDeliberationOrchestrator**

**Also needs fixing:**
- `/public/locales/en/about.json` - locale file likely has same issue

**Status across other pages:**
- ✅ architecture.html - correctly shows 6 components including PluralisticDeliberation
- ✅ researcher.html - correctly references all 6
- ✅ leader.html - correctly references all 6
- ✅ implementer.html - correctly references all 6
- ✅ index.html - correctly references all 6

**Impact:** Medium - Creates confusion about framework scope
**Effort:** Low - Simple text update + add 6th component card

---

### 2. **Explore Architecture Interactively - Functionality Check**

**Location:** `/public/architecture.html:319`

**Current implementation:**
- Section header: "Explore the Architecture Interactively"
- Loads: `/images/architecture-diagram-interactive.svg` ✅ EXISTS
- Script: `/js/components/interactive-diagram.js?v=20251019170000` ✅ EXISTS

**Files confirmed:**
```
-rw-rw-r-- 1 theflow theflow 7956 Oct 19 16:02 architecture-diagram-interactive.svg
-rw-rw-r-- 1 theflow theflow 12789 Oct 19 18:34 interactive-diagram.js
```

**User report:** "not working"

**Investigation needed:**
- Test actual page functionality in browser
- Check console for JavaScript errors
- Verify SVG loads and script initializes
- Check if event listeners attach correctly

**Status:** Needs functional testing
**Impact:** Medium-High - Key interactive feature not functioning
**Effort:** Medium - Requires debugging JS/SVG interaction

---

### 3. **About Page Content/Tone Enhancement**

**User request:**
> "The About page would do well with an infusion of both content and tone taken from /docs/outreach/Economist-Article-Amoral-Intelligence.md"

**Economist article key themes to incorporate:**
1. **Opening hook:** AI systems are amoral hierarchical constructs
2. **Core problem:** Hierarchies cannot navigate plural values
3. **Democratic legitimacy:** Whose values guide AI decisions?
4. **Cultural examples:** Western autonomy vs. family decision-making cultures
5. **Constitutional governance:** Separation of powers, subsidiarity
6. **Stakes:** Reversing centuries of progress in navigating moral pluralism
7. **Tone:** Analytical, philosophical depth, evidence-based but not boosterish

**Current About page tone:**
- Functional/technical focus
- Wittgenstein quote (good philosophical grounding)
- Origin story (27027 incident)
- Missing: values pluralism centrality, democratic legitimacy framing

**Recommended sections to enhance:**
1. **Mission section** - add plural values incompatibility framing
2. **New section**: "Why This Matters" - democratic legitimacy argument
3. **How It Works** - frame as separating boundaries from values deliberation
4. **Core Values** - add explicit "Pluralism" value

**Status:** Needs content drafting
**Impact:** High - Elevates philosophical sophistication and values argument
**Effort:** Medium - Requires careful integration with existing content

---

### 4. **Blog Article: Economist Piece Adaptation**

**User clarification:**
> "you do not have to create a blog page. you need to create another blog article and publish on the existing blog page"

**Existing blog page:** `/public/blog.html` ✅ EXISTS

**Task:**
- Adapt Economist article for blog publication
- Check: Can we republish before Economist submission? (publishing rights question)
- Format as blog post with proper metadata
- Add to blog.html article list

**Economist publishing rights consideration:**
- **If submitting to Economist:** They typically want first publication rights
- **Options:**
  1. Wait until Economist responds (accepts/rejects)
  2. Publish on blog BEFORE submitting (gives up first publication rights)
  3. Publish substantially different version (safe)

**Recommendation:** Research Economist first publication rights policy, or publish "related but different" version

**Status:** Blocked on publishing rights clarification
**Impact:** Medium - Good content for blog, but shouldn't jeopardize Economist submission
**Effort:** Low - Article mostly written, needs blog formatting

---

## PRIORITY RANKING

### Priority 1: About Page - 6 Components Fix
**Why first:**
- Factually incorrect (says 5, should say 6)
- Quick fix (1 hour total)
- User specifically mentioned this
- Affects understanding of framework scope

**Tasks:**
1. Update line 124: "five" → "six"
2. Add 6th component card for PluralisticDeliberationOrchestrator
3. Update `/public/locales/en/about.json` to match
4. Test page renders correctly
5. Deploy

**Estimated time:** 1 hour

---

### Priority 2: Test/Fix Interactive Architecture
**Why second:**
- User reported as "not working"
- Key feature for understanding framework
- Files exist but functionality unclear
- Requires functional testing

**Tasks:**
1. Test page in local browser (http://localhost:9000/architecture.html)
2. Check browser console for errors
3. Verify SVG loads correctly
4. Check if click events on nodes work
5. Debug interactive-diagram.js if broken
6. Fix identified issues
7. Test thoroughly
8. Deploy

**Estimated time:** 2-3 hours (depending on complexity of issue)

---

### Priority 3: About Page Content Enhancement
**Why third:**
- Significant content work
- Improves philosophical depth
- Elevates values argument
- Requires careful integration

**Tasks:**
1. Review Economist article for key themes to extract
2. Draft enhanced Mission section
3. Add new "Why This Matters" section (democratic legitimacy)
4. Add "Pluralism" to Core Values
5. Enhance "How It Works" framing
6. Update locales file
7. Review for tone consistency
8. Deploy

**Estimated time:** 3-4 hours

---

### Priority 4: Blog Article (After Rights Clarification)
**Why fourth:**
- Blocked on publishing rights question
- Lower urgency than factual errors
- Can be done anytime

**Tasks:**
1. Research Economist first publication rights policy
2. If clear: adapt article for blog
3. Add blog post metadata
4. Integrate into blog.html article list
5. Deploy

**Estimated time:** 1-2 hours (after rights clarification)

---

## IMPLEMENTATION PLAN

### Phase 1: Quick Wins (Day 1)
**Goal:** Fix factual errors and test interactive feature

1. **Fix About page 6 components** (1 hour)
   - Edit about.html
   - Edit about.json
   - Test locally
   - Deploy

2. **Test Interactive Architecture** (2-3 hours)
   - Local testing
   - Identify issues
   - Debug and fix
   - Deploy if fixed

**Total: 3-4 hours**

---

### Phase 2: Content Enhancement (Day 2)
**Goal:** Elevate About page philosophical depth

1. **About page content infusion** (3-4 hours)
   - Draft enhanced sections
   - Integrate Economist article themes
   - Update locales
   - Review and deploy

**Total: 3-4 hours**

---

### Phase 3: Blog Content (When Ready)
**Goal:** Publish Economist-based blog article

1. **Research publishing rights** (30 min)
2. **Adapt article for blog** (1-2 hours)
3. **Deploy blog post**

**Total: 1.5-2.5 hours**

---

## DETAILED TASK BREAKDOWN

### Task 1: Fix About Page - 6 Components

**File:** `/public/about.html`

**Change 1 - Line 124:**
```html
<!-- BEFORE -->
<p class="mb-6" data-i18n="how_it_works.intro">
  The Tractatus Framework consists of five integrated components that work together to enforce structural safety:
</p>

<!-- AFTER -->
<p class="mb-6" data-i18n="how_it_works.intro">
  The Tractatus Framework consists of six integrated components that work together to enforce structural safety:
</p>
```

**Change 2 - Add 6th component card after line 162:**
```html
<div class="bg-gray-50 rounded-lg p-6">
  <h3 class="text-lg font-bold text-gray-900 mb-2" data-i18n="how_it_works.deliberation_title">PluralisticDeliberationOrchestrator</h3>
  <p class="text-sm text-gray-600" data-i18n="how_it_works.deliberation_desc">
    When AI encounters values decisions—choices with no single "correct" answer—coordinates deliberation among affected stakeholders rather than making autonomous choices. Preserves human agency over moral decisions.
  </p>
</div>
```

**File:** `/public/locales/en/about.json`

**Add to JSON:**
```json
"how_it_works": {
  "intro": "The Tractatus Framework consists of six integrated components...",
  "deliberation_title": "PluralisticDeliberationOrchestrator",
  "deliberation_desc": "When AI encounters values decisions—choices with no single \"correct\" answer—coordinates deliberation among affected stakeholders rather than making autonomous choices. Preserves human agency over moral decisions."
}
```

---

### Task 2: Test/Fix Interactive Architecture

**Testing checklist:**
1. Navigate to http://localhost:9000/architecture.html
2. Scroll to "Explore the Architecture Interactively" section
3. Check browser console (F12) for errors
4. Verify SVG appears
5. Try clicking on SVG nodes (colored circles, "T" center)
6. Check if tooltips/modals appear
7. Check if highlighting works

**Common issues to check:**
- SVG not loading (404 error)
- JavaScript not loading (404 error)
- Event listeners not attaching (timing issue)
- CSP blocking inline scripts
- Incorrect selector targeting

**If broken:** Read interactive-diagram.js to understand intended behavior, debug accordingly

---

### Task 3: About Page Content Enhancement

**Extract from Economist article:**

**Key passages to adapt:**

1. **Amoral hierarchical framing:**
> "AI systems are amoral hierarchical constructs, fundamentally incompatible with the plural, incommensurable values human societies exhibit. You cannot pattern-match your way to pluralism. A hierarchy can only impose one framework and treat the inevitable conflicts as anomalies."

2. **Democratic legitimacy:**
> "When AI systems make consequential decisions—which medical treatments to recommend, which job candidates advance, which speech to moderate, how to allocate scarce resources—whose values guide those decisions?"

3. **Cultural pluralism examples:**
> "Medical AI trained on Western autonomy norms may offend patients from cultures prioritizing family decision-making. Content moderation AI trained on American free-speech principles mishandles contexts where different balances between expression and harm apply."

4. **Constitutional governance:**
> "Human societies solved a similar problem centuries ago: constitutional separation of powers. Legislatures define boundaries, executives enforce them, judiciaries interpret disputes. No single entity holds hierarchical authority over value decisions affecting diverse communities."

5. **Stakes:**
> "Human societies have spent centuries learning to navigate moral pluralism: constitutional separation of powers, federalism, subsidiarity, deliberative democracy... AI development is reversing this progress."

**Proposed About page structure:**

1. **Hero subtitle** - Add "Preserving plural values in the age of autonomous AI"

2. **Mission section** - Add opening paragraph:
> "As AI systems make increasingly consequential decisions—medical treatment, hiring, content moderation, resource allocation—a fundamental question emerges: whose values guide these decisions? Current AI alignment approaches embed particular moral frameworks into systems deployed universally. When they work, it's because everyone affected shares those values. When they don't, someone's values inevitably override others'."

3. **New section: "Why This Matters"** - Insert before "How It Works":
```html
<section class="mb-16">
  <h2 class="text-3xl font-bold text-gray-900 mb-6">Why This Matters</h2>
  <div class="prose prose-lg text-gray-600">
    <p class="mb-6">
      AI systems are amoral hierarchical constructs, fundamentally incompatible
      with the plural, incommensurable values human societies exhibit. A hierarchy
      can only impose one framework and treat conflicts as anomalies. You cannot
      pattern-match your way to pluralism.
    </p>
    <p class="mb-6">
      Human societies spent centuries learning to navigate moral pluralism through
      constitutional separation of powers, federalism, subsidiarity, and deliberative
      democracy. These structures acknowledge that legitimate authority over value
      decisions belongs to affected communities, not distant experts claiming universal wisdom.
    </p>
    <p class="mb-6">
      AI development risks reversing this progress. As capability concentrates in a
      few labs, value decisions affecting billions are being encoded by small teams
      applying their particular moral intuitions at scale. Not through malice—through
      structural necessity. The architecture of current AI systems demands hierarchical
      value frameworks.
    </p>
    <p>
      The Tractatus Framework offers an alternative: separate what must be universal
      (safety boundaries) from what should be contextual (value deliberation). This
      preserves human agency over moral decisions while enabling AI capability to scale.
    </p>
  </div>
</section>
```

4. **Core Values** - Add 5th value card:
```html
<div class="bg-white rounded-lg shadow-sm p-6 border-l-4 border-teal-600">
  <h3 class="text-xl font-bold text-gray-900 mb-3">Pluralism</h3>
  <p class="text-gray-600">
    Different communities hold different, equally legitimate values. AI systems
    must respect this pluralism structurally, not by pretending one framework
    can serve all contexts. Value decisions require deliberation among affected
    stakeholders, not autonomous AI choices.
  </p>
</div>
```

---

### Task 4: Blog Article Publishing Rights

**Research questions:**
1. Does The Economist require first publication rights?
2. Can we publish on our own blog before/after submission?
3. Does "substantially different version" count as new publication?

**Options:**
- **Option A:** Publish completely different angle (e.g., technical implementation focus vs. Economist's values focus)
- **Option B:** Wait for Economist response, then publish
- **Option C:** Publish excerpt/summary with "Full version submitted to The Economist" note

**Recommended:** Publish related but different piece - e.g., technical implementation case study rather than values argument

---

## SUCCESS CRITERIA

### About Page (6 components)
- [ ] Text says "six integrated components"
- [ ] All 6 components listed with descriptions
- [ ] PluralisticDeliberationOrchestrator card present
- [ ] Locale file updated
- [ ] Page renders correctly on production

### Interactive Architecture
- [ ] SVG loads without errors
- [ ] Clicking nodes triggers tooltips/modals
- [ ] No console errors
- [ ] Feature works as intended
- [ ] User confirms it's working

### About Page Enhancement
- [ ] Plural values argument central
- [ ] Democratic legitimacy framing present
- [ ] Cultural examples included
- [ ] Tone matches Economist sophistication
- [ ] Seamless integration with existing content

### Blog Article
- [ ] Publishing rights clarified
- [ ] Article adapted for blog format
- [ ] Metadata added
- [ ] Published on blog.html
- [ ] No conflict with Economist submission

---

## RISKS & MITIGATION

### Risk 1: Interactive Architecture requires significant rework
**Mitigation:** Time-box debugging to 2 hours. If not fixable, document issue and create separate ticket

### Risk 2: About page enhancement disrupts existing i18n
**Mitigation:** Test all locale files, update translations as needed

### Risk 3: Economist submission compromised by blog publication
**Mitigation:** Research first, don't publish until rights confirmed OR publish substantially different version

---

## NEXT ACTIONS

**Immediate (this session if time permits):**
1. Fix About page 6 components issue
2. Test Interactive Architecture feature

**Next session:**
1. Debug Interactive Architecture if needed
2. Draft About page enhancement
3. Research blog publishing rights

---

**END OF PRIORITY PLAN**