Summary
The Diataxis-Documentation skill currently hardcodes docs/.diataxis.md as the project config file location. PAI's standard for project-level config files is .prd/, so the skill should use .prd/.diataxis.md instead.
Rationale
.prd/ is the PAI convention for project configuration and PRD filesdocs/ may not exist in all project structures (e.g., Astro Starlight uses src/content/docs/)- Placing config in
docs/ can conflict with documentation tooling that treats docs/ as content
Affected Files
7 files reference docs/.diataxis.md:
SKILL.mdWorkflows/InitializeProject.mdWorkflows/PlanDocumentation.mdWorkflows/OrganizeDocumentation.mdWorkflows/CreateScaffold.mdWorkflows/GenerateContent.mdWorkflows/UpdateSkill.md
Proposed Change
Replace all references to docs/.diataxis.md with .prd/.diataxis.md across the skill. The InitializeProject workflow should create the file at .prd/.diataxis.md and all other workflows should look for it there.
Summary
The Diataxis-Documentation skill currently hardcodes
docs/.diataxis.mdas the project config file location. PAI's standard for project-level config files is.prd/, so the skill should use.prd/.diataxis.mdinstead.Rationale
.prd/is the PAI convention for project configuration and PRD filesdocs/may not exist in all project structures (e.g., Astro Starlight usessrc/content/docs/)docs/can conflict with documentation tooling that treatsdocs/as contentAffected Files
7 files reference
docs/.diataxis.md:SKILL.mdWorkflows/InitializeProject.mdWorkflows/PlanDocumentation.mdWorkflows/OrganizeDocumentation.mdWorkflows/CreateScaffold.mdWorkflows/GenerateContent.mdWorkflows/UpdateSkill.mdProposed Change
Replace all references to
docs/.diataxis.mdwith.prd/.diataxis.mdacross the skill. The InitializeProject workflow should create the file at.prd/.diataxis.mdand all other workflows should look for it there.