claudetools/PROJECT_ORGANIZATION.md

# ClaudeTools - Project Organization Index

**Last Updated:** 2026-01-20
**Purpose:** Master index for all projects, clients, and session data

---

## Folder Structure

```
D:\ClaudeTools/
├── clients/                    # Client-specific information
│   ├── dataforth/             # Dataforth client (DOS project)
│   └── horseshoe-management/  # Horseshoe Management client
│
├── projects/                   # Project-specific work
│   ├── dataforth-dos/         # Dataforth DOS Update System
│   │   ├── batch-files/       # DOS .BAT files (17 files)
│   │   ├── deployment-scripts/ # PowerShell deployment scripts (33 files)
│   │   ├── documentation/     # Technical docs (8 files)
│   │   └── session-logs/      # DOS-specific session logs
│   │
│   └── claudetools-api/       # ClaudeTools MSP API
│       ├── api/               # FastAPI application
│       ├── migrations/        # Alembic database migrations
│       └── session-logs/      # API-specific session logs
│
├── session-logs/              # General cross-project session logs
│   └── YYYY-MM-DD-session.md # Daily session logs
│
├── .claude/                   # Claude Code configuration
│   ├── commands/              # Custom commands (/save, /context, etc.)
│   ├── skills/                # Custom skills
│   └── templates/             # Templates
│
├── credentials.md             # Centralized credentials (UNREDACTED)
├── SESSION_STATE.md           # Overall project state tracker
└── PROJECT_ORGANIZATION.md    # This file
```

---

## Quick Navigation

### By Client

**Dataforth:**
- Client Folder: `clients/dataforth/`
- Project: `projects/dataforth-dos/`
- Index: `projects/dataforth-dos/PROJECT_INDEX.md`

**Horseshoe Management:**
- Client Folder: `clients/horseshoe-management/`
- Info: `clients/horseshoe-management/CLIENT_INFO.md`

### By Project Type

**Infrastructure/Hardware:**
- Dataforth DOS Update System → `projects/dataforth-dos/`

**Software Development:**
- ClaudeTools MSP API → `projects/claudetools-api/`
- Original code: `api/`, `migrations/`, etc.

### By Date/Session

**Session Logs:**
- General: `session-logs/YYYY-MM-DD-session.md`
- Dataforth DOS: `projects/dataforth-dos/session-logs/`
- ClaudeTools API: `projects/claudetools-api/session-logs/`

---

## Projects Status

### Dataforth DOS Update System
**Status:** Production Ready - Awaiting Pilot Testing
**Last Work:** 2026-01-20
**Next:** Test on TS-4R, then full rollout
**Files:** 17 BAT files, 33 deployment scripts, 8 docs
**See:** `projects/dataforth-dos/PROJECT_INDEX.md`

### ClaudeTools MSP API
**Status:** Phase 5 Complete
**Last Work:** Prior to 2026-01-19
**Endpoints:** 95+ across 17 entities
**Database:** MariaDB @ 172.16.3.30
**See:** `.claude/claude.md` and `SESSION_STATE.md`

---

## Clients Status

### Dataforth
**Services:** DOS machine management, update system, QC automation
**Active Projects:** DOS Update System
**Infrastructure:** AD2 server, D2TESTNAS, ~30 DOS machines

### Horseshoe Management
**Services:** Remote support, QuickBooks/Intuit assistance
**Recent:** Glance screen sharing version mismatch (2026-01-20)
**Status:** Active support client

---

## Context Recovery

When searching for previous work:

1. **Check Project Index:**
   - `projects/[project-name]/PROJECT_INDEX.md`

2. **Check Client Info:**
   - `clients/[client-name]/CLIENT_INFO.md`

3. **Check Session Logs:**
   - `session-logs/YYYY-MM-DD-session.md` (general)
   - `projects/[project]/session-logs/` (project-specific)

4. **Check Credentials:**
   - `credentials.md` (infrastructure access)

5. **Check Overall State:**
   - `SESSION_STATE.md` (ClaudeTools API phases)

---

## File Counts (2026-01-20)

### Dataforth DOS Project
- Batch Files: 17
- Deployment Scripts: 33
- Documentation: 8
- Total: 58 files

### Clients
- Dataforth: (files in DOS project)
- Horseshoe Management: 1 info file

### ClaudeTools API
- Source Files: 100+ (api/, migrations/, etc.)
- Documentation: 10+

---

## Recent Work Summary

### 2026-01-20: Dataforth DOS Fixes
- Fixed 8 major DOS 6.22 compatibility issues
- Deployed 9 production BAT files
- 39+ deployments to AD2 and NAS
- All files organized into `projects/dataforth-dos/`

### 2026-01-20: Horseshoe Management Support
- Glance screen sharing troubleshooting
- Documented in `clients/horseshoe-management/`

---

## Context Search Examples

**Find DOS deployment info:**
```
Look in: projects/dataforth-dos/PROJECT_INDEX.md
Or: projects/dataforth-dos/documentation/DOS_DEPLOYMENT_GUIDE.md
```

**Find Dataforth infrastructure credentials:**
```
Look in: credentials.md (search for "Dataforth" or "AD2" or "D2TESTNAS")
```

**Find previous DOS session work:**
```
Look in: projects/dataforth-dos/session-logs/
Or: session-logs/2026-01-19-session.md (original work)
```

**Find Horseshoe Management history:**
```
Look in: clients/horseshoe-management/CLIENT_INFO.md
```

**Find ClaudeTools API status:**
```
Look in: SESSION_STATE.md
Or: .claude/claude.md
```

---

## Maintenance

**Update Frequency:**
- PROJECT_ORGANIZATION.md: After major folder changes
- PROJECT_INDEX.md: After project milestones
- CLIENT_INFO.md: After client interactions
- Session logs: Daily via `/save` command

**Organization Rules:**
1. Project files go in `projects/[project-name]/`
2. Client info goes in `clients/[client-name]/`
3. Shared credentials stay in root `credentials.md`
4. General session logs in root `session-logs/`
5. Project-specific logs in project's `session-logs/` folder

---

**Created:** 2026-01-20
**Purpose:** Enable efficient context recovery and project navigation
**Maintained By:** Claude Code via user direction