graph TD
Start([Start: Test Docs Creation]) --> Phase1[Phase 1: CREATE
Check & create test documentation]
Phase1 --> CheckDirs[Check directories:
docs/reference/guides/, tests/]
CheckDirs --> CreateDirs{Directories
exist?}
CreateDirs -->|No| MakeDirs[Create missing directories]
CreateDirs -->|Yes| CheckFiles
MakeDirs --> CheckFiles
CheckFiles[Check files:
testing-strategy.md, tests/README.md]
CheckFiles --> FilesExist{Files
exist?}
FilesExist -->|Yes| Preserved[Preserve existing files
Skip creation]
FilesExist -->|No| CreateFiles[Create from templates
Replace DATE placeholders]
Preserved --> Phase2
CreateFiles --> Phase2
Phase2[Phase 2: Validate Structure
Auto-fix violations]
Phase2 --> AutoFix[Auto-fix:
SCOPE tags, required sections,
Maintenance sections, POSIX endings]
AutoFix --> Phase3[Phase 3: Validate Content
Semantic validation + auto-discovery]
Phase3 --> ValidateStrategy[Validate testing-strategy.md:
Testing Philosophy, Test Levels]
Phase3 --> AutoDiscovery[Auto-discovery for tests/README.md]
AutoDiscovery --> FrameworkDetect[Detect framework:
package.json jest/vitest
requirements.txt pytest
go.mod built-in]
FrameworkDetect --> StructureScan[Scan test directory structure:
tests/e2e/, tests/integration/, tests/unit/]
StructureScan --> NamingDetect[Detect naming conventions:
*.test.js, *.spec.ts, test_*.py, *_test.go]
NamingDetect --> ValidateReadme[Validate tests/README.md sections:
Test Organization, Running Tests]
ValidateStrategy --> Summary
ValidateReadme --> Summary
Summary[Display completion summary:
Files created/preserved,
Framework detected,
Structure validated]
Summary --> End([End: ✓ Test docs created + validated])
%% Styling
classDef action fill:#C8E6C9,stroke:#388E3C,stroke-width:2px
classDef validation fill:#FFF9C4,stroke:#F57C00,stroke-width:2px
classDef decision fill:#FFE0B2,stroke:#E64A19,stroke-width:2px
class Phase1,CheckDirs,MakeDirs,CheckFiles,CreateFiles,Preserved,AutoFix,FrameworkDetect,StructureScan,NamingDetect,Summary action
class Phase2,Phase3,ValidateStrategy,AutoDiscovery,ValidateReadme validation
class CreateDirs,FilesExist decision