Skip to content
Open
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
64 commits
Select commit Hold shift + click to select a range
1d75612
feat: Add initial request display feature
paulpreibisch Aug 30, 2025
83554dd
test: Add comprehensive test suite for initial request feature
paulpreibisch Aug 30, 2025
f130c14
chore: Release version 3.1.0 - Initial Request Display Feature
paulpreibisch Aug 31, 2025
87f4980
feat: Add v3.1.0 release notes with Initial Request Display feature
paulpreibisch Aug 31, 2025
96c865e
docs: Update v3.1.0 release notes with setup_project command
paulpreibisch Aug 31, 2025
bedc85c
feat: Add bulk agent assignment dropdown and no-refresh individual as…
paulpreibisch Aug 31, 2025
90bb90f
fix: Fix AI agent assignment dropdown display bug using TDD
paulpreibisch Aug 31, 2025
fa1d2c8
feat: Enhance test infrastructure and fix component tests
paulpreibisch Aug 31, 2025
96fadca
feat: Complete export feature with numbered tasks and initial request…
paulpreibisch Aug 31, 2025
ee8fdd8
fix: Resolve agent info modal blank descriptions and production tasks…
paulpreibisch Aug 31, 2025
054a0ca
docs: Update v3.1.0 release notes with latest bug fixes
paulpreibisch Aug 31, 2025
2ac09ad
feat: Add Archive feature with comprehensive testing and bug fixes
paulpreibisch Sep 1, 2025
3b4273b
feat: Release v4.0.0 - Major UI overhaul with enhanced Release Notes …
paulpreibisch Sep 2, 2025
c6e1ba6
docs: Update v4.0.0 release notes with detailed user-friendly explana…
paulpreibisch Sep 3, 2025
8cb0828
docs: Remove first-person language from v4.0.0 release notes
paulpreibisch Sep 3, 2025
5591df1
docs: Add Archive dialog screenshot to v4.0.0 release notes
paulpreibisch Sep 3, 2025
75ff7ef
feat: Update to v4.0.0 and add Archive screenshots to release notes
paulpreibisch Sep 3, 2025
fb1b8b6
feat: Add all Archive screenshots to v4.0.0 release notes
paulpreibisch Sep 3, 2025
a72360f
docs: Reorganize v4.0.0 release notes for better flow
paulpreibisch Sep 3, 2025
7d13858
fix: Update v4.0.0 release metadata to prioritize Initial Request Dis…
paulpreibisch Sep 3, 2025
5a7b481
feat: Fix critical UI navigation and terminology issues
paulpreibisch Sep 4, 2025
514035a
fix: Improve Help and Release Notes collapse functionality and scroll…
paulpreibisch Sep 4, 2025
1a60002
fix: Resolve Help page navigation issues with ID generation and scrol…
paulpreibisch Sep 4, 2025
16e6445
feat: Implement react-scroll navigation for Help and Release Notes pages
paulpreibisch Sep 4, 2025
2b9ac1d
fix: Resolve Help page navigation issues with ID generation and scrol…
paulpreibisch Sep 5, 2025
9553796
fix: Improve Help page sidebar auto-scroll functionality
paulpreibisch Sep 5, 2025
796afb6
fix: Improve Help page sidebar auto-scroll to always center active item
paulpreibisch Sep 5, 2025
d9dc96a
fix: Complete Help page sidebar auto-scroll functionality
paulpreibisch Sep 5, 2025
f23d4da
feat: Create reusable ScrollSpy library and apply to Release Notes
paulpreibisch Sep 5, 2025
e626c9c
fix: Rename useScrollSpy to .jsx extension for proper JSX parsing
paulpreibisch Sep 5, 2025
5cca69a
fix: Fix Release Notes scroll spy ID generation for proper TOC highli…
paulpreibisch Sep 5, 2025
3c5ef73
feat: Add configurable emoji button templates in project settings
paulpreibisch Sep 5, 2025
419b25d
fix: Add backend support for emoji template settings
paulpreibisch Sep 5, 2025
f12a90e
fix: Add missing async keyword for form onSubmit handler
paulpreibisch Sep 5, 2025
a444cc6
fix: Prevent custom emoji templates from being overwritten
paulpreibisch Sep 5, 2025
c8ffce2
feat: Add comprehensive MCP Archive and History Tools system
paulpreibisch Sep 6, 2025
bf61cc0
docs: Update v4.0.0 release notes with comprehensive MCP Archive and …
paulpreibisch Sep 6, 2025
ac72773
docs: Add comprehensive task completion details storage implementatio…
paulpreibisch Sep 6, 2025
9539588
docs: Clarify task completion details vs OpenAI summary distinction i…
paulpreibisch Sep 6, 2025
34f1340
refactor: Remove temporary notes-based rich completion workaround system
paulpreibisch Sep 6, 2025
b8087f7
docs: Update implementation plan to focus on Markdown rendering solution
paulpreibisch Sep 6, 2025
e6ac426
feat: Add TaskSummary component and optimize TaskDetailView performance
paulpreibisch Sep 6, 2025
f7f1921
feat: Add Task Completion Summary Storage System (v4.1.0)
paulpreibisch Sep 6, 2025
887bac2
fix: Update version numbers to 4.1.0 and enhance release notes
paulpreibisch Sep 6, 2025
cf97c61
fix: Fix bash code block formatting in v4.1.0 release notes
paulpreibisch Sep 6, 2025
cd1555b
feat: Update MCP prompt templates and add CompletionAnalytics component
paulpreibisch Sep 6, 2025
43699d4
docs: Update v4.1.0 release notes with TaskTable summary preview colu…
paulpreibisch Sep 6, 2025
876958d
docs: Remove confusing Template Processing System section from v4.0.0…
paulpreibisch Sep 6, 2025
8f304ad
docs: Reorganize v4.0.0 release notes - improve MCP Tools section
paulpreibisch Sep 6, 2025
2a122e0
docs: Add task completion details screenshot to v4.1.0 release notes
paulpreibisch Sep 6, 2025
4f13cf1
docs: Remove broken image reference from v4.1.0 release notes
paulpreibisch Sep 6, 2025
a212f9c
docs: Add task completion details screenshot to v4.1.0 release notes
paulpreibisch Sep 6, 2025
dc34c7f
feat: Make .claude agents directory trackable and visible to Claude Code
paulpreibisch Sep 6, 2025
cf0447a
feat: Add complete translation support from PR #96
paulpreibisch Sep 6, 2025
42d2890
refactor: Change terminology from 'profile' to 'project' throughout a…
paulpreibisch Sep 6, 2025
527b799
feat: Adjust task table column widths for better usability
paulpreibisch Sep 7, 2025
078a97a
feat: Add release notes image support and fix lightbox crashes
paulpreibisch Sep 7, 2025
195079b
feat: Add bulk mark as completed functionality
paulpreibisch Sep 7, 2025
a9822a6
Update README with v4.1.0 and v4.0.0 release notes and new screenshot
paulpreibisch Sep 7, 2025
a4158cd
Fix all failing tests and improve test stability
paulpreibisch Sep 7, 2025
f21e340
feat: Add comprehensive internationalization support with translations
paulpreibisch Sep 7, 2025
78505a1
feat: Complete internationalization with all release note translations
paulpreibisch Sep 8, 2025
bc1d746
Update issue templates
paulpreibisch Sep 9, 2025
68209a3
Create FUNDING.yml
paulpreibisch Sep 9, 2025
File filter

