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:

<!-- 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:

<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:

"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":

<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:

<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