 secondsky
|
1b5fb0ce23
|
docs: Consolidate documentation into unified docs/ directory
Major restructuring to improve documentation organization and discoverability:
## Structure Changes
- Created docs/ directory with clear hierarchy:
- docs/getting-started/ - Entry points and quick guides
- docs/guides/ - In-depth guides and best practices
- docs/reference/ - Standards and reference materials
- docs/archive/ - Historical documents
## Files Moved (28 total)
- START_HERE.md, QUICK_WORKFLOW.md, ONE_PAGE_CHECKLIST.md → docs/getting-started/
- PLUGIN_DEV_BEST_PRACTICES.md, MARKETPLACE_MANAGEMENT.md, CONTRIBUTING.md → docs/guides/
- claude-code-skill-standards.md, STANDARDS_COMPARISON.md, research-protocol.md,
COMMON_MISTAKES.md, SKILL_CATEGORIZATION.md → docs/reference/
- MIGRATION_GUIDE.md, SKILLS_REVIEW_PROGRESS.md, SKILL_COUNT_RECONCILIATION.md,
lost-info.md → docs/archive/
## Files Deleted (5 deprecated)
- planning/archive/verification-checklist.md (duplicate of ONE_PAGE_CHECKLIST.md)
- planning/archive/skills_workflow.md (superseded by START_HERE + QUICK_WORKFLOW)
- planning/archive/SKILL_REVIEW_PROCESS.md (now in skill-review skill)
- planning/archive/subagent-workflow.md (now in plugin-dev:agent-development)
- planning/archive/COMPLETED_REVIEWS.md (low value, historical)
## Directories Removed
- planning/ (all files moved or deleted)
- planning/archive/ (all files moved or deleted)
## Link Updates
- CLAUDE.md: Updated all 15+ documentation references
- README.md: Updated 4 documentation links
- docs/getting-started/: Updated internal links and skill counts (50 → 169)
- docs/guides/: Updated cross-references to docs/reference/
- docs/reference/: Updated cross-references
- commands/: Batch updated all planning/ references
- scripts/: Batch updated all planning/ references
## Content Updates
- Updated skill count: 50 → 169 in START_HERE.md, QUICK_WORKFLOW.md
- Updated last verified date: 2025-10-29 → 2025-11-20 in START_HERE.md
- Removed references to deleted planning/research-logs/ directory
- Updated skill-review process reference to use skill instead of archived docs
## Benefits
- Single source of truth: All docs in one place (docs/)
- Clear hierarchy: Easy to find getting-started vs guides vs reference
- Reduced redundancy: Removed 5 duplicate/deprecated files
- Better discoverability: Logical grouping by purpose
- Cleaner root: Only essential project files remain
## Verification
- All internal links updated and tested
- No broken references to deleted files
- Git tracking all renames properly
- Documentation structure now matches best practices
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
|
2025-12-28 14:07:03 +01:00 |
|