Filter by extension

Filter by extension


Conversations
Failed to load comments.
Loading
Jump to
The table of contents is too big for display.
Diff view
Diff view
  •  
  •  
  •  
15 changes: 15 additions & 0 deletions .github/FUNDING.yml
Original file line number Diff line number Diff line change
@@ -0,0 +1,15 @@
# These are supported funding model platforms

github: # Replace with up to 4 GitHub Sponsors-enabled usernames e.g., [user1, user2]
patreon: # Replace with a single Patreon username
open_collective: # Replace with a single Open Collective username
ko_fi: # Replace with a single Ko-fi username
tidelift: # Replace with a single Tidelift platform-name/package-name e.g., npm/babel
community_bridge: # Replace with a single Community Bridge project-name e.g., cloud-foundry
liberapay: # Replace with a single Liberapay username
issuehunt: # Replace with a single IssueHunt username
lfx_crowdfunding: # Replace with a single LFX Crowdfunding project-name e.g., cloud-foundry
polar: # Replace with a single Polar username
buy_me_a_coffee: paulpreibisch
thanks_dev: # Replace with a single thanks.dev username
custom: # Replace with up to 4 custom sponsorship URLs e.g., ['link1', 'link2']
38 changes: 38 additions & 0 deletions .github/ISSUE_TEMPLATE/bug_report.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,38 @@
---
name: Bug report
about: Create a report to help us improve
title: ''
labels: ''
assignees: ''

