UKRRS/CTO

Files

ReachableCEO 44cdd6eb67 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

2025-09-05 07:37:33 -05:00

1.5 KiB

Raw Permalink Blame History

AI AGENT REFERENCE - LLM OPTIMIZED

FOR: Gemini-CLI, Claude, OpenCode, all AI tools

CRITICAL RULES

NEVER work on main branch
NEVER auto-delete feature branches
ALWAYS push before switching branches
Push every 10 commits max
Tag milestones
UPDATE WORKLOGS

COMMANDS

New feature:

git checkout main && git pull origin main
git checkout -b feature/name

Before switch:

git add . && git commit -m "msg"
git push origin current-branch

Tag milestone:

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

Create feature branch from main
Frequent commits (small, logical)
Push every ~10 commits or before switch
Auto-merge to INTEGRATION-WIP
Manual PR to RELEASE
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

1.5 KiB Raw Permalink Blame History