# 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