2 Commits

Author	SHA1	Message	Date
tegwick	3034b90a0e	feat: Implement Issue #55 - Schema-based draft generation with content instructions ... This implementation enhances the existing generate-stub command to utilize content field instructions from schemas, providing guided document generation with specific placeholder text instead of generic "TODO" messages. ## Key Features Added: ### Enhanced Schema-Based Generation - Content instructions from schemas (x-markitect-content-instructions) are now used - Schema reference metadata included in generated drafts for traceability - Intelligent fallback to generic placeholders for schemas without instructions - Full integration with existing generate-stub CLI command and options ### StubGenerator Enhancements - New _extract_content_instruction_from_heading_schema method for instruction parsing - Enhanced _get_placeholder_content method with schema-aware content generation - Updated method signatures to support schema_file_path parameter throughout - Robust handling of both content instruction and legacy schema formats ### CLI Integration - Updated generate-stub command documentation with content instruction examples - Enhanced help text explaining automatic content instruction usage - Fixed output file generation to include schema references correctly - Maintained full backward compatibility with existing usage patterns ### Technical Implementation - Schema reference comments (<!-- Generated from schema: path -->) in generated drafts - Content instruction text extracted from x-markitect-content-instructions fields - Support for all instruction types (description, example, constraint, template) - Integration with existing heading hierarchy and placeholder style systems ## Integration and Compatibility: - Seamless integration with Issue #54 content field instructions - Full backward compatibility with existing schemas and usage - Works with outline mode schemas and heading text capture features - Comprehensive error handling and graceful degradation ## Testing and Validation: - Comprehensive test suite covering all acceptance criteria - Integration tests with schema-generate → generate-stub workflow - Validation of schema reference metadata and content instruction usage - Backward compatibility testing with legacy schemas This completes Issue #55 with full feature implementation, comprehensive testing, and enhanced documentation for schema-based draft generation capabilities. 🤖 Generated with [Claude Code](https://claude.ai/code) Co-Authored-By: Claude <noreply@anthropic.com>	2025-10-01 08:41:28 +02:00
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