diff --git a/public/docs/diagrams/architecture-main-flow.svg b/public/docs/diagrams/architecture-main-flow.svg new file mode 100644 index 00000000..8700b253 --- /dev/null +++ b/public/docs/diagrams/architecture-main-flow.svg @@ -0,0 +1,127 @@ + + + + + + + + + + + Pluralistic Deliberation: Main Architecture Flow + + + + User Request + "Add inline JavaScript for form" + + + + + + + PRE-ACTION CHECK + scripts/pre-action-check.js + Validates against instruction history + boundaries + + + + + + + Conflict + Detected? + + + + NO + + Proceed + with Action + + + + YES + + + + CONFLICT CLASSIFIER + Severity: CRITICAL / HIGH / MODERATE / LOW + Type: Ethical / Instruction / Principle / Technical + + + + + + + Severity ≥ MODERATE + + HIGH Persistence? + + + + CRITICAL + + Block + Immediately + + + + LOW + + Fast Path + (1-round) + + + + YES + + + + PLURALISTIC DELIBERATION ORCHESTRATOR + + + + Round 1: Position Statements (2-5 min) + Present all stakeholder positions + + + + Round 2: Shared Values Discovery (2-3 min) + Identify common ground + values in tension + + + + Round 3: Accommodation Exploration (3-5 min) + Propose 3-4 options honoring multiple values + + + + Round 4: Outcome Documentation (1-2 min) + User chooses accommodation, document decision + + + + + + + OUTCOME STORAGE + Save to: .claude/deliberation-outcomes/ + Update: .claude/instruction-history.json (if needed) + + + + + + + Proceed with Chosen Accommodation + + diff --git a/public/docs/diagrams/trigger-decision-tree.svg b/public/docs/diagrams/trigger-decision-tree.svg new file mode 100644 index 00000000..a4c20527 --- /dev/null +++ b/public/docs/diagrams/trigger-decision-tree.svg @@ -0,0 +1,113 @@ + + + + + + + + + + + Deliberation Trigger Decision Tree + + + + Conflict + Detected? + + + + NO + + ✓ Proceed + No deliberation needed + + + + YES + + + + Severity + Level? + + + + CRITICAL + + ✗ Block Immediately + No deliberation + (e.g., severe ethical violation) + + + + HIGH/MOD + + + + HIGH Persistence + Instruction? + + + + NO + + ⚡ Fast Path (1-round) + • LOW/MEDIUM persistence + • Reversible actions + Time: 30 sec - 2 min + + + + YES + + + + Ethical Boundary + Violation? + + + + YES or NO + (if HIGH persistence) + + + + ⚙ 4-Round Protocol + Triggers when: + • HIGH persistence conflict (confidence ≥80%) OR + • MODERATE/HIGH ethical boundary violation OR + • 3+ accumulated conflicts in session + Time: 8-15 minutes + + + + 📋 Manual Triggers + (User-initiated) + • "I want to deliberate on this" + • "Help me think through this" + • "What are the trade-offs?" + → Always triggers 4-round + + + + + + Legend + + Block (no deliberation) + + Deliberation (4-round or fast) + + Proceed (no conflict) + + diff --git a/public/implementer.html b/public/implementer.html index 74aed9a6..74ce8962 100644 --- a/public/implementer.html +++ b/public/implementer.html @@ -9,21 +9,43 @@ - - - + + + - +