graph TD
Start([Start: Root Docs Creation]) --> Phase1{CLAUDE.md exists?}
Phase1 -->|Yes| CheckLink{Has docs/README.md
link?}
Phase1 -->|No| AskProject[Ask: Project name
and description]
CheckLink -->|Yes| Phase2Start[Phase 2: Create docs/README.md]
CheckLink -->|No| AddLink[Add docs link
to CLAUDE.md]
AskProject --> CreateClaude[Create CLAUDE.md
from template]
CreateClaude --> CreateStandards[Create documentation_standards.md
60 universal requirements]
CreateStandards --> CreatePrinciples[Create principles.md
11 development principles]
CreatePrinciples --> Phase2Start
AddLink --> Phase2Start
Phase2Start --> CreateDir[Create docs/
directory]
CreateDir --> CreateReadme[Create docs/README.md
from template]
CreateReadme --> ReplaceVars[Replace placeholders:
VERSION, DATE, STATUS]
ReplaceVars --> Phase2Validate[Phase 2: Structure Validation
SCOPE tags, Maintenance sections]
Phase2Validate --> Phase3Validate[Phase 3: Semantic Content Validation
questions.md Q1-Q22]
Phase3Validate --> Notify[Notify: Root structure
established + validated]
Notify --> End([End: ✓ 4 docs created + validated])
%% Styling
classDef action fill:#C8E6C9,stroke:#388E3C,stroke-width:2px
classDef decision fill:#FFE0B2,stroke:#E64A19,stroke-width:2px
classDef success fill:#B3E5FC,stroke:#0277BD,stroke-width:2px
class AskProject,CreateClaude,CreateStandards,CreatePrinciples,AddLink,CreateDir,CreateReadme,ReplaceVars,Phase2Validate,Phase3Validate,Notify action
class Phase1,CheckLink decision
class End success