Reorganize documentation to clean structure

- Move all docs to docs/ directory for clean repo structure
- Create LLM-optimized versions (*-LLM.MD) for AI tool consumption
- Update cross-references and links for new paths
- Maintain both human-readable and machine-optimized versions
- Complete documentation system with worklog tracking
This commit is contained in:
2025-09-05 07:37:33 -05:00
parent 57685f333b
commit 44cdd6eb67
8 changed files with 441 additions and 28 deletions

65
docs/AGENT-LLM.MD Normal file
View File

@@ -0,0 +1,65 @@
# AI AGENT REFERENCE - LLM OPTIMIZED
**FOR: Gemini-CLI, Claude, OpenCode, all AI tools**
## CRITICAL RULES
1. NEVER work on `main` branch
2. NEVER auto-delete feature branches
3. ALWAYS push before switching branches
4. Push every 10 commits max
5. Tag milestones
6. UPDATE WORKLOGS
## COMMANDS
**New feature:**
```bash
git checkout main && git pull origin main
git checkout -b feature/name
```
**Before switch:**
```bash
git add . && git commit -m "msg"
git push origin current-branch
```
**Tag milestone:**
```bash
git tag -a name -m "description"
git push origin name
```
## BRANCHES
- `main` - stable, protected
- `LLMBOOTSTRAP` - initial setup
- `INTEGRATION-WIP` - auto-merge target
- `RELEASE` - manual PR target
- `feature/*` - all development
## WORKFLOW
1. Create feature branch from main
2. Frequent commits (small, logical)
3. Push every ~10 commits or before switch
4. Auto-merge to INTEGRATION-WIP
5. Manual PR to RELEASE
6. NEVER delete branches
## TAGGING
**When:** milestone/stage/feature complete
**Format:** `bootstrap-complete`, `milestone-2025-09-05`, `auth-done`
**Command:** `git tag -a name -m "desc"`
## WORKLOGS
- **docs/WORKLOG-LLM.md** - status/progress
- **docs/CURRENTWORK-LLM.md** - detailed notes
**Pattern:** Start→update status, During→add notes, End→update completion
## FILES
- Human: docs/GIT_WORKFLOW.MD, docs/AGENT.MD, docs/WORKLOG.md, docs/CURRENTWORK.md
- LLM: docs/*-LLM.MD (this file and others)
## CONTEXT
- Platform: Gitea (not GitHub)
- Repo: /home/localuser/UKSRS/CTO
- Keep clean: docs in docs/ directory