gps-denied-onboard/_docs/tutorial_iterative.md

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