john/tractatus
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions

feat(values): add Architectural Principles section with 5 Alexander principles

Browse source 
Added new section between Core Values and Te Tiriti sections explaining
how the 5 Alexander principles operationalize our core values:

1. Deep Interlock - Service coordination creates transparency
2. Structure-Preserving - Governance continuity enables accountability
3. Gradients Not Binary - Nuanced responses prevent harm
4. Living Process - Community learning drives evolution
5. Not-Separateness - Architectural enforcement preserves sovereignty

Each principle includes:
- Description of what it means technically
- Connection to existing core values
- Concrete examples from framework operation

Updated table of contents with new section link.

Note: i18n attributes added but translations pending (values.json updates needed).

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

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
TheFlow 2025-10-31 00:06:20 +13:00
parent 59a63404a1
commit 662e034e57
1 changed files with 78 additions and 0 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

78
public/about/values.html
View file

@ -59,6 +59,7 @@
<a href="#transparency" class="block text-blue-600 hover:text-blue-700 pl-4" data-i18n="toc.transparency">• Transparency</a>
<a href="#harmlessness" class="block text-blue-600 hover:text-blue-700 pl-4" data-i18n="toc.harmlessness">• Harmlessness</a>
<a href="#community" class="block text-blue-600 hover:text-blue-700 pl-4" data-i18n="toc.community">• Community</a>
<a href="#architectural-principles" class="block text-blue-600 hover:text-blue-700" data-i18n="toc.architectural_principles">Architectural Principles</a>
<a href="#te-tiriti" class="block text-blue-600 hover:text-blue-700">Te Tiriti o Waitangi & Digital Sovereignty</a>
<a href="#indigenous-data-sovereignty" class="block text-blue-600 hover:text-blue-700">Indigenous Data Sovereignty</a>
<a href="#governance" class="block text-blue-600 hover:text-blue-700">Governance & Accountability</a>
@ -175,6 +176,83 @@
</div>
</section>
<!-- Architectural Principles -->
<section id="architectural-principles" class="mb-16">
<h2 class="text-3xl font-bold text-gray-900 mb-6" data-i18n="architectural_principles.heading">Architectural Principles</h2>
<div class="bg-gray-50 border-l-4 border-gray-600 p-6 rounded-r-lg mb-8">
<p class="text-gray-800 mb-4" data-i18n-html="architectural_principles.intro">
Our values—sovereignty, transparency, harmlessness, community—guide <em>what</em> we build. But values alone don't prevent systems from drifting. We need architectural principles that show <em>how</em> to preserve values through structure, not aspiration.
</p>
<p class="text-gray-800" data-i18n-html="architectural_principles.alexander_credit">
Drawing on Christopher Alexander's work in architectural pattern languages, we've identified five principles that translate living systems thinking into governance architecture. These aren't metaphors—they're operational requirements that shape every framework decision.
</p>
</div>
<div class="space-y-8">
<!-- Deep Interlock -->
<div class="border-l-4 border-purple-600 pl-6">
<h3 class="text-2xl font-bold text-gray-900 mb-4" data-i18n="architectural_principles.deep_interlock.title">Deep Interlock</h3>
<p class="text-gray-700 mb-4" data-i18n-html="architectural_principles.deep_interlock.description">
Six governance services <strong>coordinate through mutual validation</strong>, not operate in silos. When BoundaryEnforcer detects a values conflict, CrossReferenceValidator checks if it aligns with stored instructions, ContextPressureMonitor assesses session conditions, and PluralisticDeliberationOrchestrator coordinates stakeholder deliberation if needed.
</p>
<p class="text-gray-700" data-i18n-html="architectural_principles.deep_interlock.connection">
<strong>Connects to Transparency:</strong> Service coordination creates audit trails showing how governance decisions emerge from multiple reinforcing checks, not single-point failures.
</p>
</div>
<!-- Structure-Preserving -->
<div class="border-l-4 border-blue-600 pl-6">
<h3 class="text-2xl font-bold text-gray-900 mb-4" data-i18n="architectural_principles.structure_preserving.title">Structure-Preserving</h3>
<p class="text-gray-700 mb-4" data-i18n-html="architectural_principles.structure_preserving.description">
Framework changes <strong>enhance without breaking</strong>. When we add new governance rules or refine service logic, historical audit logs remain interpretable. A decision made under framework v4.2 can still be understood in v4.4—institutional memory preserved across evolution.
</p>
<p class="text-gray-700" data-i18n-html="architectural_principles.structure_preserving.connection">
<strong>Connects to Accountability:</strong> Structure-preserving transformations mean governance continuity. Organizations can demonstrate regulatory compliance across framework versions because the audit trail remains coherent.
</p>
</div>
<!-- Gradients Not Binary -->
<div class="border-l-4 border-indigo-600 pl-6">
<h3 class="text-2xl font-bold text-gray-900 mb-4" data-i18n="architectural_principles.gradients.title">Gradients Not Binary</h3>
<p class="text-gray-700 mb-4" data-i18n-html="architectural_principles.gradients.description">
Governance operates on <strong>intensity scales</strong> (NORMAL/ELEVATED/HIGH/CRITICAL), not yes/no switches. Context pressure monitoring adjusts behavior gradually as session conditions change—token usage climbs, message length increases, task complexity escalates. Nuanced response to risk, not mechanical on/off.
</p>
<p class="text-gray-700" data-i18n-html="architectural_principles.gradients.connection">
<strong>Connects to Harmlessness:</strong> Gradients prevent both under-response (missing risks) and over-response (alert fatigue). The system adapts governance intensity to match actual risk levels, like living systems responding to environmental stress.
</p>
</div>
<!-- Living Process -->
<div class="border-l-4 border-teal-600 pl-6">
<h3 class="text-2xl font-bold text-gray-900 mb-4" data-i18n="architectural_principles.living_process.title">Living Process</h3>
<p class="text-gray-700 mb-4" data-i18n-html="architectural_principles.living_process.description">
The framework <strong>evolves from operational failures</strong>, not predetermined roadmaps. When the "27027 incident" revealed pattern recognition bias (AI autocorrected user's explicit "port 27027" to "port 27017"), we didn't just document the failure—we built CrossReferenceValidator to prevent that class of error architecturally.
</p>
<p class="text-gray-700" data-i18n-html="architectural_principles.living_process.connection">
<strong>Connects to Community:</strong> Living process means continuous learning from real-world use. The framework grows smarter through operational experience shared across the community, not consultant wisdom imposed from above.
</p>
</div>
<!-- Not-Separateness -->
<div class="border-l-4 border-pink-600 pl-6">
<h3 class="text-2xl font-bold text-gray-900 mb-4" data-i18n="architectural_principles.not_separateness.title">Not-Separateness</h3>
<p class="text-gray-700 mb-4" data-i18n-html="architectural_principles.not_separateness.description">
Governance is <strong>woven into the deployment architecture</strong>, not bolted on as afterthought. PreToolUse hooks intercept actions before execution. Services run in the critical path. Bypasses require explicit <code>--no-verify</code> flags and are logged. Enforcement is structural, not voluntary.
</p>
<p class="text-gray-700" data-i18n-html="architectural_principles.not_separateness.connection">
<strong>Connects to Sovereignty:</strong> Not-separateness ensures AI cannot bypass governance to override human agency. The architecture makes it structurally difficult to erode boundaries, preserving decision-making authority where it belongs—with affected humans.
</p>
</div>
</div>
<div class="bg-amber-50 border-l-4 border-amber-500 p-6 rounded-r-lg mt-8">
<p class="text-amber-900" data-i18n-html="architectural_principles.monitoring_note">
<strong>Note:</strong> These principles were integrated into the framework in October 2025. We're monitoring their effectiveness through audit log analysis and operational metrics. This is active research—we're learning whether architectural principles from the built environment translate meaningfully to AI governance.
</p>
</div>
</section>
<!-- Te Tiriti o Waitangi -->
<section id="te-tiriti" class="mb-16">
<h2 class="text-3xl font-bold text-gray-900 mb-6" data-i18n="te_tiriti_section.title">Te Tiriti o Waitangi & Digital Sovereignty</h2>