name components correctly

update tutorial with 3. implementation phase
add implementation commands
This commit is contained in:
Oleksandr Bezdieniezhnykh
2025-12-01 12:56:43 +02:00
parent 54be35fde7
commit 66360d255e
34 changed files with 340 additions and 648 deletions
+38 -16
View File
@@ -1,5 +1,6 @@
# 1 Research Phase
## 1.0 Problem statement
### Discuss
Discuss the problem and create in the `docs/00_problem` next files and folders:
@@ -85,6 +86,7 @@
# 2. Planning phase
## 2.10 **🤖📋AI plan**: Generate components
### Execute `/2.planning/2.10_gen_components`
@@ -104,17 +106,18 @@
### Revise
- Clarify the proposals and ask to fix found issues
## 2.20 **🤖AI agent**: Generate Jira Epics
### Add Jira MCP to IDE and authenticate
### Jira MCP
Add Jira MCP to the list in IDE:
```
"Jira-MCP-Server": {
"url": "https://mcp.atlassian.com/v1/sse"
}
```
### Execute `/2.planning/2.20_gen_epics use jira mcp`
### Revise
- Revise the epics, answer questions, put detailed descriptions
- Make sure epics are coherent and make sense
@@ -128,10 +131,11 @@
- 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
### 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_gen_features --component @xx__spec_[component_name].md`
### Revise
- Revise the features, answer questions, put detailed descriptions
@@ -141,19 +145,35 @@
# 3. Development phase
## 3.1 **🤖📋AI plan**: Feature implementation
For each component in `docs/02_components/[##]_[component_name]/` folder do next:
```
Read component description `@docs/02_components/[##]_[component_name]/spec.md`.
Read all features in the folder `@docs/02_components/[##]_[component_name]`. For each feature do next:
- Implement it
- Make sure feature is connected and communicated properly with other features and existing code
- Create unit tests from the Test cases description, run it and make sure the result is a success
- Create integration test for the feature, run and make sure the result is a success
If integration tests are specified in component spec, then write them and run, and make sure that component working correctly
```
## 3.2 **🤖AI agent**: Solution composition and integration tests
## 3.05 **🤖AI agent**: Initial structure
### Execute: `/3.implementation/3.05_implement_initial_structure`
### Review
- Analyze the code, ask to do some adjustments if needed
## 3.10 **🤖📋AI plan**: Feature implementation
### Execute
For each component in `docs/02_components` run
`/3.implementation/3.10_implement_component @component_folder`
### Revise Plan
- Analyze the proposed development plan in a great detail, provide all necessary information
- Possibly reorganize plan if needed, think and add more input constraints if needed
- Improve plan as much as possible so it would be clear what exactly to do
### Save Plan
- when plan is final and ready, save it as `[##]._plan_[component_name]` to component's folder
### Execute Plan
- Press build and let AI generate the code
### Revise Code
- Read the code and check that everything is ok
## 3.20 **🤖AI agent**: Solution composition and integration tests
```
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:
@@ -166,4 +186,6 @@
Repeat test cycle until no failed tests.
```
# 4. Refactoring phase