tractatus/NEW_SESSION_PROMPT.md

New Session Startup Prompt

For use with Claude Code - October 2025

---

Recommended Startup Prompt

I'm starting a NEW session on the Tractatus Framework project.

Current state:
- Local development server needs restart: npm start (port 9000)
- MongoDB tractatus_dev running on port 27017
- Recent work: Completed multilingual implementation with simplified icons-only language selector
- Repository status: 15 commits ahead of origin/main (MUST PUSH)
- All framework tests passing (238/238)

MANDATORY tasks:
1. Run session-init.js (will block if not done)
2. Push 15 commits to remote repository (git push origin main)
3. Audit status against /home/theflow/projects/tractatus/docs/plans/integrated-implementation-roadmap-2025.md
4. Update roadmap progress based on completed work
5. Identify next priority tasks from roadmap

Please review session handoff: SESSION_HANDOFF_2025-10-17_LANGUAGE_SELECTOR.md

Confirm framework initialization and proceed with mandatory tasks.

---

Alternative Prompt (If Specific Task Known)

I'm starting a NEW session on the Tractatus Framework project.

Task: [DESCRIBE YOUR TASK HERE]

Project state:
- Recent completion: Multilingual implementation (icons-only language selector)
- Repository: 15 commits ahead of origin/main
- Framework components: All operational
- Handoff available: SESSION_HANDOFF_2025-10-17_LANGUAGE_SELECTOR.md

Please run session-init.js and then proceed with the task.

---

Key Context for New Session

Recent Major Changes

1. Language Selector Simplified (Oct 17, 2025)

   • Removed dropdown interface
   • Unified to icons-only across all devices
   • Added Māori flag with "Planned" state
   • File: public/js/components/language-selector.js

2. Multilingual Support Complete (Oct 2025)

   • 7 pages with data-i18n attributes
   • English translations complete
   • German/French translations need professional review
   • Cache-busting version: ?v=0.1.0.1760643941

3. Framework Enforcement Architecture (Oct 15, 2025)

   • Hook validators operational
   • Pre-action checks enforcing governance
   • CSP compliance monitored automatically
   • Session-init.js blocks without local server

Repository State

• Branch: main
• Status: 15 commits ahead of origin/main
• Last commits:
  • e4bb7b4 - chore: update session metrics and roadmap progress
  • 514d3f2 - refactor(i18n): simplify language selector to icons-only
  • 9ddc34e - fix(i18n): use block/hidden pattern for selectors

Technical Details

• Node.js/Express: Port 9000
• MongoDB: Port 27017, database tractatus_dev
• Production: https://agenticgovernance.digital
• SSH Deploy: ~/.ssh/tractatus_deploy to ubuntu@vps-93a693da.vps.ovh.net
• Tech Stack: Vanilla JS, Tailwind CSS, MongoDB, Express (NO shared code with other projects)

Important Files

• CLAUDE.md - Project instructions (mandatory reading)
• CLAUDE_Tractatus_Maintenance_Guide.md - Full governance framework
• SESSION_HANDOFF_2025-10-17_LANGUAGE_SELECTOR.md - Latest work completed
• SESSION_HANDOFF_2025-10-15_ENFORCEMENT_ARCHITECTURE.md - Framework architecture
• .claude/instruction-history.json - Persistent instruction database (37 active)

---

Session Initialization Checklist

When starting a new session, ensure:

1. ✅ Run node scripts/session-init.js (MANDATORY - first action)
2. ✅ Review session handoff document if continuing previous work
3. ✅ Start local dev server: npm start (port 9000)
4. ✅ Verify MongoDB connection (port 27017)
5. ✅ Check git status and branch
6. ✅ Use TodoWrite for task planning (if complex/multi-step work)

---

Common Commands

# Session initialization (MANDATORY)
node scripts/session-init.js

# Development
npm start                                      # Start local server (port 9000)
node scripts/check-session-pressure.js         # Check context pressure

# Testing
npm test                                       # Run all tests
npm run test:unit                              # Run unit tests only

# Deployment
./scripts/deploy-full-project-SAFE.sh          # Deploy to production (comprehensive)
ssh -i ~/.ssh/tractatus_deploy ubuntu@vps-93a693da.vps.ovh.net "sudo systemctl status tractatus"

# Document workflow
npm run migrate:docs -- --source docs/markdown --force
node scripts/generate-single-pdf.js <input.md> <output.pdf>

# Git workflow
git status
git add [files]
git commit -m "..."
git push origin main

---

Framework Components

All 6 components should initialize automatically via session-init.js:

1. ContextPressureMonitor - Token/complexity tracking
2. InstructionPersistenceClassifier - Long-term instruction management
3. CrossReferenceValidator - Detect conflicting instructions
4. BoundaryEnforcer - File/command governance
5. MetacognitiveVerifier - Self-monitoring and error detection
6. PluralisticDeliberationOrchestrator - Multi-perspective decision making

Token checkpoints at: 50k, 100k, 150k tokens (200k total budget)

---

Notes

• Session-init.js is MANDATORY - It will block if local server not running on port 9000
• Framework fade prevention - If governance not followed, it's an enforcement gap (fix architecturally)
• Human approval required - Architectural changes, DB schema, security, values content
• Quality standard - World-class, no shortcuts, no fake data
• Process management - systemd (NOT pm2) on production

---

Last Updated: 2025-10-17 Next Session Type: NEW (not continuation) Priority: Push commits to remote repository