diff --git a/TODO.md b/TODO.md index 5d10303b..d3466941 100644 --- a/TODO.md +++ b/TODO.md @@ -12,10 +12,73 @@ The structure organizes **future tasks** by their impact, just as a changelog or This section is for tasks currently being discussed with or worked on by the coding assistant. These are the ephemeral, flow-of-thought tasks. -*No active tasks at this time.* +### Extract Capability-Capability from Issue-Facade + +**Context:** Issue-facade currently provides two capabilities: +1. **issue-tracking** (explicit in CAPABILITY-issue-tracking.yaml) - Issue management across platforms +2. **capability-capability** (implicit) - Patterns and tools for creating/managing capabilities + +The **capability-capability** includes: +- Feedback pattern (feedback/ directory, .capability/feedback CLI tool, documentation) +- Detachment facility (.capability/detach script for clean capability removal) +- Integration pattern (.capability/integrate.sh for project integration) +- CAPABILITY-*.yaml specification format +- ReusableCapabilitiesArchitecture.md (complete specification) +- Directory conventions (_family/implementation, visible/hidden patterns) + +**Goal:** Extract capability-capability to separate `reusable-capability` repository so it can be used by any capability in the markitect ecosystem. + +**Approach:** Step-by-step extraction, starting with specification. + +#### Phase 1: Specification & Planning (Current) + +- [ ] Create CAPABILITY-capability.yaml in issue-facade to explicitly declare the implicit capability +- [ ] Define what belongs to capability-capability family vs issue-tracking family +- [ ] Document the capability-capability API surface (what tools/patterns it provides) +- [ ] Identify all files/directories to extract +- [ ] Plan extraction strategy (copy vs move, how to maintain during transition) + +#### Phase 2: Repository Creation + +- [ ] Create reusable-capability repository structure +- [ ] Extract ReusableCapabilitiesArchitecture.md to new repo +- [ ] Extract feedback pattern (directory structure, CLI tool, README) +- [ ] Extract detachment facility (.capability/detach) +- [ ] Extract integration scripts (.capability/integrate.sh, integration-checklist.md) +- [ ] Create CAPABILITY-capability.yaml in new repo (canonical version) +- [ ] Add README.md for reusable-capability repo + +#### Phase 3: Integration & Testing + +- [ ] Update issue-facade to depend on reusable-capability (as integrated capability) +- [ ] Integrate reusable-capability into issue-facade using _capability/reusable-capability pattern +- [ ] Test that issue-facade still works with extracted capability +- [ ] Update issue-facade documentation to reference both capabilities it provides/uses +- [ ] Verify feedback system still works +- [ ] Verify detachment still works + +#### Phase 4: Dogfooding & Validation + +- [ ] Choose another markitect capability for dogfooding +- [ ] Integrate reusable-capability into that capability +- [ ] Add feedback system to new capability +- [ ] Add detachment facility to new capability +- [ ] Document learnings and refine reusable-capability based on real-world usage +- [ ] Update ReusableCapabilitiesArchitecture.md with insights + +**Current Step:** Phase 1, Task 1 - Create CAPABILITY-capability.yaml *** ## Completed Tasks -*Recent completed tasks have been documented in CHANGELOG.md following Keep a Changelog format.* \ No newline at end of file +*Recent completed tasks have been documented in _issue-tracking/issue-facade/CHANGELOG.md following Keep a Changelog format.* + +### 2025-12-17 - Architecture Refactoring +- ✅ Implemented ReusableCapabilitiesArchitecture v0.1 +- ✅ Added feedback capability to issue-facade +- ✅ Created detachment facility +- ✅ Refactored to family-based directory structure (_issue-tracking/issue-facade) +- ✅ Made feedback directory visible (feedback/ not .feedback/) +- ✅ Renamed to explicit family declaration (CAPABILITY-issue-tracking.yaml) +- ✅ Created CHANGELOG.md documenting v1.0.0 \ No newline at end of file