# Repo Cleanup Agent Directories

> Sub-skill of repo-cleanup: Agent Directories (+4).

- Skill: `vamseeachanta/repo-cleanup-agent-directories-2` (Agent Skill)
- Install (CLI): `npx skillmds@latest add vamseeachanta/repo-cleanup-agent-directories-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/vamseeachanta/repo-cleanup-agent-directories-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: vamseeachanta (https://skillmd.com/u/vamseeachanta)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/vamseeachanta/repo-cleanup-agent-directories-2

---


# Agent Directories (+4)

## Agent Directories


Multiple agent-related directories should consolidate to `.claude/agents/`.

**Before:**
```
root/
├── agents/
├── .agents/
├── agent_configs/
└── .agent-os/
```

*See sub-skills for full details.*

## Runtime/Coordination Data


- Session state files
- Coordination lock files
- Runtime cache
- Worker state

**Commands:**
```bash
# Create runtime directory

# Move runtime files (don't use git mv - these are untracked)
```

## Prototype Code


Prototype and experimental code should go to `examples/prototypes/`.

**Commands:**
```bash
mkdir -p examples/prototypes
git mv prototype_*.py examples/prototypes/
git mv experimental/ examples/prototypes/
```

## Test Outputs


Test output files should go to `tests/outputs/` (gitignored).

**Commands:**
```bash
mkdir -p tests/outputs
mv tests/*.html tests/outputs/
mv tests/*.json tests/outputs/
mv tests/test_results/ tests/outputs/
```

## Plan Files


Completed specification plans should be archived.

**Pattern:**
- Active plans: `specs/modules/<plan>.md`
- Completed plans: `specs/archive/<plan>.md`

**Commands:**
```bash
# Archive completed plan (check status: completed in YAML frontmatter)
mkdir -p specs/archive
git mv specs/modules/<completed-plan>.md specs/archive/
```