Files

tegwick c5f49b2dd0 feat: implement todofile system and retire NEXT.md

Replace NEXT.md approach with standardized Keep a Todofile V0.0.1 format
for better task management and human-AI collaboration during coding sessions.

## Todofile System Setup:
- **TODO.md**: Main todofile following Keep a Todofile V0.0.1 format
- **TODOFILE_GUIDE.md**: Comprehensive system documentation and workflow
- **Integration**: Fully integrated with existing kaizen-agentic framework
- **Agent Support**: Uses agent-keepaTodofile for maintenance

## Content Migration:
- Migrated strategic priorities from NEXT.md to TODO.md [Unreleased] section
- Preserved session success criteria and development milestones
- Organized tasks by impact type (To Add, To Fix, To Refactor)
- Archived NEXT.md to history/NEXT_archived_20251025.md

## Documentation Updates:
- README.md: Updated "Next Actions" → "Current Tasks" link
- agent-project-management.md: Updated workflow to use TODO.md
- docs/README.md: Updated project management references
- Added comprehensive TODOFILE_GUIDE.md

## Benefits:
- **Standardized Format**: Industry-standard Keep a Todofile format
- **Better Organization**: Impact-based task categorization
- **AI-Ready**: Designed for human-AI collaboration workflows
- **Context Preservation**: Maintains coding flow across session interruptions
- **Integration Ready**: Works with existing agent and capability systems

Active tasks now in TODO.md [Unreleased] section focusing on strategic
issue resolution and capability management validation.

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

Co-Authored-By: Claude <noreply@anthropic.com>

2025-10-25 02:48:45 +02:00

3.7 KiB

Raw Blame History

MarkiTect Todofile System

Overview

MarkiTect uses the Keep a Todofile V0.0.1 format for task management and development coordination. This replaces the previous NEXT.md approach with a standardized todofile system that provides better structure for maintaining coding flow and AI assistant coordination.

Location and Format

Main Todofile: TODO.md in the project root
Format: Keep a Todofile V0.0.1
Agent Support: Managed by the agent-keepaTodofile agent in the kaizen-agentic framework

Structure

The todofile is organized by impact type rather than arbitrary priority:

[Unreleased] - Active Vibe-Coding State 💡

To Add: New features, capabilities, or functionality
To Refactor: Code improvements and restructuring
To Fix: Bug fixes and error corrections
To Remove: Features or code to eliminate

[Version] - Planned Increments

Organized by planned version/milestone with the same impact categories:

To Add: Planned new functionality
To Fix: Scheduled bug fixes
To Refactor: Planned code improvements
To Deprecate: Features marked for future removal
To Secure: Security improvements
To Remove: Planned removals

Integration with Project Workflow

Task Management

Use TODO.md for active development tasks and immediate next steps
Link to Gitea issues for longer-term planning: Related to issue #123
Update during development sessions to maintain context

AI Assistant Coordination

The todofile serves as a shared source of truth between human developers and AI assistants
Helps maintain context during interruptions and session transfers
Enables consistent progress tracking and decision-making

Development Best Practices

Update Regularly: Maintain current state during active development
Focus on Immediate: Keep [Unreleased] section for current work
Plan Versions: Use version sections for commit boundaries
Archive Completed: Move completed items to archive sections
Link Issues: Connect todofile items to Gitea issues for full context

Agent Integration

The agent-keepaTodofile agent provides specialized support for:

Creating and maintaining TODO.md files following the official format
Organizing tasks by impact type (Add, Fix, Refactor, etc.)
Integrating with issue tracking and TDD workflows
Maintaining coding flow and context preservation
Converting between task management formats

Migration from NEXT.md

The previous NEXT.md file has been archived to history/NEXT_archived_YYYYMMDD.md. All relevant content has been migrated to the new TODO.md format while preserving:

Strategic development priorities
Capability management workflows
Session success criteria
Development milestones

Agent Definition: agents/agent-keepaTodofile.md - Specialized todofile management agent
Context Documentation: capabilities/kaizen-agentic/context/KeepaTodofile.md - Detailed format specification
Capability Integration: CAPABILITY_INCLUSION_GUIDE.md - How todofile fits with capability discovery
Project Management: agents/agent-project-management.md - Overall project coordination

Benefits

Standardized Format: Follows established Keep a Todofile conventions
Better Organization: Impact-based categorization aligns with changelog structure
AI Assistant Ready: Designed for human-AI collaboration in coding sessions
Context Preservation: Maintains coding flow across interruptions
Integration Ready: Works with existing issue management and TDD workflows

3.7 KiB Raw Blame History