Skip to content

Commit b263f4d

Browse files
justin808claude
andcommitted
Organize analysis documents in /analysis directory
Move analysis documents to dedicated /analysis directory to keep them separate from top-level project files and improve repository organization. Changes: - Create /analysis directory structure - Move RAKE_TASK_DUPLICATE_ANALYSIS.md to analysis/rake-task-duplicate-analysis.md - Update CLAUDE.md with guidelines for analysis document placement - Update all references to point to new location Analysis documents (deep dives, investigations, historical context) should now be placed in /analysis with descriptive kebab-case names. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>
1 parent fa6321c commit b263f4d

File tree

3 files changed

+18
-2
lines changed

3 files changed

+18
-2
lines changed

CLAUDE.md

Lines changed: 17 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -2,6 +2,22 @@
22

33
This file provides guidance to Claude Code (claude.ai/code) when working with code in this repository.
44

5+
## Project Structure Guidelines
6+
7+
### Analysis Documents
8+
9+
When creating analysis documents (deep dives, investigations, historical context):
10+
- **Location**: Place in `/analysis` directory
11+
- **Format**: Use Markdown (.md)
12+
- **Naming**: Use descriptive kebab-case names (e.g., `rake-task-duplicate-analysis.md`)
13+
- **Purpose**: Keep detailed analyses separate from top-level project files
14+
15+
Examples:
16+
- `/analysis/rake-task-duplicate-analysis.md` - Historical analysis of duplicate rake task bug
17+
- `/analysis/feature-investigation.md` - Investigation of a specific feature or issue
18+
19+
Top-level documentation (like README.md, CONTRIBUTING.md) should remain at the root.
20+
521
## ⚠️ CRITICAL REQUIREMENTS
622

723
**BEFORE EVERY COMMIT/PUSH:**
@@ -551,7 +567,7 @@ end
551567
- You need to **programmatically generate** tasks
552568
- You need to **pass context** to the tasks
553569

554-
**Historical Context**: PR #1770 added explicit rake task loading, causing webpack builds and pack generation to run twice during `rake assets:precompile`. This was fixed in PR #2052. See `RAKE_TASK_DUPLICATE_ANALYSIS.md` for full details.
570+
**Historical Context**: PR #1770 added explicit rake task loading, causing webpack builds and pack generation to run twice during `rake assets:precompile`. This was fixed in PR #2052. See `analysis/rake-task-duplicate-analysis.md` for full details.
555571

556572
### Engine Initializers and Hooks
557573

File renamed without changes.

spec/react_on_rails/engine_spec.rb

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -228,7 +228,7 @@ module ReactOnRails
228228
#
229229
# Historical context: PR #1770 added explicit loading via rake_tasks block,
230230
# causing tasks to run twice. Fixed in PR #2052 by relying on automatic loading.
231-
# See RAKE_TASK_DUPLICATE_ANALYSIS.md for full details.
231+
# See analysis/rake-task-duplicate-analysis.md for full details.
232232

233233
it "verifies engine.rb does not have a rake_tasks block" do
234234
# Read the engine.rb file

0 commit comments

Comments
 (0)