enhancing clarity in research assessment and problem description sections.

some files rename
This commit is contained in:
Oleksandr Bezdieniezhnykh
2025-12-07 22:50:25 +02:00
parent e7c8e31d79
commit d5c036e6f7
72 changed files with 358 additions and 484 deletions
@@ -0,0 +1,9 @@
# Building Block: Dashboard Export to Excel
## Problem / Goal
Users need to export the dashboard data theyre currently viewing into Excel for offline analysis and sharing.
##
## Outcome
Export dashboard data functionality. Expo
@@ -1,7 +1,7 @@
# 1 Research Phase
## 1.0 Problem statement
## **🧑‍💻 Developers**: 1.0 Problem statement
### Discuss
Discuss the problem and create in the `_docs/00_problem` next files and folders:
- `problem_description.md`: Our problem to solve with the end result we want to achieve.
@@ -47,7 +47,7 @@
- Overwrite `acceptance_criteria.md` and `restrictions.md`
## 1.2 **✨AI Research**: Research the problem in great detail
## 1.2 **🤖✨AI Research**: Research the problem in great detail
### Execute `/1.research/1.2_research_problem`
In case of external DeepResearch (Gemini, DeepSeek, or other), copypaste command's text and put to the research context:
@@ -63,7 +63,7 @@
- Store it to the `_docs/01_solution/solution_draft.md`
## 1.3 **✨AI Research**: Solution draft assessment
## 1.3 **🤖✨AI Research**: Solution draft assessment
### Execute `/1.research/1.3_solution_draft_assessment`
In case of external DeepResearch (Gemini, DeepSeek, or other), copypaste command's text and put to the research context:
@@ -99,7 +99,7 @@
- Save plan to `_docs/02_components/00_decomposition_plan.md`
## 2.15 **🤖AI agent**: Components assesment
## 2.15 **🤖📋AI plan**: Components assesment
### Execute `/2.planning/2.15_components_assesment`
@@ -116,26 +116,26 @@
"url": "https://mcp.atlassian.com/v1/sse"
}
```
### Execute `/2.planning/2.20_gen_epics use jira mcp`
### Execute `/2.planning/2.20_plan_jira_epics`
### Revise
- Revise the epics, answer questions, put detailed descriptions
- Make sure epics are coherent and make sense
## 2.30 **🤖AI agent**: Generate tests
## 2.30 **🤖📋AI plan**: Generate tests
### Execute `/2.planning/2.30_gen_tests`
### Execute `/2.planning/2.30_plan_tests`
### Revise
- Revise the tests, answer questions, put detailed descriptions
- Make sure stored tests are coherent and make sense
## 2.40 **🤖📋AI agent**: Component Decomposition To Features
## 2.40 **🤖📋AI plan**: Component Decomposition To Features
### Execute
For each component in `_docs/02_components` run
`/2.planning/2.40_gen_features --component @xx__spec_[component_name].md`
`/2.planning/2.40_plan_features_decompose --component @xx__spec_[component_name].md`
### Revise
- Revise the features, answer questions, put detailed descriptions
@@ -195,19 +195,10 @@
- Read the code and check that everything is ok
## 3.20 **🤖AI agent**: Solution composition and integration tests
## 3.20 **🤖📋AI plan**: Integration tests and solution checks
Read all the files here `_docs/03_tests/` and for each file write down tests and run it.
Compose a final test results in a csv with the next format:
- Test filename
- Execution time
- Result
Fix all problems if tests failed until we got a successful result.
In case if one or more tests was failed due to missing data from user or API or other system, ask it from developer.
Repeat test cycle until no failed tests.
# 4. Refactoring phase
### Execute `/3.implementation/3.20_implement_tests`
### Revise
- Revise the plan, answer questions, put detailed descriptions
- Make sure tests are coherent and make sense
+39
View File
@@ -0,0 +1,39 @@
# Iterative Implementation phase
## 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 waht to achieve
```
### Example
`_docs/iterative/building_blocks/01-dashboard-export-example.md`
## 20. **🤖AI agent**: Generate Feature Specification
### Execute `/gen_feature_spec`
## 30. **🤖AI agent**: Generate Jira ticket
### Execute `/gen_jira_task`
## 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`
## 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`)
## 60. Build from the plan
## Check build and tests are successful.