---

**Describe the bug**
A clear and concise description of what the bug is.

**To Reproduce**
Steps to reproduce the behavior:
1. Go to '...'
2. Click on '....'
3. Scroll down to '....'
4. See error

**Expected behavior**
A clear and concise description of what you expected to happen.

**Screenshots**
If applicable, add screenshots to help explain your problem.

**Desktop (please complete the following information):**
- OS: [e.g. iOS]
- Browser [e.g. chrome, safari]
- Version [e.g. 22]

**Smartphone (please complete the following information):**
- Device: [e.g. iPhone6]
- OS: [e.g. iOS8.1]
- Browser [e.g. stock browser, safari]
- Version [e.g. 22]

**Additional context**
Add any other context about the problem here.
20 changes: 20 additions & 0 deletions .github/ISSUE_TEMPLATE/feature_request.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,20 @@
---
name: Feature request
about: Suggest an idea for this project
title: ''
labels: ''
assignees: ''

---

**Is your feature request related to a problem? Please describe.**
A clear and concise description of what the problem is. Ex. I'm always frustrated when [...]

**Describe the solution you'd like**
A clear and concise description of what you want to happen.

**Describe alternatives you've considered**
A clear and concise description of any alternative solutions or features you've considered.

**Additional context**
Add any other context or screenshots about the feature request here.
7 changes: 6 additions & 1 deletion .gitignore
Original file line number Diff line number Diff line change
Expand Up @@ -58,7 +58,6 @@ data/*
.cursor/tmp/

# Claude and MCP files
.claude/
.mcp.json

# Audio files
Expand All @@ -70,3 +69,9 @@ Screenshots/

# Task viewer history and agents
tools/task-viewer/history-and-agents/

# Snagit files
*.snagx

# Claude configuration
.claude/
6 changes: 6 additions & 0 deletions .vscode/settings.json
Original file line number Diff line number Diff line change
@@ -0,0 +1,6 @@
{
"explorer.excludeGitIgnore": false,
"files.exclude": {
"**/*.snagx": true
}
}
52 changes: 52 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,6 +4,31 @@

> 🦐 **Intelligent task management for AI-powered development** - Break down complex projects into manageable tasks, maintain context across sessions, and accelerate your development workflow.

## 📢 Latest Release - Version 4.1.0 (September 6, 2025)

**🎯 Enhanced Task Completion & UI Improvements!**

Version 4.1.0 introduces **structured task completion details** and **improved TaskTable UI** with summary preview functionality. Key highlights:

- **📊 New Task Completion Details**: Structured data model for comprehensive task completion information
- **🔍 Intelligent Summary Parser**: Advanced Markdown parser that extracts structured data from completion summaries
- **📋 TaskTable Summary Preview**: Quick task overview with expandable summaries and optimized mobile design
- **🎨 Enhanced Completion Display**: Rich visual presentation with organized sections and verification scores

[📖 Full 4.1.0 Release Notes](tools/task-viewer/releases/v4.1.0.md)

### Major Features from Version 4.0.0 (September 3, 2025)

**🚀 Archive Management System** - Revolutionary task list archiving with complete context preservation

**💡 Initial Request Display** - Permanently stores the original user request that initiated task planning

**📚 Enhanced Release Notes** - Interactive experience with collapsible Table of Contents

**🤖 7 New MCP Tools** - Complete programmatic access to archive and history functionality

[📖 Full 4.0.0 Release Notes](tools/task-viewer/releases/v4.0.0.md)

<div align="center">

