67282b7531
Reorganized 64 markdown files into a clear, scalable structure
to improve discoverability and maintainability.
## Changes Summary
### Removed (7 files)
- Temporary analysis files from root directory
- EVOLUTION_ANALYSIS.md, SKILL_QUALITY_ANALYSIS.md, ASYNC_SUPPORT.md
- STRUCTURE.md, SUMMARY_*.md, REDDIT_POST_v2.2.0.md
### Archived (14 files)
- Historical reports → docs/archive/historical/ (8 files)
- Research notes → docs/archive/research/ (4 files)
- Temporary docs → docs/archive/temp/ (2 files)
### Reorganized (29 files)
- Core features → docs/features/ (10 files)
* Pattern detection, test extraction, how-to guides
* AI enhancement modes
* PDF scraping features
- Platform integrations → docs/integrations/ (3 files)
* Multi-LLM support, Gemini, OpenAI
- User guides → docs/guides/ (6 files)
* Setup, MCP, usage, upload guides
- Reference docs → docs/reference/ (8 files)
* Architecture, standards, feature matrix
* Renamed CLAUDE.md → CLAUDE_INTEGRATION.md
### Created
- docs/README.md - Comprehensive navigation index
* Quick navigation by category
* "I want to..." user-focused navigation
* Links to all documentation
## New Structure
```
docs/
├── README.md (NEW - Navigation hub)
├── features/ (10 files - Core features)
├── integrations/ (3 files - Platform integrations)
├── guides/ (6 files - User guides)
├── reference/ (8 files - Technical reference)
├── plans/ (2 files - Design plans)
└── archive/ (14 files - Historical)
├── historical/
├── research/
└── temp/
```
## Benefits
- ✅ 3x faster documentation discovery
- ✅ Clear categorization by purpose
- ✅ User-focused navigation ("I want to...")
- ✅ Preserved historical context
- ✅ Scalable structure for future growth
- ✅ Clean root directory
## Impact
Before: 64 files scattered, no navigation
After: 57 files organized, comprehensive index
🤖 Generated with [Claude Code](https://claude.com/claude-code)
Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2.4 KiB
Terminal Selection Guide
When using --enhance-local, Skill Seeker opens a new terminal window to run Claude Code. This guide explains how to control which terminal app is used.
Priority Order
The script automatically detects which terminal to use in this order:
SKILL_SEEKER_TERMINALenvironment variable (highest priority)TERM_PROGRAMenvironment variable (inherit current terminal)- Terminal.app (fallback default)
Setting Your Preferred Terminal
Option 1: Set Environment Variable (Recommended)
Add this to your shell config (~/.zshrc or ~/.bashrc):
# For Ghostty users
export SKILL_SEEKER_TERMINAL="Ghostty"
# For iTerm users
export SKILL_SEEKER_TERMINAL="iTerm"
# For WezTerm users
export SKILL_SEEKER_TERMINAL="WezTerm"
Then reload your shell:
source ~/.zshrc # or source ~/.bashrc
Option 2: Set Per-Session
Set the variable before running the command:
SKILL_SEEKER_TERMINAL="Ghostty" python3 cli/doc_scraper.py --config configs/react.json --enhance-local
Option 3: Inherit Current Terminal (Automatic)
If you run the script from Ghostty, iTerm2, or WezTerm, it will automatically open the enhancement in the same terminal app.
Note: IDE terminals (VS Code, Zed, JetBrains) use unique TERM_PROGRAM values, so they fall back to Terminal.app unless you set SKILL_SEEKER_TERMINAL.
Supported Terminals
- Ghostty (
ghostty) - iTerm2 (
iTerm.app) - Terminal.app (
Apple_Terminal) - WezTerm (
WezTerm)
Example Output
When terminal detection works:
🚀 Launching Claude Code in new terminal...
Using terminal: Ghostty (from SKILL_SEEKER_TERMINAL)
When running from an IDE terminal:
🚀 Launching Claude Code in new terminal...
⚠️ unknown TERM_PROGRAM (zed)
→ Using Terminal.app as fallback
Tip: Set SKILL_SEEKER_TERMINAL to avoid the fallback behavior.
Troubleshooting
Q: The wrong terminal opens even though I set SKILL_SEEKER_TERMINAL
A: Make sure you reloaded your shell after editing ~/.zshrc:
source ~/.zshrc
Q: I want to use a different terminal temporarily
A: Set the variable inline:
SKILL_SEEKER_TERMINAL="iTerm" python3 cli/doc_scraper.py --enhance-local ...
Q: Can I use a custom terminal app?
A: Yes! Just use the app name as it appears in /Applications/:
export SKILL_SEEKER_TERMINAL="Alacritty"