mirror of
https://github.com/azaion/detections.git
synced 2026-04-23 03:26:33 +00:00
Oleksandr Bezdieniezhnykh
d28b9584f2
- Replace all Jira-specific references with generic tracker/work-item terminology (TRACKER-ID, work item epics); delete project-management.mdc and mcp.json.example - Restructure refactor skill: extract 8 phases (00–07) and templates into separate files; add guided mode for pre-built change lists - Add Step 3 "Code Testability Revision" to existing-code workflow (renumber steps 3–12 → 3–13) - Simplify autopilot state file to minimal current-step pointer - Strengthen coding rules: AAA test comments per language, test failures as blocking gates, dependency install policy - Add Docker Suitability Assessment to test-spec and test-run skills (local vs Docker execution) - Narrow human-attention sound rule to human-input-needed only - Add AskQuestion fallback to plain text across skills - Rename FINAL_implementation_report to implementation_report_* - Simplify cursor-meta (remove _docs numbering table, quality thresholds) - Make techstackrule alwaysApply, add alwaysApply:false to openapi
3.3 KiB
3.3 KiB
Artifact Management
Directory Structure
All artifacts are written directly under DOCUMENT_DIR:
DOCUMENT_DIR/
├── tests/
│ ├── environment.md
│ ├── test-data.md
│ ├── blackbox-tests.md
│ ├── performance-tests.md
│ ├── resilience-tests.md
│ ├── security-tests.md
│ ├── resource-limit-tests.md
│ └── traceability-matrix.md
├── architecture.md
├── system-flows.md
├── data_model.md
├── deployment/
│ ├── containerization.md
│ ├── ci_cd_pipeline.md
│ ├── environment_strategy.md
│ ├── observability.md
│ └── deployment_procedures.md
├── risk_mitigations.md
├── risk_mitigations_02.md (iterative, ## as sequence)
├── components/
│ ├── 01_[name]/
│ │ ├── description.md
│ │ └── tests.md
│ ├── 02_[name]/
│ │ ├── description.md
│ │ └── tests.md
│ └── ...
├── common-helpers/
│ ├── 01_helper_[name]/
│ ├── 02_helper_[name]/
│ └── ...
├── diagrams/
│ ├── components.drawio
│ └── flows/
│ ├── flow_[name].md (Mermaid)
│ └── ...
└── FINAL_report.md
Save Timing
| Step | Save immediately after | Filename |
|---|---|---|
| Step 1 | Blackbox test environment spec | tests/environment.md |
| Step 1 | Blackbox test data spec | tests/test-data.md |
| Step 1 | Blackbox tests | tests/blackbox-tests.md |
| Step 1 | Blackbox performance tests | tests/performance-tests.md |
| Step 1 | Blackbox resilience tests | tests/resilience-tests.md |
| Step 1 | Blackbox security tests | tests/security-tests.md |
| Step 1 | Blackbox resource limit tests | tests/resource-limit-tests.md |
| Step 1 | Blackbox traceability matrix | tests/traceability-matrix.md |
| Step 2 | Architecture analysis complete | architecture.md |
| Step 2 | System flows documented | system-flows.md |
| Step 2 | Data model documented | data_model.md |
| Step 2 | Deployment plan complete | deployment/ (5 files) |
| Step 3 | Each component analyzed | components/[##]_[name]/description.md |
| Step 3 | Common helpers generated | common-helpers/[##]_helper_[name].md |
| Step 3 | Diagrams generated | diagrams/ |
| Step 4 | Risk assessment complete | risk_mitigations.md |
| Step 5 | Tests written per component | components/[##]_[name]/tests.md |
| Step 6 | Epics created in work item tracker | Tracker via MCP |
| Final | All steps complete | FINAL_report.md |
Save Principles
- Save immediately: write to disk as soon as a step completes; do not wait until the end
- Incremental updates: same file can be updated multiple times; append or replace
- Preserve process: keep all intermediate files even after integration into final report
- Enable recovery: if interrupted, resume from the last saved artifact (see Resumability)
Resumability
If DOCUMENT_DIR already contains artifacts:
- List existing files and match them to the save timing table above
- Identify the last completed step based on which artifacts exist
- Resume from the next incomplete step
- Inform the user which steps are being skipped