tractatus/docs/outreach/FEATURE-SECTION-DRAFT.md

# Feature Section Draft - Cultural DNA Revision

**Date**: October 28, 2025
**Task**: Phase 2.3 - Revise Feature Section
**Target**: public/index.html lines 250-331 (Framework Capabilities)
**Goal**: Connect services to plural moral values framework (7/10 → 9/10 compliance)

---

## Current Version

### Section Heading (Line 253)
```html
<h2 class="text-3xl font-bold text-center text-gray-900 mb-12 animate-on-scroll"
    data-i18n="capabilities.heading" data-animation="fade-in">
  Framework Capabilities
</h2>
```

### Service Descriptions (Lines 257-327)

**1. Instruction Classification** (Lines 263-266)
```html
<h3>Instruction Classification</h3>
<p>Quadrant-based classification (STR/OPS/TAC/SYS/STO) with time-persistence metadata tagging</p>
```

**2. Cross-Reference Validation** (Lines 275-278)
```html
<h3>Cross-Reference Validation</h3>
<p>Validates AI actions against explicit user instructions to prevent pattern-based overrides</p>
```

**3. Boundary Enforcement** (Lines 287-290)
```html
<h3>Boundary Enforcement</h3>
<p>Implements Tractatus 12.1-12.7 boundaries - values decisions architecturally require humans</p>
```

**4. Pressure Monitoring** (Lines 299-302)
```html
<h3>Pressure Monitoring</h3>
<p>Detects degraded operating conditions (token pressure, errors, complexity) and adjusts verification</p>
```

**5. Metacognitive Verification** (Lines 311-314)
```html
<h3>Metacognitive Verification</h3>
<p>AI self-checks alignment, coherence, safety before execution - structural pause-and-verify</p>
```

**6. Pluralistic Deliberation** (Lines 323-326)
```html
<h3>Pluralistic Deliberation</h3>
<p>Multi-stakeholder values deliberation without hierarchy - facilitates human decision-making
for incommensurable values</p>
```

### Issues Identified:
- ⚠️ **No intro connecting services to plural moral values** (missed opportunity)
- ⚠️ **Pluralistic Deliberation**: Uses "incommensurable values" but not "plural moral values"
- ⚠️ **Boundary Enforcement**: Good, but could explicitly mention plural moral values
- ✅ **Technical descriptions are accurate** and grounded (inst_085 compliant)
- ✅ **Strong architectural emphasis** throughout (inst_089 compliant)

---

## Proposed Revisions

### Option 1: MINIMAL CHANGES (Recommended)

**Changes**:
1. Add intro paragraph before service grid
2. Update Pluralistic Deliberation description
3. Minor enhancement to Boundary Enforcement

#### 1. New Section Intro (After Line 253)
```html
<h2 class="text-3xl font-bold text-center text-gray-900 mb-4 animate-on-scroll"
    data-i18n="capabilities.heading" data-animation="fade-in">
  Framework Capabilities
</h2>

<p class="text-center text-gray-600 text-lg max-w-3xl mx-auto mb-12 animate-on-scroll"
   data-i18n="capabilities.intro" data-animation="fade-in">
  Six architectural services that enable plural moral values by preserving human judgment
  at the coalface where AI operates.
</p>
```

**Compliance**:
- ✅ inst_085: Grounded ("at the coalface where AI operates")
- ✅ Amoral vs Plural Moral Values: Explicit mention of "plural moral values"
- ✅ inst_089: "Architectural services" emphasis

#### 2. Updated Pluralistic Deliberation (Replace Lines 323-326)
```html
<h3 class="text-lg font-semibold text-gray-900 mb-2" data-i18n="capabilities.items.5.title">
  Pluralistic Deliberation
</h3>
<p class="text-gray-600 text-sm" data-i18n="capabilities.items.5.description">
  Handles plural moral values without imposing hierarchy—facilitates human judgment when
  efficiency conflicts with safety or other incommensurable values
</p>
```

**Changes**:
- ✅ "Handles plural moral values" (strategic terminology front and center)
- ✅ "human judgment" vs "human decision-making" (more operational)
- ✅ Added concrete example: "when efficiency conflicts with safety"

#### 3. Enhanced Boundary Enforcement (Replace Lines 287-290)
```html
<h3 class="text-lg font-semibold text-gray-900 mb-2" data-i18n="capabilities.items.2.title">
  Boundary Enforcement
</h3>
<p class="text-gray-600 text-sm" data-i18n="capabilities.items.2.description">
  Implements Tractatus 12.1-12.7 boundaries—values decisions architecturally require humans,
  enabling plural moral values rather than imposed frameworks
</p>
```

**Changes**:
- ✅ Added: "enabling plural moral values rather than imposed frameworks"
- ✅ Maintains technical specificity (12.1-12.7)
- ✅ Clarifies WHY boundaries exist (to enable plural moral values)

---

## Option 2: MORE COMPREHENSIVE UPDATES

**Additional changes to other services**:

#### Cross-Reference Validation (Lines 275-278)
```html
<p class="text-gray-600 text-sm" data-i18n="capabilities.items.1.description">
  Validates AI actions against explicit user instructions to prevent pattern-based overrides—
  preserving organizational moral authority
</p>
```
**Added**: "preserving organizational moral authority" (connects to plural moral values theme)

#### Metacognitive Verification (Lines 311-314)
```html
<p class="text-gray-600 text-sm" data-i18n="capabilities.items.4.description">
  Structural pause-and-verify before execution—AI checks alignment, coherence, and safety
  to avoid amoral operational drift
</p>
```
**Added**: "avoid amoral operational drift" (connects to amoral AI problem)

