bmad-method 4.27.2 → 4.27.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/zoo/docs/brief.md DELETED
@@ -1,253 +0,0 @@
1
- # Project Brief: Terminal Todo App
2
-
3
- ## Project Overview
4
-
5
- **Project Name:** TermTodo
6
- **Version:** 1.0
7
- **Date:** 2025-07-07
8
- **Status:** Planning Phase
9
-
10
- ### Executive Summary
11
-
12
- TermTodo is a lightweight, fast, and efficient terminal-based todo application designed for developers and power users who live in the command line. The application prioritizes speed, simplicity, and seamless integration with existing terminal workflows while providing robust task management capabilities.
13
-
14
- ### Vision Statement
15
-
16
- To create the most efficient terminal todo app that enhances developer productivity by eliminating context switching between GUI applications and the command line environment.
17
-
18
- ## Problem Statement
19
-
20
- ### Current Pain Points
21
-
22
- - **Context Switching:** Developers lose focus switching between terminal and GUI todo apps
23
- - **Bloated Solutions:** Existing todo apps are feature-heavy and slow to load
24
- - **Poor CLI Integration:** Most todo apps don't integrate well with terminal workflows
25
- - **Sync Overhead:** Cloud-based solutions add unnecessary complexity for local task management
26
-
27
- ### Target Opportunity
28
-
29
- Create a fast, local-first todo application that feels native to terminal users while providing essential productivity features without bloat.
30
-
31
- ## Objectives & Success Metrics
32
-
33
- ### Primary Objectives
34
-
35
- 1. **Speed:** App launches and executes commands in <100ms
36
- 2. **Simplicity:** Core functionality accessible through intuitive commands
37
- 3. **Integration:** Seamless workflow integration with git, editors, and shell scripts
38
- 4. **Reliability:** Zero data loss with robust local storage
39
-
40
- ### Success Metrics
41
-
42
- - **Performance:** Sub-100ms command execution time
43
- - **Adoption:** 1000+ GitHub stars within 6 months
44
- - **Usage:** Daily active usage by 100+ developers
45
- - **Satisfaction:** 90%+ positive feedback on usability
46
-
47
- ## Target Audience
48
-
49
- ### Primary Users
50
-
51
- **Developer Power Users**
52
-
53
- - Daily terminal users
54
- - Prefer keyboard-driven workflows
55
- - Value speed and efficiency over visual polish
56
- - Work with multiple projects simultaneously
57
-
58
- **System Administrators**
59
-
60
- - Manage multiple servers and tasks
61
- - Need quick task tracking between systems
62
- - Prefer scriptable/automatable solutions
63
-
64
- ### User Personas
65
-
66
- **"Terminal Tom" - Senior Developer**
67
-
68
- - 8+ years experience
69
- - Uses vim/emacs, tmux, custom shell setups
70
- - Manages 3-5 projects simultaneously
71
- - Values minimalism and efficiency
72
-
73
- **"DevOps Dana" - Infrastructure Engineer**
74
-
75
- - Manages CI/CD pipelines
76
- - Juggles multiple environments
77
- - Needs quick task capture during incidents
78
- - Prefers automation-friendly tools
79
-
80
- ## Scope & Features
81
-
82
- ### Core Features (MVP)
83
-
84
- 1. **Basic Task Management**
85
-
86
- - Add, edit, delete tasks
87
- - Mark tasks as complete
88
- - List tasks with filtering
89
-
90
- 2. **Organization**
91
-
92
- - Project-based task grouping
93
- - Priority levels (high, medium, low)
94
- - Due date support
95
-
96
- 3. **Search & Filter**
97
- - Text search across tasks
98
- - Filter by status, priority, project
99
- - Tag-based organization
100
-
101
- ### Advanced Features (v2.0+)
102
-
103
- 1. **Workflow Integration**
104
-
105
- - Git branch integration
106
- - Editor plugin support
107
- - Shell completion
108
-
109
- 2. **Automation**
110
-
111
- - Recurring tasks
112
- - Template tasks
113
- - Bulk operations
114
-
115
- 3. **Reporting**
116
- - Productivity metrics
117
- - Time tracking
118
- - Export capabilities
119
-
120
- ### Out of Scope
121
-
122
- - Web interface
123
- - Mobile applications
124
- - Cloud synchronization
125
- - Collaborative features
126
- - Complex project management
127
-
128
- ## Technical Requirements
129
-
130
- ### Technology Stack
131
-
132
- - **Language:** Rust (performance, single binary distribution)
133
- - **CLI Framework:** Clap (argument parsing)
134
- - **Storage:** SQLite (local, reliable, queryable)
135
- - **Configuration:** TOML files
136
-
137
- ### Performance Requirements
138
-
139
- - **Startup Time:** <50ms cold start
140
- - **Command Execution:** <100ms for all operations
141
- - **Memory Usage:** <10MB resident memory
142
- - **Storage:** Efficient SQLite schema design
143
-
144
- ### Platform Support
145
-
146
- - **Primary:** Linux, macOS
147
- - **Secondary:** Windows (WSL)
148
- - **Distribution:** Single binary, package managers
149
-
150
- ## Implementation Strategy
151
-
152
- ### Development Phases
153
-
154
- **Phase 1: Core MVP (4 weeks)**
155
-
156
- - Basic CRUD operations
157
- - SQLite storage layer
158
- - Command-line interface
159
- - Unit test coverage
160
-
161
- **Phase 2: Organization (3 weeks)**
162
-
163
- - Project grouping
164
- - Priority and due dates
165
- - Search and filtering
166
- - Integration testing
167
-
168
- **Phase 3: Polish (2 weeks)**
169
-
170
- - Shell completion
171
- - Configuration management
172
- - Documentation
173
- - Performance optimization
174
-
175
- ### Risk Mitigation
176
-
177
- - **Technical Risk:** Rust learning curve → Start with simple CLI, iterate
178
- - **Market Risk:** Existing solutions → Focus on speed and terminal integration
179
- - **Adoption Risk:** Discoverability → Leverage dev community, GitHub
180
-
181
- ## Timeline & Milestones
182
-
183
- ### Key Milestones
184
-
185
- | Phase | Deliverable | Timeline | Success Criteria |
186
- | ----- | ---------------- | -------- | ------------------------------ |
187
- | 1 | MVP Release | Week 4 | Core features functional |
188
- | 2 | Beta Release | Week 7 | Organization features complete |
189
- | 3 | v1.0 Release | Week 9 | Production ready |
190
- | 4 | Community Growth | Week 20 | 1000+ GitHub stars |
191
-
192
- ### Critical Path
193
-
194
- 1. SQLite schema design
195
- 2. Core command structure
196
- 3. Performance optimization
197
- 4. Documentation and examples
198
-
199
- ## Team & Stakeholders
200
-
201
- ### Core Team
202
-
203
- **Solo Developer** (Primary)
204
-
205
- - Full-stack development
206
- - Design and architecture
207
- - Testing and documentation
208
-
209
- ### Advisory Stakeholders
210
-
211
- - **Developer Community:** Feedback and feature requests
212
- - **Beta Users:** Early testing and validation
213
- - **Open Source Community:** Contributions and maintenance
214
-
215
- ## Budget & Resources
216
-
217
- ### Development Resources
218
-
219
- - **Time Investment:** 20 hours/week for 9 weeks
220
- - **Infrastructure:** GitHub (free), domain name ($15/year)
221
- - **Tools:** Development environment, testing tools
222
-
223
- ### Total Investment
224
-
225
- - **Development Time:** ~180 hours
226
- - **Direct Costs:** <$50
227
- - **Opportunity Cost:** Personal projects, learning time
228
-
229
- ## Success Factors
230
-
231
- ### Critical Success Factors
232
-
233
- 1. **Performance First:** Every feature decision evaluated for speed impact
234
- 2. **Developer Experience:** Intuitive commands that feel natural
235
- 3. **Terminal Native:** Feels like a built-in shell command
236
- 4. **Community Building:** Engage early adopters for feedback
237
-
238
- ### Potential Risks
239
-
240
- - **Over-engineering:** Feature creep beyond core use cases
241
- - **Performance Degradation:** Complex features slowing core operations
242
- - **Adoption Challenges:** Difficulty reaching target developers
243
-
244
- ## Next Steps
245
-
246
- 1. **Technical Spike:** Rust CLI framework evaluation (Week 1)
247
- 2. **Database Design:** SQLite schema and migration strategy
248
- 3. **Core Architecture:** Command structure and data flow
249
- 4. **MVP Development:** Begin core feature implementation
250
-
251
- ---
252
-
253
- _This project brief will be reviewed and updated at each milestone to ensure alignment with objectives and market feedback._