Files
gps-denied-desktop/_docs/tutorial_iterative.md
T
Oleksandr Bezdieniezhnykh fd75243a84 more detailed SDLC plan
2025-12-10 19:05:17 +02:00

150 lines
3.8 KiB
Markdown

# Iterative Implementation Phase
## Prerequisites
### Jira MCP
Add Jira MCP to the list in IDE:
```
"Jira-MCP-Server": {
"url": "https://mcp.atlassian.com/v1/sse"
}
```
### Context7 MCP
Add context7 MCP to the list in IDE:
```
"context7": {
"command": "npx",
"args": [
"-y",
"@upstash/context7-mcp"
]
}
```
### Reference Documents
- Definition of Done: `@_docs/00_templates/definition_of_done.md`
- Quality Gates: `@_docs/00_templates/quality_gates.md`
- PR Template: `@_docs/00_templates/pr_template.md`
- Feature Dependencies: `@_docs/00_templates/feature_dependency_matrix.md`
## 10 **🧑‍💻 Developers**: Form a building block
### Form a building block in the next format:
```
# Building Block: Title
## Problem / Goal
Short description of the problem we have to solve or what the end goal we need to achieve. 2-3 lines
## Architecture Notes (optional)
How it should be implemented. Which subsystem to use, short explanation of the 3-5 lines.
## Outcome
What we want to achieve from the building block
```
### Example
`_docs/iterative/building_blocks/01-dashboard-export-example.md`
## 20. **🤖AI agent**: Generate Feature Specification
### Execute `/gen_feature_spec`
## 25. **🧑‍💻 Developer**: Check Feature Dependencies
### Verify
- Check `@_docs/00_templates/feature_dependency_matrix.md`
- Ensure all dependent features are completed or mocked
- Update dependency matrix with new feature
## 30. **🤖AI agent**: Generate Jira ticket and branch
### Execute `/gen_jira_task_and_branch`
This will:
- Create Jira task under specified epic
- Create git branch from dev (e.g., `az-122-progressive-search-system`)
## 40. **🤖📋AI plan**: Generate Plan
### Execute
generate plan for `@_docs/iterative/feature_specs/spec.md`
Example:
generate plan for `@_docs/iterative/feature_specs/01-dashboard-export-example.md`
## 45. **🧑‍💻 Developer**: Define Test Strategy
### Determine test types needed:
- [ ] Unit tests (always required)
- [ ] Integration tests (if touching external systems/DB)
- [ ] E2E tests (if user workflow changes)
### Document in plan:
- Which tests to write
- Test data requirements
- Mocking strategy
## 50. **🧑‍💻 Developer**: Save the plan
Save the generated plan to `@_docs/iterative/plans`.
(First, save with built-in mechanism to .cursor folder, then move to this folder `@_docs/iterative/plans`)
## 55. **🧑‍💻 Developer**: Review Plan Before Build
### Checklist
- [ ] Plan covers all acceptance criteria
- [ ] Test strategy defined
- [ ] Dependencies identified and available
- [ ] No architectural concerns
- [ ] Estimate seems reasonable
## 60. Build from the plan
## 65. **🤖📋AI plan**: Code Review
### Execute
Use Cursor's built-in review feature or manual review.
### Verify
- All issues addressed
- Code quality standards met
## 70. Check build and tests are successful
**User action required**: Run your project's test, lint, and coverage commands.
- [ ] All tests pass
- [ ] No linting errors
- [ ] Code coverage >= 75%
## 72. **🧑‍💻 Developer**: Run Full Verification
### Local Verification
- [ ] All unit tests pass
- [ ] All integration tests pass
- [ ] Code coverage >= 75%
- [ ] No linting errors
- [ ] Manual testing completed (if UI changes)
### Quality Gate Check
Review `@_docs/00_templates/quality_gates.md` - Iterative Gate 3
## 75. **🤖AI agent**: Create PR and Merge
### Execute `/gen_merge_and_deploy`
This will:
- Verify branch status
- Run pre-merge checks
- Update CHANGELOG
- Create PR using template
- Guide through merge process
## 78. **🧑‍💻 Developer**: Finalize
- Move Jira ticket to Done
- Verify CI pipeline passed on dev