File Placement Skill

Apply correct file placement rules for all output files.

Why This Matters

File placement is enforced by hooks - violations will be blocked. This skill ensures you understand the rules so your work isn't rejected.

File Placement Rules

Forbidden Placements

NEVER place these in the wrong location:

• •Summaries in docs/ or project root
• •Reports in docs/ or project root
• •Memory entries outside memory/exports/
• •Output files in source directories

Filename Rules

ALL-CAPS Restrictions

Only these filenames may be ALL-CAPS:

• •README.md, LICENSE, LICENSE.md
• •CLAUDE.md, SKILL.md, AGENTS.md
• •CHANGELOG.md, CONTRIBUTING.md
• •AUTHORS, NOTICE, PATENTS, VERSION
• •MAKEFILE, DOCKERFILE, COPYING, COPYRIGHT

All other files: Use lowercase-kebab-case

• •execution-summary.md (correct)
• •EXECUTION-SUMMARY.md (blocked)

Hook Enforcement

The summary-file-enforcement.js hook will:

1. •Block files with ALL-CAPS names (except allowlist)
2. •Block summary/report files outside summaries/
3. •Suggest correct filename/location

Before Creating Files

Ask yourself:

1. •Is this a summary or report? → Put in summaries/
2. •Is this a memory entry? → Put in memory/exports/<category>/ (category: architecture, implementation, issues, patterns)
3. •Is my filename lowercase-kebab? → If not, fix it
4. •Am I using ALL-CAPS? → Only if in allowlist

Integration with Hooks

This skill provides guidance - you understand the rules. The hook provides enforcement - violations are blocked.

Together they ensure consistent file organization even when:

• •Context is lost
• •Rules are forgotten
• •New team members join