Commit Graph

9 Commits

Author SHA1 Message Date
6df9b5df05 feat: add terminology schema example and improve schema-list command
This commit completes Phase 2 of schema evolution work and establishes
a new example demonstrating schema usage for terminology documents.

## New Features

### Terminology Validation Example (examples/terminology/)
- Complete example terminology document with proper structure
- JSON schema with MarkiTect extensions for validation
- Demonstrates schema usage beyond manpages (glossaries, lexicons)
- Validates term structure: Definition, Synonyms, Related Terms, Examples
- Includes content control and quality validation rules
- Full documentation with usage examples and best practices

### Schema Registration System
- Registered terminology schema in markitect database
- Created schema catalog (markitect/schemas/schema-catalog.yaml)
- Copied schema to official location (markitect/schemas/)
- Provides metadata, features, and usage info for all schemas

### Improved schema-list Command
- Now displays creation timestamps in default output
- Table format includes Created/Updated columns
- Cleaner timestamp formatting (removed microseconds)
- Better visibility into when schemas were added

## Files Changed

Added:
- examples/terminology/README.md - Complete documentation
- examples/terminology/terminology-example.md - Example glossary
- examples/terminology/terminology-schema.json - Validation schema
- markitect/schemas/terminology-schema.json - Registered schema
- markitect/schemas/schema-catalog.yaml - Schema registry

Modified:
- markitect/cli.py - Enhanced schema-list with timestamps
- TODO.md - Documented Phase 2 completion and new example

Moved:
- SCHEMA_EVOLUTION_WORKPLAN.md → todo/ directory

## Schema Features Demonstrated

- Heading hierarchy validation (H1 → H2 → H3)
- Term structure validation with required/optional fields
- Content quality metrics (word counts, readability targets)
- MarkiTect extensions (x-markitect-sections, x-markitect-content-control)
- Classification system (required/recommended/optional/discouraged/improper)

## Usage

```bash
# List schemas with timestamps
markitect schema-list

# Validate terminology document
markitect validate glossary.md --schema terminology-schema.json

# View in table format
markitect schema-list --format table
```

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

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-04 23:07:36 +01:00
b82da581ef chore: some cleanup and houskeeping 2025-10-06 22:51:38 +02:00
d68eac3275 feat: consolidate and optimize Claude Code agent ecosystem
- Create comprehensive datamodel optimization specialist agent
- Migrate testing efficiency and requirements engineering agents from docs to .claude/agents
- Rename kaizen-optimizer to agent-optimizer for clarity
- Remove duplicate documentation following DRY principle
- Create docs/agents symlink for easy agent visibility
- Add issue datamodel optimization gameplan with 4-week implementation strategy

Agent improvements:
- Enhanced requirements engineering agent with Issue #59 lessons learned
- Added practical toolkit commands and enhanced TDD8 workflow integration
- Consolidated agent configurations as single source of truth

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-05 20:50:52 +02:00
59814d84d8 docs: implement comprehensive cost tracking system design for issue #88
- Created detailed gameplan for cost tracking and allocation system
- Designed database schema for financial data (costs, periods, transactions, allocations)
- Planned cost allocation algorithm with loss carried forward handling
- Created 9 implementation issues (#110-118) registered in system
- Organized by 3 phases: Foundation → Business Logic → User Features
- Includes CLI commands, reporting, and automation capabilities

Key Features:
- Track monthly/one-time costs with audit trail
- Allocate costs to active issues in calculation periods
- Financial reporting and trend analysis
- Automated period management and calculations
- Integration with existing issue management system

Implementation Timeline: 23 days (4.5 weeks)
Total Issues Created: 9 issues (#110-118)
Estimated Monthly Costs: €87 (server, SaaS, domains, tools)

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-04 00:38:05 +02:00
dba15afc20 chore: cleanup in todo:wq
Some checks failed
Test Suite / unit-tests (3.11) (push) Has been cancelled
Test Suite / unit-tests (3.12) (push) Has been cancelled
Test Suite / integration-tests (push) Has been cancelled
Test Suite / e2e-tests (push) Has been cancelled
Test Suite / performance-tests (push) Has been cancelled
Test Suite / code-quality (push) Has been cancelled
Test Suite / security-scan (push) Has been cancelled
Test Suite / test-summary (push) Has been cancelled
2025-10-04 00:32:27 +02:00
371412bcbb docs: move LLM integration planning documents to history
- Moved LLM_INTEGRATION_GAMEPLAN.md to history/ (strategic planning complete)
- Moved IMPLEMENTATION_ISSUES.md to history/ (issues created in system)
- Both documents served their purpose in planning and issue creation
- Issues #100-109 now registered in MarkiTect issue management system
- Ready for future development when LLM integration work begins

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-04 00:29:51 +02:00
92cc73d185 docs: create detailed implementation issues from LLM integration gameplan
- Transformed strategic gameplan into 10 specific GitHub issues
- Organized by priority (4 high, 4 medium, 2 low) and dependencies
- Sized appropriately (1-4 days each) for agile development
- Covers both OpenRoute Integration (#98) and Auto Fill Templates (#99)
- Includes 3-phase implementation plan (Foundation → Integration → Advanced)
- Provides acceptance criteria, technical details, and testing requirements
- Ready for GitHub issue creation and sprint planning

Issues created:
1. OpenRouter LLM Client Infrastructure (HIGH, 2 days)
2. Configuration System Extensions (HIGH, 1 day)
3. LLM Content Context Builder (HIGH, 3 days)
4. Natural Language Paradigm Enhancement (MEDIUM, 2 days)
5. Basic LLM CLI Commands (MEDIUM, 1 day)
6. Template Field Analysis and Parsing (HIGH, 3 days)
7. Interactive Template Questionnaire (MEDIUM, 4 days)
8. User Profile Management System (HIGH, 2 days)
9. LLM-Powered Template Auto-Fill (MEDIUM, 4 days)
10. Advanced Template Fill Commands (LOW, 2 days)

Total: 21 development days across 4-5 weeks

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-04 00:23:43 +02:00
f63101cad8 docs: add comprehensive LLM integration gameplan for issues #98 & #99
- Created detailed implementation strategy for OpenRoute integration (issue #98)
- Designed auto-fill templates system with LLM assistance (issue #99)
- Analyzed existing infrastructure and identified reusable components
- Provided 4-6 week phased development plan with clear priorities
- Included technical architecture, database schemas, and testing strategy
- Added risk assessment, success metrics, and requirements engineering guidance
- Recommended starting with OpenRoute client as shared foundation

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-10-04 00:16:17 +02:00
19f1898d1a chore: history cleanup 2025-10-03 03:39:43 +02:00