Grand Diomande Research · Full HTML Reader

Root Folder Reorganization Plan

``` cc-tpo/ ├── README.md # Main README (keep) ├── START_HERE.md # Getting started guide (keep) ├── .env # Environment config (keep) ├── package.json # Node config (keep) ├── requirements-ircp.txt # Python deps (keep) │ ├── docs/ # All documentation │ ├── guides/ # User guides │ │ ├── GETTING_STARTED.md │ │ ├── INTEGRATION_PLAN.md │ │ └── ... │ ├── architecture/ # Architecture docs │ │ ├── DLM_INTEGRATION_PIPELINE.md │ │ ├── DLM_FUSION_STRATEGY.md │ │ └── ... │ ├── progress/ # Progress summaries │ │ ├── WEEK_2_PROG

Agents That Account for Themselves proposal experiment writeup candidate score 24 .md

Full Public Reader

Root Folder Reorganization Plan

## Current Issues
- 40+ markdown files in root directory
- Loose Python scripts (cc_ai.py, man.py, verify_imports.py)
- Notebook file (main.ipynb) in root
- Documentation scattered across root

Proposed Structure

cc-tpo/
├── README.md                    # Main README (keep)
├── START_HERE.md               # Getting started guide (keep)
├── .env                        # Environment config (keep)
├── package.json                # Node config (keep)
├── requirements-ircp.txt       # Python deps (keep)
│
├── docs/                       # All documentation
│   ├── guides/                 # User guides
│   │   ├── GETTING_STARTED.md
│   │   ├── INTEGRATION_PLAN.md
│   │   └── ...
│   ├── architecture/           # Architecture docs
│   │   ├── DLM_INTEGRATION_PIPELINE.md
│   │   ├── DLM_FUSION_STRATEGY.md
│   │   └── ...
│   ├── progress/               # Progress summaries
│   │   ├── WEEK_2_PROGRESS_SUMMARY.md
│   │   ├── WEEK_3_PROGRESS_SUMMARY.md
│   │   └── ...
│   ├── refactoring/            # Refactoring docs
│   │   ├── DLM_REFACTORING_AUDIT.md
│   │   ├── REFACTORING_PHASE1_COMPLETE.md
│   │   └── ...
│   └── plans/                  # Planning docs
│       ├── CC_CONVERSATION_ANALYSIS_PLAN.md
│       ├── PERFORMANCE_OPTIMIZATION_PLAN.md
│       └── ...
│
├── scripts/                    # All executable scripts
│   ├── cc_ai.py               # Main CC AI CLI (move from root)
│   ├── verify_imports.py       # Import verification (move from root)
│   └── ...                    # Existing scripts
│
├── notebooks/                  # Jupyter notebooks
│   └── main.ipynb             # Main notebook (move from root)
│
├── tools/                      # Utility tools (already exists)
│   └── ...
│
├── packages/                   # Package code (keep as is)
├── data/                      # Data files (keep as is)
├── training/                   # Training artifacts (keep as is)
├── apps/                      # Applications (keep as is)
└── services/                  # Services (keep as is)

File Categories

### Keep in Root:
- README.md
- START_HERE.md
- .env
- package.json, package-lock.json
- requirements-ircp.txt

### Move to docs/guides/:
- GETTING_STARTED.md
- INTEGRATION_PLAN.md
- IRCP_INTEGRATION_QUICK_REFERENCE.md
- DLM_INTEGRATION_QUICK_REFERENCE.md

### Move to docs/architecture/:
- DLM_INTEGRATION_PIPELINE.md
- DLM_FUSION_STRATEGY.md
- DLM_CODEBASE_AUDIT.md
- PERSONALIZED_AI_SYSTEM_ARCHITECTURE.md
- CC_AI_PIPELINE_COMPLETE.md

### Move to docs/progress/:
- WEEK_2_PROGRESS_SUMMARY.md
- WEEK_2_TEST_RESULTS.md
- WEEK_3_PROGRESS_SUMMARY.md
- PHASE_2_1_COORDINATES.md
- PHASE_2_2_EMBEDDINGS.md
- PHASE_2_3_CONFIG.md
- PHASE_2_4_LOGGING.md
- PHASE_2_5_TESTING.md
- PHASE_3_1_DATA_LOADING.md
- PHASE_3_2_IRCP_INTEGRATION.md
- PHASE_3_2_SUMMARY.md
- PHASE_3_3_EVALUATION.md
- PHASE_3_4_PIPELINE.md
- PHASE_3_4_SUMMARY.md

### Move to docs/refactoring/:
- DLM_REFACTORING_AUDIT.md
- REFACTORING_PHASE1_COMPLETE.md
- REORGANIZATION_COMPLETE.md
- REORGANIZATION_STATUS.md
- REORGANIZATION_IMPLEMENTATION.md
- REORGANIZATION_PLAN.md
- PYDANTIC_V2_COMPLETE.md
- PYDANTIC_V2_MIGRATION.md

### Move to docs/plans/:
- CC_CONVERSATION_ANALYSIS_PLAN.md
- CONVERSATION_DATA_ANALYSIS_PLAN.md
- PERFORMANCE_OPTIMIZATION_PLAN.md
- PERFORMANCE_IMPROVEMENTS_COMPLETE.md
- DOCUMENTATION_PLAN.md
- INTEGRATION_SUMMARY.md

### Move to docs/summaries/:
- FINAL_SUMMARY.md
- IMPROVEMENTS_SUMMARY.md
- IRCP_TRAINING_INFRASTRUCTURE_ANALYSIS.md

### Move to scripts/:
- cc_ai.py
- verify_imports.py
- man.py (or delete if just a test file)

### Move to notebooks/:
- main.ipynb

Promotion Decision

Attach run IDs, datasets, metrics, and reproduction commands.

Source Anchor

Comp-Core/backend/cc-trajectory/legacy/cc-tpo-original/cc-tpo/docs/refactoring/ROOT_REORGANIZATION_PLAN.md

Detected Structure

Method · Evaluation · Code Anchors · Architecture