Diataxis skill: Role-first vs content-type-first structure mismatch

[virtualian]

Issue

The Diataxis-Documentation skill has a mismatch between its stated principle and documented example.

SKILL.md states:

Role-First Structure - Documentation organized by audience

Standard.md shows (lines 299-315):

website/docs/
├── tutorials/           # Learning-oriented
├── how-to/              # Task-oriented
├── reference/           # Information-oriented
└── concepts/            # Understanding-oriented

This is content-type-first, not role-first.

Options

1. Update Standard.md to show role-first structure:

   docs/
   ├── users/
   │   ├── tutorials/
   │   ├── how-to/
   │   └── reference/
   ├── developers/
   │   ├── how-to/
   │   ├── reference/
   │   └── explanation/
   └── contributors/
       └── ...
   

2. Update SKILL.md to say "Role-Aware Structure" instead (content organized by type but tagged/filtered by role)

3. Support both - Document when to use each approach

Context

Discovered while using the skill for pai-documentation site. The PlanDocumentation workflow generated content-type-first structure following Standard.md, but this contradicts the skill's stated principle.

---

🤖 Generated with Claude Code

[virtualian]

Created in wrong repo - moving to correct location