README.md

1# Next.js Micro-Block Architecture Implementation
2
3A Next.js implementation of the micro-block architecture pattern for AI-collaborative development.
4
5## 🚨 FOR AI ASSISTANTS: MANDATORY READING
6
7**BEFORE ANY IMPLEMENTATION**: You MUST read [`micro-block-nextjs.md`](./micro-block-nextjs.md) for complete implementation guidance.
8
9**This README is navigation only. All implementation details, required imports, and critical guidance are in the implementation guide.**
10
11## 📖 Implementation Guide
12
13### Essential Reading
14- **⚡ Next.js Implementation**: [`micro-block-nextjs.md`](./micro-block-nextjs.md) - **START HERE** - Complete implementation guide with required imports and step-by-step instructions
15
16### Core Patterns & Architecture
17- **🏗️ Micro-Block Pattern**: [`utaba/patterns/micro-block/micro-block-pattern.md`](../../patterns/micro-block/micro-block-pattern.md) - Design pattern specification
18- **📋 Contract-First Development**: [`utaba/patterns/micro-block/contract-first-development.md`](../../patterns/micro-block/contract-first-development.md) - Interface-driven development patterns
19- **✅ Validation Patterns**: [`utaba/patterns/micro-block/validation-patterns.md`](../../patterns/micro-block/validation-patterns.md) - Input validation strategies
20- **🔄 Service Registry Patterns**: [`utaba/patterns/micro-block/service-registry-patterns.md`](../../patterns/micro-block/service-registry-patterns.md) - Service management patterns
21
22### Development Standards
23- **📘 Development Guidelines**: [`utaba/guidance/development/development-guidelines.md`](../../guidance/development/development-guidelines.md) - Best practices and coding standards
24
25### Testing
26- **🧪 Integration Testing**: [`utaba/patterns/testing/integration-testing-patterns.md`](../../patterns/testing/integration-testing-patterns.md) - Testing patterns for micro-block architecture
27
28## 🎯 Quick Navigation
29
30**For Implementation**: Read [`micro-block-nextjs.md`](./micro-block-nextjs.md) - Contains all setup, configuration, and implementation details
31
32**For Understanding Patterns**: Start with the Core Patterns & Architecture links above
33
34**For Development Standards**: Review Development Guidelines for coding practices
35
36## 🚀 Key Benefits
37
38- **AI-Collaborative**: Rich metadata enables AI agents to discover and compose functionality
39- **Contract-First**: All interfaces defined before implementation
40- **Lazy Loading**: Services and commands loaded on-demand
41- **Dependency Injection**: Automatic service resolution and injection
42- **Portable**: Services work across projects without modification
43- **Testable**: Clean mocking through dependency injection
44
45**For detailed implementation information, see [`micro-block-nextjs.md`](./micro-block-nextjs.md)**
46
47## 📚 Additional Resources
48
49### Specialized Guides
50- **🔄 Service Registry Patterns**: [`utaba/patterns/micro-block/service-registry-patterns.md`](../../patterns/micro-block/service-registry-patterns.md) - Service management and registry implementation patterns
51- **📋 Command Registry Patterns**: [`utaba/patterns/micro-block/command-registry-pattern.md`](../../patterns/micro-block/command-registry-pattern.md) - Command discovery, loading, and metadata-driven orchestration
52- **📝 Command Instructions**: [`utaba/guidance/development/command-instructions.md`](../../guidance/development/command-instructions.md) - Contract-first command development
53
54---
55
56*For implementation details, always refer to [`micro-block-nextjs.md`](./micro-block-nextjs.md)*