About directory-management
An agent skill that organizes generated project artifacts under a named project directory. It resolves the project name from context or existing PLAN.md files, then follows a defined folder structure.
Key features
- 01Resolves a project name
- 02Checks for existing PLAN.md files
- 03Creates a project directory
- 04Organizes artifacts by folder
Use cases
- 01Starting work on a named project
- 02Resuming a project from PLAN.md
- 03Keeping generated files organized
Install
Copy the command and run it in a terminal.
$
npx skills add https:/ / github.com/ awslabs/ agent-plugins --skill directory-managementAfter installing, type/directory-managementin Claude Code to confirm it loaded.
Details
From the project READMEDirectory Management
Project Setup
Before any work begins, resolve the project name:
- If the project name is already known from conversation context, use it.
- Otherwise, scan for existing
*/PLAN.mdfiles in the current directory. If found, ask the user if they are resuming an existing project and load thatPLAN.mdinto context. - If no existing projects are found, recommend a ≤64-char lowercase slug based on what you know from the conversation (only
[a-z0-9-]), or ask directly if there isn't enough context. Present the recommended name and wait for user confirmation.
Once project name is resolved:
- Create and/or use the
<experiment-name>/directory using the confirmed name for storing all the artifacts
Directory Structure
When working with the agent, all generated files are organized under an project directory.
<project-name>/
├── specs/
│ ├── PLAN.md # Your customization plan
├── scripts/ # Generated Python scripts
│ ├── <project-name>_transform_fn.py
├── notebooks/ # Generated Jupyter notebooks
│ ├── <project-name>.ipynb
├── manifests/ # Machine-readable outputs (JSON)
└── agent_memory/ # Session persistence (git-ignored)
└── session-notes.md # Progress, artifacts, next steps
Comments
Markdown supported