Complete and archive a TEDS task
Complete and archive a finished TEDS task, verifying success criteria, documenting learnings, and moving it to the archived tasks directory with a comprehensive summary for future reference.
/plugin marketplace add eternnoir/claude-tool/plugin install teds@claude-toolsLaunch the teds-archiver agent to complete and archive a finished TEDS task.
/teds-complete task-id
# Complete a specific task
/teds-complete 20250116-1430-refactor-auth
# List tasks first, then complete
/teds-status
/teds-complete 20250115-0920-migrate-db
The archiver agent will:
plan.mdexecution_log.mdstatus.yaml: set status to "completed"knowledge_base.mdmanifest.yamlknowledge_index/[task-id]-summary.mdactive_tasks/ to archived_tasks/Before archiving, the agent checks:
Reviewing task completion...
Success Criteria (from plan.md):
✅ All OAuth providers integrated (Google, GitHub)
✅ Tests passing with >90% coverage
✅ Documentation updated
⚠️ Performance benchmarks not run
Incomplete: 1 criterion
Options:
1. Complete anyway (mark as acceptable)
2. Continue task to finish remaining work
3. Cancel and return to task
Choose [1/2/3]:
After successful archival:
# Task Completed: refactor-auth
**Task ID**: 20250116-1430-refactor-auth
**Duration**: 2025-01-16 14:30 to 2025-01-18 16:45
**Total Time**: ~12 hours over 2 days
**Status**: Successfully completed
## Key Outcomes
✅ OAuth 2.0 authentication fully implemented
✅ Google and GitHub providers integrated
✅ Comprehensive test suite (94% coverage)
✅ Documentation complete with examples
✅ Migration guide for existing users
## Key Learnings
1. **Google OAuth Setup**
- Requires web credentials, not service account
- Redirect URIs must match exactly (including trailing slash)
2. **Token Management**
- Refresh tokens expire after 6 months if unused
- Implemented automatic refresh 5 minutes before expiration
3. **Security Considerations**
- PKCE extension essential for public clients
- State parameter prevents CSRF attacks
4. **Testing Insights**
- Mock OAuth providers for unit tests
- Integration tests need real credentials (use staging)
## Statistics
- **Files Modified**: 23
- **Tests Added**: 47
- **Documentation Pages**: 8
- **Checkpoints Created**: 6
- **Knowledge Entries**: 12
## Files Archived
- **Location**: claude_work_space/archived_tasks/20250116-1430-refactor-auth/
- **Summary**: claude_work_space/knowledge_index/20250116-1430-refactor-auth-summary.md
## Reusable Components
The following patterns can be applied to future tasks:
- OAuth provider abstract class design
- Token refresh mechanism
- Integration testing strategy
---
Task successfully archived. Knowledge preserved for future reference.
Completed tasks maintain full structure:
archived_tasks/20250116-1430-refactor-auth/
├── manifest.yaml # Includes completion timestamp
├── plan.md # Original plan with all criteria
├── execution_log.md # Complete action history
├── knowledge_base.md # All learnings
├── context.md # Background preserved
└── status.yaml # Final status: completed
The summary in knowledge_index/ provides quick reference:
# Task Summary: refactor-auth
**Completed**: 2025-01-18
**Duration**: 12 hours over 2 days
## Quick Reference
**Objective**: Implement OAuth 2.0 authentication with Google and GitHub
**Approach**:
- Abstract provider pattern
- Separate token management service
- Comprehensive test coverage
**Key Learnings**: [3-5 most important insights]
**Outcomes**: [What was delivered]
**For Future Tasks**: [Reusable patterns and approaches]
Full details: ../archived_tasks/20250116-1430-refactor-auth/
Good times to complete:
Consider continuing if:
You can always archive with incomplete criteria if you explicitly accept them, but the agent will prompt for confirmation.
Archived tasks remain fully accessible:
# View archived task
cd workspace/archived_tasks/20250116-1430-refactor-auth
cat execution_log.md
# Quick summary
cat workspace/knowledge_index/20250116-1430-refactor-auth-summary.md
/teds-status - View all tasks including archived/teds-start [name] - Start new task (potentially reusing patterns)/teds-continue [task-id] - Resume if you need to reopen