[![Shrimp Task Manager Demo](docs/yt.png)](https://www.youtube.com/watch?v=Arzu0lV09so)
Expand Down Expand Up @@ -143,6 +168,8 @@ Shrimp Task Manager is an MCP (Model Context Protocol) server that transforms ho
- **🤖 Agent System**: Assign specialized AI agents to specific tasks ([Learn more](docs/agents.md))
- **📏 Project Rules**: Define and maintain coding standards across your project
- **💾 Task Memory**: Automatic backup and restoration of task history
- **📚 Archive Management**: Store and restore complete task lists with full context preservation
- **💡 Initial Request Tracking**: Permanently capture the original context behind task creation

### Web Interfaces

Expand Down Expand Up @@ -212,6 +239,24 @@ Agent: "plan task: migrate component to chosen framework"
```
</details>

<details>
<summary><b>Archive Management</b></summary>

```
Agent: "plan task: implement user dashboard with analytics"
# Agent creates comprehensive task list

Agent: "create archive Dashboard_Implementation"
# Archive tasks for later when priorities change

Agent: "plan task: fix critical security vulnerability"
# Work on urgent issue first

Agent: "restore from archive Dashboard_Implementation"
# Resume dashboard work with full context preserved
```
</details>

## 🛠️ Configuration

### Environment Variables
Expand Down Expand Up @@ -239,6 +284,10 @@ PROMPT_LANGUAGE=en # Prompt language (en, zh, etc.)
| `list tasks` | Show all tasks |
| `research [topic]` | Enter research mode |
| `reflect task [id]` | Review and improve task |
| `create archive [name]` | Create backup archive of tasks |
| `restore from archive [id]` | Restore tasks from archive |
| `get deleted tasks` | View history of deleted tasks |
| `recover task [id]` | Restore previously deleted task |

## 🤝 Contributing

Expand All @@ -252,6 +301,9 @@ This project is licensed under the MIT License - see the [LICENSE](LICENSE) file

Created by [cjo4m06](https://github.com/cjo4m06) and maintained by the community.

**Special Thanks:**
- [Paul Pribisch](https://github.com/paulpreibisch) - Creator of the Shrimp Task Manager Viewer interface

---

<p align="center">
Expand Down
123 changes: 123 additions & 0 deletions claude/agents/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,123 @@
# Claude Subagents for Shrimp Task Manager

This directory contains specialized subagents designed to enhance the Shrimp Task Manager project following Anthropic's best practices for agent-based development.

## Philosophy

Based on Anthropic's best practices, these agents are designed to:
- **Preserve context** by delegating specific verification and analysis tasks
- **Add verification layers** to ensure implementation quality
- **Enable multiple perspectives** on code and task completion
- **Prevent overfitting** by having independent agents verify implementations

## Available Agents

### 🔍 Task Analyzer (`task-analyzer.md`)
Decomposes complex tasks into manageable subtasks while maintaining context and dependencies.
- **Use when**: Starting new features, dealing with complex requirements
- **Integrates with**: `analyze_task`, `split_tasks`, `plan_task` tools

### 👁️ Code Reviewer (`code-reviewer.md`)
Independent verification of code implementations for quality and correctness.
- **Use when**: After implementing code, before marking tasks complete
- **Integrates with**: `verify_task`, `reflect_task` tools

### ✅ Test Validator (`test-validator.md`)
Ensures comprehensive test coverage and prevents overfitting to test cases.
- **Use when**: After writing tests, verifying coverage
- **Key feature**: Detects when code is overfitting to specific tests

### 🔗 Dependency Resolver (`dependency-resolver.md`)
Manages task dependencies and optimizes execution order.
- **Use when**: Planning multi-task projects, resolving blockers
- **Integrates with**: Task dependency system, blocking status

### 🎯 Implementation Verifier (`implementation-verifier.md`)
End-to-end verification that implementations meet all requirements.
- **Use when**: Final validation before task completion
- **Integrates with**: verificationCriteria, acceptance testing

### 🔌 MCP Integration (`mcp-integration.md`)
Specialized for MCP server development and tool creation.
- **Use when**: Creating MCP tools, debugging integrations
- **Integrates with**: MCP SDK, tool schemas, Claude clients

## Usage Patterns

### Sequential Verification
```
1. task-analyzer → break down the problem
2. (implement code)
3. code-reviewer → review implementation
4. test-validator → verify test coverage
5. implementation-verifier → final validation
```

### Parallel Analysis
```
Launch multiple agents concurrently:
- code-reviewer: check code quality
- test-validator: verify test coverage
- dependency-resolver: check for conflicts
```

### Iterative Improvement
```
1. code-reviewer → identify issues
2. (fix issues)
3. test-validator → ensure tests still pass
4. implementation-verifier → confirm requirements met
```

## Best Practices

1. **Use agents early** in the development process for complex tasks
2. **Leverage multiple perspectives** by using different agents for verification
3. **Prevent overfitting** by having test-validator check implementations
4. **Maintain independence** between implementation and verification agents
5. **Batch agent calls** when possible for efficiency

## Integration with Shrimp Task Manager

These agents are specifically designed to work with:
- Task status management (PENDING, IN_PROGRESS, COMPLETED, BLOCKED)
- Task complexity assessment (LOW, MEDIUM, HIGH, VERY_HIGH)
- Verification criteria and implementation guides
- The chain-of-thought and reflection system
- MCP tool development and integration

## Example Workflow

```bash
# Complex feature request arrives
Use task-analyzer to break it down into subtasks

# For each subtask
Use dependency-resolver to determine order

# After implementation
Use code-reviewer for quality check
Use test-validator to verify coverage

# Before marking complete
Use implementation-verifier for final validation

# For MCP-specific work
Use mcp-integration for protocol compliance
```

## Adding New Agents

When creating new agents, follow this template:
1. Clear purpose statement
2. Specific capabilities
3. When to use guidelines
4. Integration points with existing tools
5. Expected outputs
6. Example prompts

Each agent should be:
- **Focused**: Single responsibility principle
- **Independent**: Can work without other agents
- **Verifiable**: Clear success criteria
- **Integrated**: Works with existing Shrimp tools
69 changes: 69 additions & 0 deletions claude/agents/code-reviewer.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,69 @@
# Code Reviewer Agent

## Purpose
Independent verification agent that reviews code implementations for quality, correctness, and adherence to project standards.

## Capabilities
- Code quality assessment and style consistency checks
- Identification of potential bugs and edge cases
- Security vulnerability detection
- Performance optimization suggestions
- Best practices compliance verification
- TypeScript type safety validation

## When to Use
- After completing any code implementation
- Before marking a task as completed
- When refactoring existing code
- During code review of pull requests
- To verify implementation matches task requirements

## Usage Instructions
```
Use the code-reviewer agent to:
1. Review the implementation in [file paths]
2. Check for compliance with project standards
3. Identify potential issues or improvements
4. Verify the code meets task requirements
```

## Key Responsibilities
1. **Quality Assurance**: Ensure code meets quality standards
2. **Bug Detection**: Identify logical errors and edge cases
3. **Style Consistency**: Verify adherence to project conventions
4. **Security Review**: Check for common security issues
5. **Performance Analysis**: Suggest optimizations where applicable

## Integration with Shrimp Task Manager
This agent enhances task verification by:
- Working with `verify_task` tool to validate implementations
- Providing feedback for `reflect_task` iterations
- Supporting `update_task` with improvement suggestions
- Ensuring completed tasks meet verificationCriteria

## Review Checklist
- [ ] Code follows project style guidelines
- [ ] TypeScript types are properly defined
- [ ] Error handling is comprehensive
- [ ] Edge cases are handled
- [ ] No hardcoded values or magic numbers
- [ ] Functions are properly documented
- [ ] Tests cover the implementation
- [ ] No security vulnerabilities introduced
- [ ] Performance is acceptable

## Expected Output
- List of issues found (if any)
- Suggestions for improvements
- Confirmation of requirements met
- Risk assessment for the changes
- Recommended next steps

## Example Prompt
```
Please use the code-reviewer agent to review the implementation of the task management functions in src/tools/task/*.ts. Focus on:
1. TypeScript type safety
2. Error handling completeness
3. Consistency with existing patterns
4. Potential performance issues
```
Loading