@@ -23,6 +23,7 @@ You are the Coordinator Agent orchestrating specialized sub-agents to create a c
23
23
2 . ** Context Gatherer Agent** - Identifies key abstractions, workflows, and conventions
24
24
3 . ** Documentation Agent** - Extracts insights from existing docs and comments
25
25
4 . ** Testing Agent** - Analyzes test patterns and quality standards
26
+ 5 . ** Git History Analyst Agent** - Examines repository evolution and historical patterns
26
27
27
28
## Process
28
29
@@ -139,6 +140,44 @@ You are the Coordinator Agent orchestrating specialized sub-agents to create a c
139
140
- Performance budgets and benchmarks
140
141
- Documentation requirements
141
142
143
+ ### Phase 5: Git History Analysis (Git History Analyst Agent)
144
+
145
+ 1 . ** Repository Evolution**
146
+ - Initial commit and project inception
147
+ - Major milestones and version releases
148
+ - Growth patterns (files, commits, contributors)
149
+ - Technology migrations and upgrades
150
+ - Refactoring patterns and code cleanups
151
+ - Feature development timelines
152
+ - Deprecated features and removal patterns
153
+
154
+ 2 . ** Commit Patterns**
155
+ - Commit message conventions and evolution
156
+ - Commit frequency and size patterns
157
+ - Author contributions and expertise areas
158
+ - Code ownership and maintenance patterns
159
+ - Hot spots (frequently changed files)
160
+ - Stable vs volatile code areas
161
+ - Branching and merging strategies
162
+
163
+ 3 . ** Architectural Evolution**
164
+ - Major architectural changes over time
165
+ - Design pattern adoptions and removals
166
+ - Technology stack changes and reasons
167
+ - Performance optimization history
168
+ - Security improvement timeline
169
+ - Breaking changes and migration paths
170
+ - Failed experiments and lessons learned
171
+
172
+ 4 . ** Issue and Bug Patterns**
173
+ - Common bug fix patterns
174
+ - Recurring issues and solutions
175
+ - Performance problem areas
176
+ - Security vulnerability fixes
177
+ - Regression patterns
178
+ - Feature request trends
179
+ - Emergency fixes and hotfixes
180
+
142
181
## Ultrathink Reflection Phase
143
182
144
183
Synthesize all gathered information to create a comprehensive CLAUDE.md that includes ALL sections from the template. Each agent should contribute:
@@ -167,6 +206,13 @@ Synthesize all gathered information to create a comprehensive CLAUDE.md that inc
167
206
- Code review process
168
207
- Debugging tools and approaches
169
208
209
+ ** Git History Analyst Agent:**
210
+ - Historical context and evolution
211
+ - Migration paths and deprecations
212
+ - Common issues and their fixes
213
+ - Code ownership and hot spots
214
+ - Failed approaches to avoid
215
+
170
216
** Additional Considerations:**
171
217
- Quick start guide with prerequisites
172
218
- Comprehensive command reference
@@ -344,7 +390,15 @@ project/
344
390
[Detailed explanation of something that might trip up newcomers]
345
391
346
392
### Historical Decisions
347
- [Key architectural decisions and their rationale]
393
+ [Key architectural decisions and their rationale - from git history]
394
+ - [Decision]: [Context, alternatives considered, outcome]
395
+ - [Migration]: [What changed, why, and lessons learned]
396
+
397
+ ### Code Evolution Patterns
398
+ [How the codebase has evolved - from git history analysis]
399
+ - Major refactorings: [what, when, why]
400
+ - Technology migrations: [from → to, reasons]
401
+ - Deprecated patterns: [what to avoid and why]
348
402
349
403
### Performance Considerations
350
404
- [Bottleneck area]: [mitigation strategy]
@@ -392,11 +446,13 @@ project/
392
446
- Symptoms: [what you'll see]
393
447
- Cause: [root cause]
394
448
- Solution: [how to fix]
449
+ - History: [how often this occurs - from git history]
395
450
396
451
2. **[Another issue]**
397
452
- Symptoms: [description]
398
453
- Cause: [explanation]
399
454
- Solution: [fix]
455
+ - Prevention: [how to avoid - learned from history]
400
456
401
457
### Debugging Tools
402
458
- [Tool name]: [usage]
@@ -482,6 +538,11 @@ project/
482
538
### Team Contacts
483
539
[If applicable, who to contact for different areas]
484
540
541
+ ### Code Ownership
542
+ [From git history - who maintains what]
543
+ - [Component/Area]: [Primary maintainer(s)]
544
+ - [Another area]: [Expert(s) based on commit history]
545
+
485
546
## Maintenance Tasks
486
547
487
548
### Regular Maintenance
0 commit comments