feat(framework): integrate Alexander principles and Q&A tracking
- Add inst_090-094: Christopher Alexander architectural principles - Deep Interlock (service coordination) - Structure-Preserving (audit continuity) - Gradients Not Binary (intensity levels) - Living Process (evolves from failures) - Not-Separateness (architectural integration) - Add inst_095: Q&A tracking protocol (bidirectional) - Framework version: 4.2 → 4.4 - Active instructions: 62 → 68 - Integration scripts for safe deployment 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
TheFlow
parent
f63591d126
commit
5d1b64f4e5
3 changed files with 413 additions and 2 deletions
|
|
@ -1,6 +1,6 @@
|
|||
{
|
||||
"version": "4.2",
|
||||
"last_updated": "2025-10-27T19:17:18.631Z",
|
||||
"version": "4.4",
|
||||
"last_updated": "2025-10-30T07:44:38.573Z",
|
||||
"description": "Persistent instruction database for Tractatus framework governance",
|
||||
"instructions": [
|
||||
{
|
||||
|
|
@ -3069,6 +3069,146 @@
|
|||
"❌ BAD: 'Better system prompts can prevent data breaches'",
|
||||
"✅ GOOD: 'BoundaryEnforcer prevents data breaches architecturally - prompts are hope-based governance'"
|
||||
]
|
||||
},
|
||||
{
|
||||
"id": "inst_090",
|
||||
"text": "Six governance services must reinforce each other through mutual validation, creating deep interlock rather than isolated enforcement",
|
||||
"timestamp": "2025-10-30T06:12:36.879Z",
|
||||
"quadrant": "STRATEGIC",
|
||||
"persistence": "HIGH",
|
||||
"temporal_scope": "PERMANENT",
|
||||
"verification_required": "REQUIRED",
|
||||
"explicitness": 0.9,
|
||||
"source": "architectural_principle",
|
||||
"session_id": "2025-10-30-alexander-integration",
|
||||
"parameters": {
|
||||
"services": [
|
||||
"BoundaryEnforcer",
|
||||
"CrossReferenceValidator",
|
||||
"MetacognitiveVerifier",
|
||||
"ContextPressureMonitor",
|
||||
"InstructionPersistenceClassifier",
|
||||
"PluralisticDeliberationOrchestrator"
|
||||
],
|
||||
"principle": "deep_interlock"
|
||||
},
|
||||
"active": true,
|
||||
"notes": "Centers Reinforce Centers - Deep Interlock principle from Christopher Alexander"
|
||||
},
|
||||
{
|
||||
"id": "inst_091",
|
||||
"text": "Framework changes must preserve wholeness - existing audit logs remain interpretable, prior governance decisions remain valid, instruction precedents maintain authority",
|
||||
"timestamp": "2025-10-30T06:12:36.880Z",
|
||||
"quadrant": "STRATEGIC",
|
||||
"persistence": "HIGH",
|
||||
"temporal_scope": "PERMANENT",
|
||||
"verification_required": "MANDATORY",
|
||||
"explicitness": 0.95,
|
||||
"source": "architectural_principle",
|
||||
"session_id": "2025-10-30-alexander-integration",
|
||||
"parameters": {
|
||||
"principle": "structure_preserving_transformation",
|
||||
"preservation_targets": [
|
||||
"audit_logs",
|
||||
"governance_decisions",
|
||||
"instruction_precedents"
|
||||
]
|
||||
},
|
||||
"active": true,
|
||||
"notes": "Structure-Preserving Transformations Only - Enhance wholeness while maintaining coherence"
|
||||
},
|
||||
{
|
||||
"id": "inst_092",
|
||||
"text": "Governance operates on gradients (NORMAL/ELEVATED/HIGH/CRITICAL context pressure, LOW/MEDIUM/HIGH persistence) rather than binary yes/no switches",
|
||||
"timestamp": "2025-10-30T06:12:36.880Z",
|
||||
"quadrant": "STRATEGIC",
|
||||
"persistence": "HIGH",
|
||||
"temporal_scope": "PERMANENT",
|
||||
"verification_required": "REQUIRED",
|
||||
"explicitness": 0.88,
|
||||
"source": "architectural_principle",
|
||||
"session_id": "2025-10-30-alexander-integration",
|
||||
"parameters": {
|
||||
"principle": "gradients_not_binary",
|
||||
"examples": [
|
||||
"context_pressure_levels",
|
||||
"persistence_levels",
|
||||
"verification_requirements"
|
||||
]
|
||||
},
|
||||
"active": true,
|
||||
"notes": "Gradients Over Binary Switches - Natural systems use gradients, not binary switches"
|
||||
},
|
||||
{
|
||||
"id": "inst_093",
|
||||
"text": "Framework evolves through real-world use and feedback, not top-down specification - governance grows from failures and successes, not predetermined plans",
|
||||
"timestamp": "2025-10-30T06:12:36.880Z",
|
||||
"quadrant": "STRATEGIC",
|
||||
"persistence": "HIGH",
|
||||
"temporal_scope": "PERMANENT",
|
||||
"verification_required": "REQUIRED",
|
||||
"explicitness": 0.85,
|
||||
"source": "architectural_principle",
|
||||
"session_id": "2025-10-30-alexander-integration",
|
||||
"parameters": {
|
||||
"principle": "living_process",
|
||||
"evolution_triggers": [
|
||||
"real_failures",
|
||||
"audit_log_analysis",
|
||||
"governance_gaps",
|
||||
"user_feedback"
|
||||
]
|
||||
},
|
||||
"active": true,
|
||||
"notes": "Living Process Over Fixed Design - Systems grow organically through use"
|
||||
},
|
||||
{
|
||||
"id": "inst_094",
|
||||
"text": "Governance must be woven into AI deployment architecture, not bolted on as separate compliance layer - if AI can execute without governance validation, framework is separate (and will be bypassed)",
|
||||
"timestamp": "2025-10-30T06:12:36.880Z",
|
||||
"quadrant": "STRATEGIC",
|
||||
"persistence": "HIGH",
|
||||
"temporal_scope": "PERMANENT",
|
||||
"verification_required": "MANDATORY",
|
||||
"explicitness": 0.93,
|
||||
"source": "architectural_principle",
|
||||
"session_id": "2025-10-30-alexander-integration",
|
||||
"parameters": {
|
||||
"principle": "not_separateness",
|
||||
"integration_test": "can_ai_bypass_governance"
|
||||
},
|
||||
"active": true,
|
||||
"notes": "Not-Separateness (Framework Integration) - Deep integration, not bolt-on compliance"
|
||||
},
|
||||
{
|
||||
"id": "inst_095",
|
||||
"text": "Track all questions in both directions (User→Claude and Claude→User). At end of each interaction, verify all questions have been addressed. Issue explicit alert if question remains unanswered. Apply to terminal interactions and documentation.",
|
||||
"timestamp": "2025-10-30T07:44:38.563Z",
|
||||
"quadrant": "OPERATIONAL",
|
||||
"persistence": "HIGH",
|
||||
"temporal_scope": "PERMANENT",
|
||||
"verification_required": "REQUIRED",
|
||||
"explicitness": 0.92,
|
||||
"source": "user_instruction",
|
||||
"session_id": "2025-10-30-qa-tracking",
|
||||
"parameters": {
|
||||
"tracking_scope": [
|
||||
"terminal",
|
||||
"documentation",
|
||||
"plan_mode"
|
||||
],
|
||||
"alert_threshold": "immediate",
|
||||
"question_types": [
|
||||
"explicit_query",
|
||||
"clarification_request",
|
||||
"decision_point"
|
||||
],
|
||||
"exempt_patterns": [
|
||||
"rhetorical_question"
|
||||
]
|
||||
},
|
||||
"active": true,
|
||||
"notes": "Question Tracking and Clarification Protocol - Prevents missed questions in busy prompts and cross-session interactions"
|
||||
}
|
||||
],
|
||||
"stats": {
|
||||
|
|
|
|||
97
scripts/add-inst-095.js
Executable file
97
scripts/add-inst-095.js
Executable file
|
|
@ -0,0 +1,97 @@
|
|||
#!/usr/bin/env node
|
||||
|
||||
/**
|
||||
* Add inst_095: Question Tracking and Clarification Protocol
|
||||
*
|
||||
* Addresses communication gap: missed questions in both directions
|
||||
*/
|
||||
|
||||
const fs = require('fs');
|
||||
const path = require('path');
|
||||
|
||||
const INSTRUCTION_HISTORY_PATH = path.join(__dirname, '../.claude/instruction-history.json');
|
||||
|
||||
const inst095 = {
|
||||
id: "inst_095",
|
||||
text: "Track all questions in both directions (User→Claude and Claude→User). At end of each interaction, verify all questions have been addressed. Issue explicit alert if question remains unanswered. Apply to terminal interactions and documentation.",
|
||||
timestamp: new Date().toISOString(),
|
||||
quadrant: "OPERATIONAL",
|
||||
persistence: "HIGH",
|
||||
temporal_scope: "PERMANENT",
|
||||
verification_required: "REQUIRED",
|
||||
explicitness: 0.92,
|
||||
source: "user_instruction",
|
||||
session_id: "2025-10-30-qa-tracking",
|
||||
parameters: {
|
||||
tracking_scope: ["terminal", "documentation", "plan_mode"],
|
||||
alert_threshold: "immediate",
|
||||
question_types: ["explicit_query", "clarification_request", "decision_point"],
|
||||
exempt_patterns: ["rhetorical_question"]
|
||||
},
|
||||
active: true,
|
||||
notes: "Question Tracking and Clarification Protocol - Prevents missed questions in busy prompts and cross-session interactions"
|
||||
};
|
||||
|
||||
function main() {
|
||||
console.log('═══════════════════════════════════════════════════════════');
|
||||
console.log(' Adding inst_095: Question Tracking Protocol');
|
||||
console.log('═══════════════════════════════════════════════════════════\n');
|
||||
|
||||
// Read current instruction history
|
||||
let history;
|
||||
try {
|
||||
history = JSON.parse(fs.readFileSync(INSTRUCTION_HISTORY_PATH, 'utf8'));
|
||||
} catch (err) {
|
||||
console.error('❌ Error reading instruction-history.json:', err.message);
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
console.log(`📖 Current version: ${history.version}`);
|
||||
console.log(` Total instructions: ${history.instructions.length}`);
|
||||
console.log(` Active instructions: ${history.instructions.filter(i => i.active).length}\n`);
|
||||
|
||||
// Check if inst_095 already exists
|
||||
const existing = history.instructions.find(i => i.id === 'inst_095');
|
||||
|
||||
if (existing) {
|
||||
console.log('⚠️ inst_095 already exists:');
|
||||
console.log(` ${existing.text.substring(0, 60)}...`);
|
||||
console.log('\n❌ Aborting to prevent duplicate\n');
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
// Add inst_095
|
||||
console.log('✨ Adding inst_095:\n');
|
||||
history.instructions.push(inst095);
|
||||
console.log(` ✓ ${inst095.id}: ${inst095.text.substring(0, 80)}...`);
|
||||
|
||||
// Update version if appropriate (4.3 → 4.4 with Q&A tracking)
|
||||
const shouldUpdateVersion = history.version === "4.3";
|
||||
if (shouldUpdateVersion) {
|
||||
history.version = "4.4";
|
||||
console.log(`\n📦 Updated version: ${history.version}`);
|
||||
}
|
||||
|
||||
history.last_updated = new Date().toISOString();
|
||||
|
||||
console.log(` Total instructions: ${history.instructions.length}`);
|
||||
console.log(` Active instructions: ${history.instructions.filter(i => i.active).length}\n`);
|
||||
|
||||
// Write back to file
|
||||
try {
|
||||
fs.writeFileSync(INSTRUCTION_HISTORY_PATH, JSON.stringify(history, null, 2), 'utf8');
|
||||
} catch (err) {
|
||||
console.error('❌ Error writing instruction-history.json:', err.message);
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
console.log('✅ Integration complete!\n');
|
||||
console.log('═══════════════════════════════════════════════════════════');
|
||||
console.log(' Next Steps:');
|
||||
console.log('═══════════════════════════════════════════════════════════\n');
|
||||
console.log('1. Run: node scripts/sync-instructions-to-db.js');
|
||||
console.log('2. Test with next interaction (Q&A tracking active)');
|
||||
console.log('3. Monitor effectiveness over coming sessions\n');
|
||||
}
|
||||
|
||||
main();
|
||||
174
scripts/integrate-alexander-rules.js
Executable file
174
scripts/integrate-alexander-rules.js
Executable file
|
|
@ -0,0 +1,174 @@
|
|||
#!/usr/bin/env node
|
||||
|
||||
/**
|
||||
* Integrate Christopher Alexander Pattern Rules (inst_090-094)
|
||||
*
|
||||
* Adds the 5 Alexander pattern rules to instruction-history.json
|
||||
* and updates framework version from 4.2 to 4.3
|
||||
*
|
||||
* Source: docs/governance/ALEXANDER-PATTERN-RULES.md
|
||||
*/
|
||||
|
||||
const fs = require('fs');
|
||||
const path = require('path');
|
||||
|
||||
const INSTRUCTION_HISTORY_PATH = path.join(__dirname, '../.claude/instruction-history.json');
|
||||
|
||||
// The 5 Alexander Pattern Rules
|
||||
const alexanderRules = [
|
||||
{
|
||||
id: "inst_090",
|
||||
text: "Six governance services must reinforce each other through mutual validation, creating deep interlock rather than isolated enforcement",
|
||||
timestamp: new Date().toISOString(),
|
||||
quadrant: "STRATEGIC",
|
||||
persistence: "HIGH",
|
||||
temporal_scope: "PERMANENT",
|
||||
verification_required: "REQUIRED",
|
||||
explicitness: 0.90,
|
||||
source: "architectural_principle",
|
||||
session_id: "2025-10-30-alexander-integration",
|
||||
parameters: {
|
||||
services: ["BoundaryEnforcer", "CrossReferenceValidator", "MetacognitiveVerifier", "ContextPressureMonitor", "InstructionPersistenceClassifier", "PluralisticDeliberationOrchestrator"],
|
||||
principle: "deep_interlock"
|
||||
},
|
||||
active: true,
|
||||
notes: "Centers Reinforce Centers - Deep Interlock principle from Christopher Alexander"
|
||||
},
|
||||
{
|
||||
id: "inst_091",
|
||||
text: "Framework changes must preserve wholeness - existing audit logs remain interpretable, prior governance decisions remain valid, instruction precedents maintain authority",
|
||||
timestamp: new Date().toISOString(),
|
||||
quadrant: "STRATEGIC",
|
||||
persistence: "HIGH",
|
||||
temporal_scope: "PERMANENT",
|
||||
verification_required: "MANDATORY",
|
||||
explicitness: 0.95,
|
||||
source: "architectural_principle",
|
||||
session_id: "2025-10-30-alexander-integration",
|
||||
parameters: {
|
||||
principle: "structure_preserving_transformation",
|
||||
preservation_targets: ["audit_logs", "governance_decisions", "instruction_precedents"]
|
||||
},
|
||||
active: true,
|
||||
notes: "Structure-Preserving Transformations Only - Enhance wholeness while maintaining coherence"
|
||||
},
|
||||
{
|
||||
id: "inst_092",
|
||||
text: "Governance operates on gradients (NORMAL/ELEVATED/HIGH/CRITICAL context pressure, LOW/MEDIUM/HIGH persistence) rather than binary yes/no switches",
|
||||
timestamp: new Date().toISOString(),
|
||||
quadrant: "STRATEGIC",
|
||||
persistence: "HIGH",
|
||||
temporal_scope: "PERMANENT",
|
||||
verification_required: "REQUIRED",
|
||||
explicitness: 0.88,
|
||||
source: "architectural_principle",
|
||||
session_id: "2025-10-30-alexander-integration",
|
||||
parameters: {
|
||||
principle: "gradients_not_binary",
|
||||
examples: ["context_pressure_levels", "persistence_levels", "verification_requirements"]
|
||||
},
|
||||
active: true,
|
||||
notes: "Gradients Over Binary Switches - Natural systems use gradients, not binary switches"
|
||||
},
|
||||
{
|
||||
id: "inst_093",
|
||||
text: "Framework evolves through real-world use and feedback, not top-down specification - governance grows from failures and successes, not predetermined plans",
|
||||
timestamp: new Date().toISOString(),
|
||||
quadrant: "STRATEGIC",
|
||||
persistence: "HIGH",
|
||||
temporal_scope: "PERMANENT",
|
||||
verification_required: "REQUIRED",
|
||||
explicitness: 0.85,
|
||||
source: "architectural_principle",
|
||||
session_id: "2025-10-30-alexander-integration",
|
||||
parameters: {
|
||||
principle: "living_process",
|
||||
evolution_triggers: ["real_failures", "audit_log_analysis", "governance_gaps", "user_feedback"]
|
||||
},
|
||||
active: true,
|
||||
notes: "Living Process Over Fixed Design - Systems grow organically through use"
|
||||
},
|
||||
{
|
||||
id: "inst_094",
|
||||
text: "Governance must be woven into AI deployment architecture, not bolted on as separate compliance layer - if AI can execute without governance validation, framework is separate (and will be bypassed)",
|
||||
timestamp: new Date().toISOString(),
|
||||
quadrant: "STRATEGIC",
|
||||
persistence: "HIGH",
|
||||
temporal_scope: "PERMANENT",
|
||||
verification_required: "MANDATORY",
|
||||
explicitness: 0.93,
|
||||
source: "architectural_principle",
|
||||
session_id: "2025-10-30-alexander-integration",
|
||||
parameters: {
|
||||
principle: "not_separateness",
|
||||
integration_test: "can_ai_bypass_governance"
|
||||
},
|
||||
active: true,
|
||||
notes: "Not-Separateness (Framework Integration) - Deep integration, not bolt-on compliance"
|
||||
}
|
||||
];
|
||||
|
||||
function main() {
|
||||
console.log('═══════════════════════════════════════════════════════════');
|
||||
console.log(' Integrating Christopher Alexander Pattern Rules');
|
||||
console.log('═══════════════════════════════════════════════════════════\n');
|
||||
|
||||
// Read current instruction history
|
||||
let history;
|
||||
try {
|
||||
history = JSON.parse(fs.readFileSync(INSTRUCTION_HISTORY_PATH, 'utf8'));
|
||||
} catch (err) {
|
||||
console.error('❌ Error reading instruction-history.json:', err.message);
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
console.log(`📖 Current version: ${history.version}`);
|
||||
console.log(` Total instructions: ${history.instructions.length}`);
|
||||
console.log(` Active instructions: ${history.instructions.filter(i => i.active).length}\n`);
|
||||
|
||||
// Check if Alexander rules already exist
|
||||
const existingAlexander = history.instructions.filter(i =>
|
||||
i.id >= 'inst_090' && i.id <= 'inst_094'
|
||||
);
|
||||
|
||||
if (existingAlexander.length > 0) {
|
||||
console.log('⚠️ Alexander rules already exist:');
|
||||
existingAlexander.forEach(i => console.log(` ${i.id}: ${i.text.substring(0, 60)}...`));
|
||||
console.log('\n❌ Aborting integration to prevent duplicates');
|
||||
console.log(' Delete existing rules first or use a different approach\n');
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
// Add Alexander rules
|
||||
console.log('✨ Adding 5 Alexander Pattern Rules:\n');
|
||||
alexanderRules.forEach(rule => {
|
||||
history.instructions.push(rule);
|
||||
console.log(` ✓ ${rule.id}: ${rule.text.substring(0, 60)}...`);
|
||||
});
|
||||
|
||||
// Update version
|
||||
history.version = "4.3";
|
||||
history.last_updated = new Date().toISOString();
|
||||
|
||||
console.log(`\n📦 Updated version: ${history.version}`);
|
||||
console.log(` Total instructions: ${history.instructions.length}`);
|
||||
console.log(` Active instructions: ${history.instructions.filter(i => i.active).length}\n`);
|
||||
|
||||
// Write back to file
|
||||
try {
|
||||
fs.writeFileSync(INSTRUCTION_HISTORY_PATH, JSON.stringify(history, null, 2), 'utf8');
|
||||
} catch (err) {
|
||||
console.error('❌ Error writing instruction-history.json:', err.message);
|
||||
process.exit(1);
|
||||
}
|
||||
|
||||
console.log('✅ Integration complete!\n');
|
||||
console.log('═══════════════════════════════════════════════════════════');
|
||||
console.log(' Next Steps:');
|
||||
console.log('═══════════════════════════════════════════════════════════\n');
|
||||
console.log('1. Run: node scripts/sync-instructions-to-db.js');
|
||||
console.log('2. Verify framework with: node scripts/framework-stats.js');
|
||||
console.log('3. Test integration with: node scripts/session-init.js\n');
|
||||
}
|
||||
|
||||
main();
|
||||
Loading…
Add table
Reference in a new issue