* 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> |
||
|---|---|---|
| .. | ||
| EXPERT_PANEL_REVIEW.md | ||
| PHASE1_COMPLETION.md | ||
| PHASE2_COMPLETION.md | ||
| README.md | ||
| STATUS.md | ||
| TEST_IMPLEMENTATION_SUMMARY.md | ||
| USE_CASES.md | ||
Historical Documentation Archive - October 2025 Milestones
Archive Date: 2025-12-31 Reason: Historical milestone documentation from Phase 1 & 2 completion (October 2025)
Contents
This directory contains historical documentation from the October 2025 development milestones when Phase 1 and Phase 2 implementations were completed.
Phase Completion Documents
- PHASE1_COMPLETION.md - Response analyzer & circuit breaker implementation (completed 2025-10-01)
- PHASE2_COMPLETION.md - Requirements clarity, use cases, and testing enhancements (completed 2025-10-01)
Review and Planning Documents
- EXPERT_PANEL_REVIEW.md - Expert panel review with recommendations from Martin Fowler, Kent Beck, et al.
- TEST_IMPLEMENTATION_SUMMARY.md - Summary of initial test implementation achievements
- USE_CASES.md - Use case documentation following Alistair Cockburn's methodology
- STATUS.md - Historical status document (superseded by IMPLEMENTATION_STATUS.md)
Current Active Documentation
For current project status and planning, see:
../../IMPLEMENTATION_STATUS.md- Current status tracking (updated regularly)../../IMPLEMENTATION_PLAN.md- Active roadmap for remaining work../../README.md- Main project documentation../../CLAUDE.md- Instructions for Claude Code agents
Historical Context
These documents capture the state of the Ralph project in October 2025 when:
- 75 tests were passing (15 rate + 20 exit + 20 loop + 20 edge)
- Response analyzer and circuit breaker were implemented
- Test infrastructure was established
- Weeks 1-2 of the 6-week plan were complete
Archived to keep the base directory focused on active development needs while preserving historical milestones.