docs: add comprehensive capabilities architecture documentation

Created detailed documentation for capabilities concept and integration:
- CAPABILITIES_ARCHITECTURE.md: Full guide on separation of concerns
- CAPABILITIES_QUICK_REFERENCE.md: Quick reference for common tasks
- Updated docs/README.md to reference new documentation

Ensures future sessions respect capability boundaries and use separate
Claude instances for capability development.

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
2025-12-16 00:15:57 +01:00
parent 9bbc2832de
commit aa0ac626c5
3 changed files with 639 additions and 1 deletions

View File

@@ -7,8 +7,9 @@ Welcome to the MarkiTect documentation. This directory contains comprehensive do
### 📐 Architecture Documentation (`architecture/`)
Deep technical documentation about system design, performance, and implementation details.
- **[Capabilities Architecture](architecture/CAPABILITIES_ARCHITECTURE.md)** - **Critical:** How capabilities work as independent git submodules and separation of concerns
- **[Caching System](architecture/caching-system.md)** - Why and how MarkiTect's AST caching delivers 60-85% performance improvements
- *Coming soon: Database Schema, CLI Architecture, Plugin System*
- *Coming soon: Database Schema, CLI Architecture*
### 👥 User Guides (`user-guides/`)
End-user documentation for working with MarkiTect CLI and features.