file-placement

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/
• 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/<topic>/
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