Commit graph

2 commits

Author SHA1 Message Date
Frank Bria
c7e7a1c6a3
refactor(naming): remove @ prefix from on-disk filenames (#131)
* refactor(naming): remove @ prefix from on-disk filenames

BREAKING CHANGE: Renames @fix_plan.md → fix_plan.md and @AGENT.md → AGENT.md

This change improves POSIX compliance and compatibility with command-line tools.
The @ prefix was originally used to avoid naming conflicts, but with the .ralph/
folder structure introduced in v0.10.0, this convention is no longer necessary.

Changes:
- Update all scripts to use new naming (fix_plan.md, AGENT.md)
- Update migration script to handle both old and new naming conventions
- Update templates to use new naming
- Update all documentation references
- Update all 420 tests to expect new naming (TDD approach)

Migration:
- Existing projects with @-prefixed files will be automatically renamed
  when running ralph-migrate
- Projects already using the new naming will continue to work unchanged

* docs(claude): update file naming conventions section

* fix(migrate): prevent orphaned @-prefixed files during migration

When both root/@fix_plan.md and .ralph/@fix_plan.md exist, the root file
now takes priority and the .ralph/@fix_plan.md is removed (backup exists).
This prevents orphaned legacy files after migration.

---------

Co-authored-by: Test User <test@example.com>
2026-01-26 15:40:27 -07:00
frankbria
3b4f5f049d docs: archive historical milestone documentation (Oct 2025)
Move completed milestone documentation to docs/archive/2025-10-milestones/ to keep
base directory focused on active development needs:

Archived files:
- PHASE1_COMPLETION.md (response analyzer & circuit breaker milestone)
- PHASE2_COMPLETION.md (requirements & testing enhancements milestone)
- EXPERT_PANEL_REVIEW.md (historical expert review)
- TEST_IMPLEMENTATION_SUMMARY.md (historical test summary)
- USE_CASES.md (historical use case documentation)
- STATUS.md (superseded by IMPLEMENTATION_STATUS.md)

Remaining active docs in base directory:
- IMPLEMENTATION_PLAN.md (roadmap for Weeks 3-6)
- IMPLEMENTATION_STATUS.md (current status tracking)
- README.md (project documentation)
- CLAUDE.md (agent instructions)
- SPECIFICATION_WORKSHOP.md (reusable template)
- sample-prd.md (example template)

Added docs/archive/2025-10-milestones/README.md explaining archive contents
and historical context.
2025-12-31 17:17:34 -07:00