john/tractatus
1
0
Fork 0
Code Issues Pull requests Projects Releases Packages Wiki Activity Actions
392 commits 1 branch 0 tags 125 MiB
Commit graph

3 commits

Author SHA1 Message Date
TheFlow
ac2db33732 fix(submissions): restructure Economist package and fix article display 
- Create Economist SubmissionTracking package correctly:
  * mainArticle = full blog post content
  * coverLetter = 216-word SIR— letter
  * Links to blog post via blogPostId
- Archive 'Letter to The Economist' from blog posts (it's the cover letter)
- Fix date display on article cards (use published_at)
- Target publication already displaying via blue badge

Database changes:
- Make blogPostId optional in SubmissionTracking model
- Economist package ID: 68fa85ae49d4900e7f2ecd83
- Le Monde package ID: 68fa2abd2e6acd5691932150

Next: Enhanced modal with tabs, validation, export

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

Co-Authored-By: Claude <noreply@anthropic.com>
 2025-10-24 08:47:42 +13:00
TheFlow
ef59d93930 refactor: remove all non-implementation documentation 
REMOVED: 11 background/internal documentation files from docs/

Internal Project Documentation (3):
- ADR-001-dual-governance-architecture.md - Internal decision about file vs DB storage
- IMPLEMENTATION_PLAN_2025-10-21.md - Internal planning (session effectiveness 4/10)
- USER_GUIDE_PROJECTS.md, USER_GUIDE_RULE_MANAGER.md - Admin UI guides for Tractatus website

Background/Educational Content (5):
- GLOSSARY.md (both versions) - "Non-technical stakeholders" glossary
- introduction.md - Wittgenstein philosophy background
- core-concepts.md - Conceptual explanations
- technical-architecture.md - Internal architecture overview

Diagrams (2):
- architecture-diagram.mmd, architecture-diagram-generic.mmd - Show website features

RETAINED Implementation Docs:
- API documentation (docs/api/) - RULES_API, PROJECTS_API, OpenAPI spec, examples
- Architecture diagrams (docs/diagrams/*.svg) - Visual reference
- Deployment quickstart

REASON: Public GitHub is for developers IMPLEMENTING the framework,
not for understanding what Tractatus is philosophically or how the
Tractatus project internally works.

All background content belongs on https://agenticgovernance.digital

🤖 Generated with Claude Code
Co-Authored-By: Claude <noreply@anthropic.com>
 2025-10-21 21:28:57 +13:00
TheFlow
1901378a9f docs(framework): create comprehensive improvement implementation plan 
ASSESSMENT: Framework effectiveness rated 4/10 this session
- Hooks work (reactive enforcement) ✅
- But don't guide decisions (proactive assistance) ❌
- Metrics collected but not actionable ❌
- Rules exist but aren't consulted during work ❌

KEY FINDING: Framework missed 15+ inst_017 violations for weeks
- Only caught when user manually requested audit
- No proactive scanning or detection
- Framework was REACTIVE, not PROACTIVE

TOP 3 IMPROVEMENTS PLANNED:

1. Proactive Content Scanning (5-7 hours)
   - Auto-scan for inst_016/017/018 violations on session start
   - Pre-commit hook to prevent violations
   - Would have caught all 15 violations immediately

2. Context-Aware Rule Surfacing (8-9 hours)
   - Surface relevant rules based on activity
   - Editing markdown? Show inst_016/017/018
   - Debugging? Show inst_050/024
   - Makes 52 rules actionable when relevant

3. Active MetacognitiveVerifier (9-11 hours)
   - Detect patterns (repeated failures, same file edited 5x)
   - Suggest relevant solutions ("Try minimal reproduction")
   - Would have guided integration test debugging

IMPLEMENTATION:
- Total effort: 32-40 hours (1 month part-time)
- Expected effectiveness: 4/10 → 8/10
- ROI: HIGH - Prevents violations, guides work, reduces debugging time

See: docs/framework-improvements/IMPLEMENTATION_PLAN_2025-10-21.md

🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude <noreply@anthropic.com>
 2025-10-21 15:51:26 +13:00