An advanced markdown engine
Find a file
tegwick d8c2d198e3 feat: Complete Issue #6 - Generate Markdown Stub from Schema
🎯 Core Implementation:
- StubGenerator class with intelligent heading hierarchy generation
- CLI command 'generate-stub' with comprehensive options (--output, --style, --title)
- Multiple placeholder styles: default, custom, detailed
- Full file I/O support and error handling

📊 Features Delivered:
- Template generation from JSON schemas with proper heading structure
- Intelligent section naming based on document hierarchy
- Round-trip validation: generated stubs validate against source schemas
- Integration with existing schema generation and validation workflow

🧪 Quality Assurance:
- 23 comprehensive tests covering all functionality
- Complete TDD8 methodology: RED-GREEN-REFACTOR cycle
- CLI integration tests and error handling validation
- 417/417 total tests passing - no regressions

🔄 Bidirectional Workflow Complete:
Schema Generation ( Issue #5) → Schema Validation ( Issue #7) → Stub Generation ( Issue #6)

This completes the critical template-driven document creation workflow essential
for arc42 architecture documentation system goals.

Usage Examples:
  markitect generate-stub blog_schema.json --output template.md
  markitect generate-stub schema.json --style detailed --title "My Document"

🎖️ Strategic Achievement: Template generation foundation complete and production-ready

🧪 Generated with [Claude Code](https://claude.ai/code)

Co-Authored-By: Claude <noreply@anthropic.com>
2025-09-30 03:31:48 +02:00
.claude/agents feat: Revolutionary Test Architecture - 7-Layer Organization with Advanced Testing Capabilities 2025-09-29 12:18:25 +02:00
.github/workflows feat: Implement comprehensive Testing Architecture Enhancement 2025-09-26 22:36:35 +02:00
.venv_old chore: Keep old venv from ubuntu 18.04 for now just in case. 2025-09-23 01:16:12 +02:00
application feat: Implement domain logic separation with clean architecture 2025-09-26 22:15:45 +02:00
cli feat: Complete Issue #18 - Configuration and Environment Management CLI 2025-09-29 00:18:27 +02:00
config feat: Implement unified configuration management system 2025-09-26 17:45:56 +02:00
diary feat: Implement automatic git repository configuration detection for Gitea 2025-09-28 23:27:13 +02:00
docs feat: Complete Issue #13 - Cache Management CLI Commands MAJOR MILESTONE 2025-09-25 23:03:03 +02:00
domain fix: Eliminate all 111 test warnings by fixing root causes 2025-09-27 20:14:22 +02:00
gitea feat: Consolidate Gitea API access through unified integration layer 2025-09-28 23:44:51 +02:00
infrastructure fix: Eliminate all 111 test warnings by fixing root causes 2025-09-27 20:14:22 +02:00
markitect feat: Complete Issue #6 - Generate Markdown Stub from Schema 2025-09-30 03:31:48 +02:00
services feat: Complete type safety improvements for CLI and service layers 2025-09-27 09:02:31 +02:00
tddai feat: Consolidate Gitea API access through unified integration layer 2025-09-28 23:44:51 +02:00
tests feat: Complete Issue #6 - Generate Markdown Stub from Schema 2025-09-30 03:31:48 +02:00
wiki@0754bacfd5 feat: Complete Issue #13 - Cache Management CLI Commands MAJOR MILESTONE 2025-09-25 23:03:03 +02:00
.env.tddai refactor: Make tddai framework project-agnostic and fix test configuration 2025-09-24 00:04:54 +02:00
.gitignore refactor: Separate CLI presentation from core business logic 2025-09-26 15:08:54 +02:00
.gitmodules Add wiki as submodule tracking main 2025-09-16 23:28:11 +02:00
ARCHITECTURAL_CHAOS_TESTING_ISSUE.md feat: Revolutionary Test Architecture - 7-Layer Organization with Advanced Testing Capabilities 2025-09-29 12:18:25 +02:00
ARCHITECTURE.md feat: Revolutionary Test Architecture - 7-Layer Organization with Advanced Testing Capabilities 2025-09-29 12:18:25 +02:00
CAPABILITIES.md feat: Revolutionary Test Architecture - 7-Layer Organization with Advanced Testing Capabilities 2025-09-29 12:18:25 +02:00
CONFIG.md feat: Enhance tddai configuration with auto-loading .env files 2025-09-24 22:53:27 +02:00
DATA_ACCESS_IMPROVEMENTS_GAMEPLAN.md feat: Implement domain logic separation with clean architecture 2025-09-26 22:15:45 +02:00
DIRECTORY_STRUCTURE_OPTIMIZATION_GAMEPLAN.md feat: Optimize Directory Structure Gameplan with professional-grade enhancements 2025-09-27 22:16:45 +02:00
DOMAIN_LOGIC_SEPARATION_DEMO.md feat: Implement domain logic separation with clean architecture 2025-09-26 22:15:45 +02:00
DOMAIN_LOGIC_SEPARATION_GAMEPLAN.md feat: Implement domain logic separation with clean architecture 2025-09-26 22:15:45 +02:00
ERROR_HANDLING_GUIDE.md docs: Add comprehensive error handling guidelines 2025-09-26 16:54:44 +02:00
FEATURES.md chore: Update features and issue lib 2025-09-26 17:19:16 +02:00
GITEA_INTEGRATION_CONSOLIDATION_GAMEPLAN.md feat: Consolidate Gitea API access through unified integration layer 2025-09-28 23:44:51 +02:00
gitea_issue_body.txt feat: Complete gitea integration test consolidation 2025-09-28 23:55:02 +02:00
install-claude.sh agent: Finally found a way to install claude again 2025-09-23 02:24:09 +02:00
install-cursor.sh chore: Try add cursor as alternative coding env 2025-09-25 01:59:11 +02:00
install-depends.sh build: Helpers to initially setup the dev env 2025-09-23 01:23:32 +02:00
install-nvm.sh build: Helpers to initially setup the dev env 2025-09-23 01:23:32 +02:00
install-pip.sh feat: Add Python dependency management and fix test environment 2025-09-23 02:41:32 +02:00
MAIN_BRANCH_OPTIMIZATION_GAMEPLAN.md docs: Add main branch optimization gameplan and priority assistant 2025-09-28 17:31:49 +02:00
Makefile feat: Complete Issue #3 - Schema Management with Enhanced Format Control 2025-09-30 02:59:43 +02:00
NEXT.md feat: Complete Issue #6 - Generate Markdown Stub from Schema 2025-09-30 03:31:48 +02:00
ProjectDiary.md feat: Revolutionary Test Architecture - 7-Layer Organization with Advanced Testing Capabilities 2025-09-29 12:18:25 +02:00
ProjectStatusDigest.md docs: Updated project documentation 2025-09-25 23:17:14 +02:00
pyproject.toml feat: Complete type safety improvements for CLI and service layers 2025-09-27 09:02:31 +02:00
README.md feat: Complete Issue #13 - Cache Management CLI Commands MAJOR MILESTONE 2025-09-25 23:03:03 +02:00
RelevantClaudeIssues.md docs: Document subagent infrastructure resolution and environment restoration 2025-09-23 02:58:36 +02:00
retrieved_roundtrip.md feat: Complete Issue #2 - Fast Document Loading & CLI Manipulation 2025-09-25 03:03:04 +02:00
ROADMAP.md feat: Complete Strategic Roadmap Implementation for HolyGrailRequirement 2025-09-25 14:08:42 +02:00
run_architectural_tests.py feat: Revolutionary Test Architecture - 7-Layer Organization with Advanced Testing Capabilities 2025-09-29 12:18:25 +02:00
run_randomized_tests.py feat: Revolutionary Test Architecture - 7-Layer Organization with Advanced Testing Capabilities 2025-09-29 12:18:25 +02:00
schema_summary.py feat: Complete Issue #3 - Schema Management with Enhanced Format Control 2025-09-30 02:59:43 +02:00
tddai-setup.sh refactor: Make tddai framework project-agnostic and fix test configuration 2025-09-24 00:04:54 +02:00
tddai_cli.py feat: Complete Issue #18 - Configuration and Environment Management CLI 2025-09-29 00:18:27 +02:00
tddai_issue_body.txt feat: Complete gitea integration test consolidation 2025-09-28 23:55:02 +02:00
TEST_ARCHITECTURE.md feat: Revolutionary Test Architecture - 7-Layer Organization with Advanced Testing Capabilities 2025-09-29 12:18:25 +02:00
test_frontmatter.md feat: Complete Issue #2 - Fast Document Loading & CLI Manipulation 2025-09-25 03:03:04 +02:00
test_roundtrip.md feat: Complete Issue #2 - Fast Document Loading & CLI Manipulation 2025-09-25 03:03:04 +02:00
test_status_report.md feat: Add make test-status for quick test overview without re-running 2025-09-23 03:16:50 +02:00
TESTING_ARCHITECTURE_ENHANCEMENT_GAMEPLAN.md feat: Implement domain logic separation with clean architecture 2025-09-26 22:15:45 +02:00
visualize_schema.py feat: Complete Issue #8 - Detailed Validation Error Reporting and CLI Enhancements 2025-09-29 21:21:21 +02:00

MarkiTect - Advanced Markdown Engine

Your Markdown, Redefined.

MarkiTect transforms markdown from plain text into intelligent, structured data with performance optimization, schema validation, and relational querying capabilities. Stop treating documentation as text files—start managing it as a database.

Key Features:

  • Lightning Performance: 60-85% faster document processing through intelligent AST caching
  • Schema Validation: Enforce document structure and consistency
  • Database Integration: Query markdown content with SQL-like operations
  • CLI Tools: Complete command-line interface for automation and workflows

📚 Documentation

Quick Start: Getting Started · Command Reference

Architecture: Caching System · Performance Philosophy

Development: TDD Workflow · Contributing

Project Status: Current Status · Roadmap · Next Actions