graph TD
Start([Start: Create Project Documentation]) --> Phase1[Phase 1: Create Structure
3-7 files based on project type]
Phase1 --> CheckFiles[Check existing files
docs/project/*.md]
CheckFiles --> DetermineTemplates[Determine conditional templates:
api_spec Backend only
database_schema if DB detected
design_guidelines Frontend only]
DetermineTemplates --> CreateMissing[Create missing templates from references/]
CreateMissing --> 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
27 questions parametric loop]
Phase3 --> ParametricLoop[For each question in questions.md:
Extract section content]
ParametricLoop --> CheckHeuristics{Validation
heuristics pass?}
CheckHeuristics -->|Yes| Valid[Section valid, skip to next question]
CheckHeuristics -->|No| AutoDiscovery
AutoDiscovery[Auto-discovery:
package.json, src/, docker-compose,
migrations/, .env.example]
AutoDiscovery --> DiscoverySuccess{Discovery
successful?}
DiscoverySuccess -->|Yes| PopulateDiscovery[Populate section
with discovered data]
DiscoverySuccess -->|No| MCPRef
MCPRef[MCP Ref research:
Framework features, architecture patterns,
library standards, tech comparisons]
MCPRef --> MCPSuccess{Research
successful?}
MCPSuccess -->|Yes| PopulateRef[Populate section
with research summary]
MCPSuccess -->|No| UserFallback[User question fallback:
Ask user to provide content]
PopulateDiscovery --> MoreQuestions
PopulateRef --> MoreQuestions
UserFallback --> MoreQuestions
Valid --> MoreQuestions
MoreQuestions{More questions
to validate?}
MoreQuestions -->|Yes| ParametricLoop
MoreQuestions -->|No| Phase4
Phase4[Phase 4: Finalization
Generate summary report]
Phase4 --> Summary[Display completion summary:
Files created/preserved,
Sections populated auto vs user]
Summary --> End([End: ✓ 7 project 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,CheckFiles,DetermineTemplates,CreateMissing,AutoFix,PopulateDiscovery,PopulateRef,UserFallback,Summary action
class Phase2,Phase3,ParametricLoop,AutoDiscovery,MCPRef,Phase4 validation
class CheckHeuristics,DiscoverySuccess,MCPSuccess,MoreQuestions decision