MarkiTect Strategic Roadmap

Target: Transform MarkiTect into an arc42 architecture documentation system with AI-supported plan-actual comparison capabilities (HolyGrailRequirement).

🎯 Strategic Subprojects

1. Schema-Driven Architecture (Milestone #2)

Goal: Schema-first documentation system with validation capabilities

Issue #5: Generate Schema from Markdown File (HIGH)
Issue #7: Validate Markdown Against Schema (HIGH)
Issue #8: Get Validation Errors (HIGH)

2. Template & Stub Generation (Milestone #3)

Goal: arc42-specific templates and automated stub creation

Issue #6: Generate Markdown Stub from Schema (HIGH)

3. Document Relationships (Milestone #4)

Goal: Complex document relationships and cross-references

Issue #4: Retrieve All Stored Files (MEDIUM)
Issue #15: AST Query and Analysis CLI (CRITICAL)

4. Plan-Actual Comparison Engine (Milestone #5)

Goal: AI-supported development guardrails and compliance analysis

Issue #9: Expose GraphQL Read Interface (LOW)
Issue #10: Expose GraphQL Write Interface (LOW)
Issue #16: Performance Validation CLI (MEDIUM)

🚀 Foundation Complete

✅ Issue #14: Database Query CLI Interface - Major milestone achieved
✅ Issue #2: Fast Document Loading & CLI Manipulation
✅ Issue #1: Database initialization and front matter parsing
✅ 125+ tests passing, complete document manipulation workflow

📋 Implementation Priority

CRITICAL (P0): Issues #13, #15 - Foundation requirements
HIGH (P1): Issues #5, #6, #7, #8 - Core schema/template system
MEDIUM (P2): Issues #4, #16 - Relationship management
LOW (P3): Issues #9, #10 - Advanced AI analysis

🎖️ Success Metrics

Current: Complete document manipulation with database querying
Phase 1: Schema validation and template generation operational
Phase 2: Complex document relationships managed
Phase 3: AI-supported plan-actual comparison system deployed

Strategic Value: Each subproject delivers standalone value while advancing toward the complete arc42 documentation intelligence system.

2.1 KiB Raw Blame History