---

## Recommendation: OPTION 1 (Minimal Changes)

**Rationale**:
1. **Surgical precision**: Addresses the CRITICAL gap (plural moral values framing) without over-editing
2. **Maintains technical accuracy**: Existing descriptions are strong and grounded
3. **Low risk**: Minimal changes = fewer translation updates, less regression risk
4. **High impact**: Intro paragraph + Pluralistic Deliberation update provides strong plural moral values positioning

**Compliance Improvement**:
- Current: 7/10
- After Option 1: 9/10
- After Option 2: 9.2/10 (marginal gain for more work)

---

## Cultural DNA Compliance Analysis (Option 1)

### inst_085: Grounded Language (9/10)
**✅ Excellent**:
- "at the coalface where AI operates" (intro)
- "when efficiency conflicts with safety" (Pluralistic Deliberation)
- All technical terms remain grounded (quadrant-based, token pressure, etc.)

### inst_086: Honest Uncertainty (8/10)
**✅ Good**:
- "enable" vs "ensure" (honest about what architecture does)
- "facilitates" vs absolute claims (humble language)

**Minor opportunity**: Could add "may enable" for more uncertainty, but not critical for feature descriptions

### inst_087: One Approach Framing (7/10)
**⚠️ Neutral**: Services section doesn't need to repeat "one approach" framing (that's in hero)

### inst_088: Awakening Over Recruiting (8/10)
**✅ Good**:
- Descriptive of capabilities, not recruitment
- Focus on understanding mechanisms

### inst_089: Architectural Constraint Emphasis (10/10)
**✅ Excellent**:
- "Six architectural services" (intro)
- "Implements...boundaries" (Boundary Enforcement)
- "Structural pause-and-verify" (Metacognitive Verification)
- Strong architectural framing throughout

### Amoral vs Plural Moral Values (9/10)
**✅ Excellent**:
- "enable plural moral values" (intro)
- "Handles plural moral values" (Pluralistic Deliberation)
- "enabling plural moral values rather than imposed frameworks" (Boundary Enforcement)

**Overall Score**: 8.5/10 → 9.0/10 (current 7/10)

---

## Implementation Details

### HTML Structure Changes

**Add new paragraph element** (after line 253, before line 254):
```html
<h2 class="text-3xl font-bold text-center text-gray-900 mb-4 animate-on-scroll"
    data-i18n="capabilities.heading" data-animation="fade-in">
  Framework Capabilities
</h2>

<!-- NEW ELEMENT -->
<p class="text-center text-gray-600 text-lg max-w-3xl mx-auto mb-12 animate-on-scroll"
   data-i18n="capabilities.intro" data-animation="fade-in">
  Six architectural services that enable plural moral values by preserving human judgment
  at the coalface where AI operates.
</p>

<div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-3 gap-8">
  <!-- Service cards -->
</div>
```

**Note**: Changed h2 `mb-12` to `mb-4` to accommodate new intro paragraph spacing

### Translation Updates Required

**File**: `public/js/translations/en.js`

Add new key:
```javascript
capabilities: {
  heading: "Framework Capabilities",
  intro: "Six architectural services that enable plural moral values by preserving human judgment at the coalface where AI operates.",
  items: [
    // ... existing items
    {
      title: "Pluralistic Deliberation",
      description: "Handles plural moral values without imposing hierarchy—facilitates human judgment when efficiency conflicts with safety or other incommensurable values"
    }
  ]
}
```

**Also update** (if they exist):
- `public/js/translations/de.js`
- `public/js/translations/fr.js`

---

## Visual Impact Comparison

### Current (Generic Technical):
> **Framework Capabilities**
>
> [6 service cards with technical descriptions]

**Impression**: Technical documentation, capabilities list

### Proposed Option 1 (Strategic Connection):
> **Framework Capabilities**
>
> Six architectural services that enable plural moral values by preserving human judgment
> at the coalface where AI operates.
>
> [6 service cards including "Handles plural moral values..." for Pluralistic Deliberation]

**Impression**: Technical capabilities WITH clear strategic purpose, connected to plural moral values framework

---

## Character Count & Readability

**Intro paragraph**: ~130 characters (fits well for hero context)
**Pluralistic Deliberation**: ~175 characters (up from ~140, still reasonable)
**Boundary Enforcement**: ~155 characters (up from ~105, manageable)

All descriptions remain concise and scannable in card format.

---

## Testing Checklist

After implementation:
- [ ] Visual layout preserved (responsive grid, card styling)
- [ ] Animation timing correct (stagger still works)
- [ ] Translation keys work (no console errors)
- [ ] Intro paragraph centers correctly (max-w-3xl mx-auto)
- [ ] Services remain readable in mobile view
- [ ] No cultural DNA violations when validated

---

## Next Steps After This Task

1. ✅ **Task 2.3 Complete** (this document)
2. 🔄 **Task 2.4**: Update problem statement (value proposition section)
   - This is the BIGGEST revision (15 lines, complete rewrite)
   - Lines 91-93 currently use abstract language
   - Need full "amoral AI vs plural moral values" contrast
3. 🔄 **Task 2.5**: Implement all changes to public/index.html
   - Hero section (Task 2.2)
   - Feature section (Task 2.3)
   - Problem statement (Task 2.4)
   - Test locally, validate, deploy

---

**Status**: ✅ DRAFT COMPLETE
**Recommendation**: Implement Option 1 (Minimal Changes)
**Estimated implementation time**: 20 minutes (HTML + translations)
**Impact**: 7/10 → 9/10 cultural DNA compliance

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>