went through 4 iterations of solution draft. Right now it is more or less consistent and reliable

This commit is contained in:
Oleksandr Bezdieniezhnykh
2025-11-10 20:26:40 +02:00
parent 044a90b96f
commit e87c33b0ee
21 changed files with 2323 additions and 2055 deletions
+17
View File
@@ -0,0 +1,17 @@
# decompose
Decompose the `@docs/01_solution/solution.md` to the components.
Store description of each component to the file `docs/02_components/[##]_[component_name]/spec.md` with the next structure:
- Component Name
- Detailed description
- API methods, for each method:
- Name
- Input
- Output
- Description
- Test cases for the method
- Integration tests for the component if needed.
- Non-functional tests for the component if needed.
Generate draw.io components diagram shows relations between components.
Do not put any code yet, only names, input and output. Ask as many questions as possible to clarify all uncertainties.
+8
View File
@@ -0,0 +1,8 @@
# generate Jira Epics
Read the solution spec `@docs/01_solution/solution.md`
Read description of all the components in the folder `@docs/02_components` - go to each folder and read /[component_name]/spec.md
Read the acceptance criteria from `@docs/00_initial/acceptance_criteria.md`
- Generate Jira Epics from the Components
- Ensure each epic has clear goal and acceptance criteria, verify it with acceptance criteria
- Generate draw.io components diagram based on previous diagram shows relations between components and Jira Epic numbers corresponding to each component.
+14
View File
@@ -0,0 +1,14 @@
# generate Tests
Read the `@docs/01_solution/solution.md` and `@docs/00_problem/acceptance_criteria.md` and compose tests according to test strategy to cover all the criteria and store them to the files
`docs/03_tests/[##]_[test_name]_spec.md` with the next structure for each test file:
- Summary
- Detailed description
- Preconditions for tests
- Steps:
- Step1 - Expected result1
- Step2 - Expected result2
...
- StepN - Expected resultN
Do not put any code yet. Ask as many questions as needed.