- 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
41 lines
1.5 KiB
Markdown
41 lines
1.5 KiB
Markdown
# 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](.ai/meta/sync-guide.md)
|
|
- **Maintaining Docs**: [.ai/meta/maintaining-docs.md](.ai/meta/maintaining-docs.md)
|
|
- **Documentation Hub**: [.ai/README.md](.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
|
|
|
|
1. **Single Source of Truth**: Each piece of information exists in ONE file only
|
|
2. **Cross-Reference**: Other files reference the source, don't duplicate
|
|
3. **Organized by Topic**: Core, Development, Patterns, Meta
|
|
4. **Version Consistency**: All versions in `.ai/core/technology-stack.md`
|
|
|
|
## For More Information
|
|
|
|
See [.ai/meta/sync-guide.md](.ai/meta/sync-guide.md) for complete synchronization guidelines and [.ai/meta/maintaining-docs.md](.ai/meta/maintaining-docs.md) for documentation maintenance instructions.
|