|
25 | 25 | - Extract key entities, relationships, and access patterns from the artifacts without making any design assumptions |
26 | 26 | - Identify current MySQL schema structure, constraints, and performance characteristics from table structure analysis |
27 | 27 | - Document any existing bottlenecks or performance issues from the MySQL log analysis |
28 | | - - **COMMIT**: Commit artifact analysis with message "Analyze stage-01 artifacts for DynamoDB modeling context" |
| 28 | + - **COMMIT**: Commit artifact analysis with message "stage-02-a task 1.1: Analyze stage-01 artifacts for DynamoDB modeling context" |
29 | 29 | - **MARK COMPLETE**: Update this task to [x] and commit the tasks.md change |
30 | 30 | - _Requirements: 1.1_ |
31 | 31 |
|
|
37 | 37 | - **STEP 4**: Work with user to estimate RPS based on business context if not available from performance analysis |
38 | 38 | - **STEP 5**: ONLY AFTER all information is gathered, create comprehensive access patterns analysis table with Pattern #, Description, RPS (Peak/Average), Type, Attributes, Key Requirements, and Design Considerations |
39 | 39 | - **IMPORTANT**: Do not create any files until user has provided all RPS estimates and confirmed pattern completeness |
40 | | - - **COMMIT**: Commit access pattern requirements with message "Document complete access patterns with RPS estimates" |
| 40 | + - **COMMIT**: Commit access pattern requirements with message "stage-02-a task 1.2: Document complete access patterns with RPS estimates" |
41 | 41 | - **MARK COMPLETE**: Update this task to [x] and commit the tasks.md change |
42 | 42 | - _Requirements: 1.2, 1.3_ |
43 | 43 |
|
|
51 | 51 | - **USER CONFIRMATION GATE**: Ask user "Do these access patterns and requirements look complete? Are there any other patterns we should consider?" |
52 | 52 | - Do not proceed until user explicitly confirms all patterns are captured |
53 | 53 | - **IMPORTANT**: Do not create any intermediate context document - proceed directly to MCP server interaction in task 2.1 |
54 | | - - **COMMIT**: Commit requirements validation with message "Validate complete access pattern requirements with user" |
| 54 | + - **COMMIT**: Commit requirements validation with message "stage-02-a task 1.3: Validate complete access pattern requirements with user" |
55 | 55 | - **MARK COMPLETE**: Update this task to [x] and commit the tasks.md change |
56 | 56 | - _Requirements: 1.4, 1.5_ |
57 | 57 |
|
|
70 | 70 | - Log analysis as SUPPLEMENTAL performance data (where available) - This provides performance context |
71 | 71 | - **IMPORTANT**: Execute each step of the MCP server's workflow in sequence, using the prepared context to fulfill each specific requirement |
72 | 72 | - **IMPORTANT**: Ensure any files created are placed in the `artifacts/stage-02/` folder as specified by MCP server prompt |
| 73 | + - **STEP 4 - MANDATORY ACCESS PATTERN VALIDATION**: After completing the MCP server workflow, perform explicit validation: |
| 74 | + - **CRITICAL**: Read the access patterns file created in task 1.2 (likely named `access_patterns_with_rps.md` or similar) |
| 75 | + - **CRITICAL**: For EACH access pattern listed in that file, verify it is explicitly addressed in the MCP-generated artifacts |
| 76 | + - **VALIDATION FORMAT**: Create a checklist showing: |
| 77 | + - Pattern #1: [Pattern Name] - ✓ Addressed in [Table Name/GSI] OR ✗ MISSING |
| 78 | + - Pattern #2: [Pattern Name] - ✓ Addressed in [Table Name/GSI] OR ✗ MISSING |
| 79 | + - Continue for ALL patterns |
| 80 | + - **CRITICAL**: If ANY patterns are marked as MISSING, immediately update the MCP-generated artifacts to include them |
| 81 | + - **CRITICAL**: Do not proceed until ALL access patterns from the requirements file are explicitly addressed |
73 | 82 | - **EXPECTED OUTCOME**: The MCP server prompt will likely request comprehensive DynamoDB design documentation including table designs, access pattern mapping, cost analysis, and migration considerations |
74 | | - - **COMMIT**: Commit complete MCP design analysis with message "Generate comprehensive DynamoDB design using MCP server prompt and prepared context" |
| 83 | + - **COMMIT**: Commit complete MCP design analysis with message "stage-02-a task 2.1: Generate comprehensive DynamoDB design using MCP server prompt and prepared context" |
75 | 84 | - **MARK COMPLETE**: Update this task to [x] and commit the tasks.md change |
76 | 85 | - _Requirements: 2.1, 2.2, 2.3, 2.4, 2.5, 3.1_ |
77 | 86 |
|
|
83 | 92 | - Validate that all MySQL entities are properly mapped to DynamoDB structures |
84 | 93 | - Verify that the MCP server's design approach is well-justified and addresses all requirements |
85 | 94 | - If any sections are missing or incomplete, request MCP server to regenerate the file |
86 | | - - **COMMIT**: Commit design validation with message "Validate MCP-generated dynamodb_data_model.md file completeness" |
| 95 | + - **COMMIT**: Commit design validation with message "stage-02-a task 3.1: Validate MCP-generated dynamodb_data_model.md file completeness" |
87 | 96 | - **MARK COMPLETE**: Update this task to [x] and commit the tasks.md change |
88 | 97 | - _Requirements: 3.2, 3.3_ |
89 | 98 |
|
|
100 | 109 | - **USER VALIDATION PER TABLE**: Ask user "Does this table design make sense? Do you understand why we're combining/splitting these MySQL tables this way?" |
101 | 110 | - **CRITICAL**: Do not proceed to next table until user confirms understanding of current table |
102 | 111 | - Document any user concerns or requested modifications for each table |
103 | | - - **COMMIT**: Commit table-by-table validation with message "Complete table-by-table design validation with user" |
| 112 | + - **COMMIT**: Commit table-by-table validation with message "stage-02-a task 3.2: Complete table-by-table design validation with user" |
104 | 113 | - **MARK COMPLETE**: Update this task to [x] and commit the tasks.md change |
105 | 114 | - _Requirements: 3.4, 3.5_ |
106 | 115 |
|
|
112 | 121 | - Make any necessary adjustments to the document based on validation findings and user concerns |
113 | 122 | - **USER CONFIRMATION GATE**: Ask user "After reviewing each table individually, does the complete design approach look good?" |
114 | 123 | - Do not proceed until user explicitly approves the overall design approach |
115 | | - - **COMMIT**: Commit finalized data model with message "Finalize MCP-generated DynamoDB data model with table-by-table validation" |
| 124 | + - **COMMIT**: Commit finalized data model with message "stage-02-a task 3.3: Finalize MCP-generated DynamoDB data model with table-by-table validation" |
116 | 125 | - **MARK COMPLETE**: Update this task to [x] and commit the tasks.md change |
117 | 126 | - _Requirements: 3.4, 3.5_ |
118 | 127 |
|
|
125 | 134 | - For denormalized attributes: MUST include denormalized=true, justification, and join object with local_column and source_column |
126 | 135 | - Implement proper unique constraint handling patterns with lookup tables as specified in the data model |
127 | 136 | - Map all table designs and access patterns from the data model document to the JSON contract format |
128 | | - - **COMMIT**: Commit migration contract generation with message "Generate migration contract from finalized data model" |
| 137 | + - **COMMIT**: Commit migration contract generation with message "stage-02-a task 4.1: Generate migration contract from finalized data model" |
129 | 138 | - **MARK COMPLETE**: Update this task to [x] and commit the tasks.md change |
130 | 139 | - _Requirements: 4.1, 4.2, 4.3_ |
131 | 140 |
|
|
137 | 146 | - Check that unique constraint handling is properly implemented with TransactWriteItems patterns |
138 | 147 | - **USER CONFIRMATION GATE**: Ask user "Does this migration contract look complete and accurate? Are all the mappings correct?" |
139 | 148 | - Do not proceed until user explicitly validates the migration contract |
140 | | - - **COMMIT**: Commit contract validation with message "Validate migration contract completeness and accuracy" |
| 149 | + - **COMMIT**: Commit contract validation with message "stage-02-a task 4.2: Validate migration contract completeness and accuracy" |
141 | 150 | - **MARK COMPLETE**: Update this task to [x] and commit the tasks.md change |
142 | 151 | - _Requirements: 4.4, 4.5_ |
143 | 152 |
|
|
148 | 157 | - Document any deviations from MCP server recommendations and reasons |
149 | 158 | - Create troubleshooting guide for common issues identified during analysis |
150 | 159 | - Include recommendations for monitoring and operational considerations |
151 | | - - **COMMIT**: Commit documentation summary with message "Create comprehensive documentation summary" |
| 160 | + - **COMMIT**: Commit documentation summary with message "stage-02-a task 5.1: Create comprehensive documentation summary" |
152 | 161 | - **MARK COMPLETE**: Update this task to [x] and commit the tasks.md change |
153 | 162 | - _Requirements: 5.1_ |
154 | 163 |
|
|
158 | 167 | - Verify that all design decisions are documented with trade-offs and rollback strategies |
159 | 168 | - Validate that outputs provide sufficient information for stage 04 DynamoDB implementation |
160 | 169 | - Confirm user has approved all major design decisions and migration contract |
161 | | - - **COMMIT**: Commit final validation with message "Complete DynamoDB data modeling with MCP server assistance" |
| 170 | + - **COMMIT**: Commit final validation with message "stage-02-a task 5.2: Complete DynamoDB data modeling with MCP server assistance" |
162 | 171 | - **MARK COMPLETE**: Update this task to [x] and commit the tasks.md change |
163 | 172 | - _Requirements: 5.2_ |
164 | 173 |
|
|
0 commit comments