Files
shopdb-flask/.claude/setup/README.md
Proudlock bd48814021 Reorganize repository structure and clean up documentation
Clean up and organize the flask-shopdb repository for better
maintainability and discoverability:

## Changes

- Update .gitignore for build artifacts (publish/, data/, 122M total)
- Reorganize .claude/ into 6 subdirectories with README navigation
- Consolidate overlapping MCP setup guides into MCP-QUICK-START.md
- Move deployment docs from root to docs/deployment/
- Archive dated status reports to .claude/archived/
- Delete temporary files (logs, backups, empty reports, ~50K)

## New Structure

.claude/ organized into:
- setup/ - MCP, VM, Hyper-V, GitHub setup guides + scripts (17 files)
- plans/ - Feature plans and protocols (5 files)
- maintenance/ - Deployment checklists and reports (4 files)
- archived/ - Historical documentation (9 files)
- skills/ - Claude Code automation (5 files)
- workflows/ - Security audit workflow (1 file)

docs/deployment/ created with 6 deployment guides:
- LOCAL-DEV-SETUP.md, DOCKER-SETUP.md, DOCKER-PREBUILT-APPROACH.md
- PRODUCTION-READINESS.md, DEPLOY-TO-VM.md, README.md

Root directory cleaned to essential docs only:
- CLAUDE.md, README.md, CONTRIBUTING.md, CHANGELOG.md

Benefits:
- Clear navigation via README.md in each subdirectory
- No duplicate/overlapping documentation
- Large artifacts properly gitignored (won't bloat repository)
- Historical context preserved in archived/

See .claude/CLEANUP-SUMMARY.md for complete details.

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-09-11 15:45:05 -04:00

30 lines
1.0 KiB
Markdown

# Setup Guides
Configuration and environment setup documentation.
## MCP Server Setup
**Start here**: `MCP-QUICK-START.md` - Quick setup guide
**Detailed documentation**:
- `INDEX-MCP-DOCS.md` - Complete documentation index
- `MCP-INTEGRATION-GUIDE.md` - Detailed integration patterns and workflows
- `MCP-COORDINATOR-CONNECTION-GUIDE.md` - Multi-agent coordination setup
- `MCP-COORDINATOR-EVALUATION.md` - Coordinator capabilities and evaluation
- `GORTEX-MCP-SETUP.md` - Gortex code intelligence server
- `GITHUB-MCP-SETUP.md` - GitHub integration server
**Automation scripts**:
- `quick-start-mcp.ps1` - Automated setup
- `test-mcp-servers.ps1` - Verification tests
## VM and Infrastructure
- `VM-SNAPSHOT-GUIDE.md` - Creating and managing VM snapshots
- `VM-USERS.md` - VM user accounts and roles
- `setup-vm-ssh.md` - SSH key authentication setup
- `enable-vm-ssh.ps1` - SSH enablement script
- `HYPER-V-SETUP.md` - Hyper-V permissions and configuration
## GitHub Integration
- `setup-github-token.cmd` - GitHub PAT configuration