| name | doc-migrator |
| type | automation |
| callable | true |
| version | 1.0.0 |
| description | Migrate existing documentation into .claude/ structure and archive originals |
| trigger | During bootstrap or major refactoring |
| auto_invoke | false |
Document Migrator Skill
Purpose
Find, classify, merge, and archive existing documentation safely.
Process
- Scan for all .md files (excluding .claude/, node_modules, .git)
- Classify by content type (requirements, architecture, patterns, etc.)
- Archive originals to .claude/archive/TIMESTAMP/
- Update .gitignore
Safety
- Never delete without archiving
- Preserve git history
- Create detailed migration log
- Ask for confirmation before migration
Usage
python .claude/skills/doc-migrator/migrate_docs.py
Classification Patterns
- requirements: requirement, spec, feature, user story, acceptance
- architecture: architecture, design, system, component, module
- patterns: pattern, best practice, convention, guideline, style
- api: api, endpoint, interface, contract
- setup: setup, installation, getting started, quickstart
- changelog: changelog, history, version, release
- contributing: contribut, development, workflow
Output
- Archives to:
.claude/archive/YYYYMMDD_HHMMSS/ - Migration log:
.claude/logs/migration.json - Updated:
.gitignore