This directory maps the distribution layout for the Claude Code agent platform. It does not contain the generation logic itself -- that lives in generators/. What platforms/ provides is a reference view of what the platform produces and how the shared components relate to platform-specific ones.

The generators/ directory is the working structure:

• generators/claude-md.md -- CLAUDE.md generation template
• generators/features/ -- 14 composable feature blocks

platforms/ organizes these same components from a distribution perspective: what does a Claude Code user get? What is shared across potential future platforms?

platforms/
├── shared/
│   ├── features/     --> generators/features/ (14 canonical feature blocks)
│   └── templates/    --> reference/templates/ (10 note type templates)
├── claude-code/
│   ├── generator.md  --> generators/claude-md.md (CLAUDE.md generation)
│   └── hooks/        Hook templates for Claude Code platform
└── README.md         This file

During plugin packaging (Section 18 of the PRD), the build process references platforms/ to assemble the distribution:

• Claude Code plugin reads platforms/shared/ and platforms/claude-code/ to bundle feature blocks, templates, generation logic, and hook templates alongside the skills/, reference/, and thinking/ directories.

The generators/ directory remains the canonical source. Files here are not duplicated -- README files document the relationship and provide platform-specific context that the generator files themselves don't carry.