Andras Bacsai 3f7c5fbdf9 Consolidate AI documentation into .ai/ directory

- Create .ai/ directory as single source of truth for all AI docs
- Organize by topic: core/, development/, patterns/, meta/
- Update CLAUDE.md to reference .ai/ files instead of embedding content
- Remove 18KB of duplicated Laravel Boost guidelines from CLAUDE.md
- Fix testing command descriptions (pest runs all tests, not just unit)
- Standardize version numbers (Laravel 12.4.1, PHP 8.4.7, Tailwind 4.1.4)
- Replace all .cursor/rules/*.mdc with single coolify-ai-docs.mdc reference
- Delete dev_workflow.mdc (non-Coolify Task Master content)
- Merge cursor_rules.mdc + self_improve.mdc into maintaining-docs.md
- Update .AI_INSTRUCTIONS_SYNC.md to redirect to new location

Benefits:
- Single source of truth - no more duplication
- Consistent versions across all documentation
- Better organization by topic
- Platform-agnostic .ai/ directory works for all AI tools
- Reduced CLAUDE.md from 719 to ~320 lines
- Clear cross-references between files

2025-11-18 14:58:59 +01:00

1.5 KiB

Raw Blame History

AI Instructions Synchronization Guide

This file has moved!

All AI documentation and synchronization guidelines are now in the .ai/ directory.

New Locations

Sync Guide: .ai/meta/sync-guide.md
Maintaining Docs: .ai/meta/maintaining-docs.md
Documentation Hub: .ai/README.md

Quick Overview

All AI instructions are now organized in .ai/ directory:

.ai/
├── README.md                    # Navigation hub
├── core/                        # Project information
├── development/                 # Dev workflows
├── patterns/                    # Code patterns
└── meta/                       # Documentation guides

For AI Assistants

Claude Code: Use CLAUDE.md (references .ai/ files)
Cursor IDE: Use .cursor/rules/coolify-ai-docs.mdc (references .ai/ files)
All Tools: Browse .ai/ directory for detailed documentation

Key Principles

Single Source of Truth: Each piece of information exists in ONE file only
Cross-Reference: Other files reference the source, don't duplicate
Organized by Topic: Core, Development, Patterns, Meta
Version Consistency: All versions in .ai/core/technology-stack.md

For More Information

See .ai/meta/sync-guide.md for complete synchronization guidelines and .ai/meta/maintaining-docs.md for documentation maintenance instructions.

1.5 KiB Raw Blame History