Manage Files Skill

Generic file operations for plan directories. Provides basic CRUD operations for any file within a plan directory.

Enforcement

Base contract: See manage-contract.md for shared enforcement rules, TOON output format, and error response patterns.

Skill-specific constraints:

• Do not pass absolute paths or .. traversals in --file arguments
• File paths are always relative to the plan directory
• plan_id must be kebab-case format
• Multi-line content and any payload whose first line begins with # MUST be passed via --content-file or --stdin, never via inline --content. The Bash permission heuristic ("Newline followed by # inside a quoted argument can hide arguments from path validation") fires before manage-files.py runs, so a script-level rejector cannot prevent the originating prompt — caller compliance is the only enforcement surface. Canonical pattern: stage the payload via the Write tool to .plan/temp/{name}.{ext} first, then invoke manage-files write --plan-id {plan_id} --file work/{name}.{ext} --content-file .plan/temp/{name}.{ext}.

Storage Location

Files are stored in plan directories: