organize structure for .roo and for ai in general

rework rulels
2026-04-22 15:26:36 +00:00 · 2025-12-10 19:59:13 +02:00
parent 749c8e674d
commit 8a284eb106
84 changed files with 3044 additions and 35 deletions
@@ -0,0 +1,149 @@
+# 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