ralph-claude-code/docs/archive/2025-10-milestones
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
..
EXPERT_PANEL_REVIEW.md refactor(naming): remove @ prefix from on-disk filenames (#131) 2026-01-26 15:40:27 -07:00
PHASE1_COMPLETION.md refactor(naming): remove @ prefix from on-disk filenames (#131) 2026-01-26 15:40:27 -07:00
PHASE2_COMPLETION.md refactor(naming): remove @ prefix from on-disk filenames (#131) 2026-01-26 15:40:27 -07:00
README.md docs: archive historical milestone documentation (Oct 2025) 2025-12-31 17:17:34 -07:00
STATUS.md refactor(naming): remove @ prefix from on-disk filenames (#131) 2026-01-26 15:40:27 -07:00
TEST_IMPLEMENTATION_SUMMARY.md refactor(naming): remove @ prefix from on-disk filenames (#131) 2026-01-26 15:40:27 -07:00
USE_CASES.md refactor(naming): remove @ prefix from on-disk filenames (#131) 2026-01-26 15:40:27 -07:00

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.