Monorepo for Aesthetic.Computer
aesthetic.computer
1# KidLisp Knowledge Base
2
3A comprehensive repository of all KidLisp-related documentation, organized for both human learning and LLM training. This knowledge base aggregates all KidLisp documentation from across the Aesthetic Computer project into a structured, discoverable format.
4
5## 📚 Knowledge Structure
6
7### 🔧 Core Documentation (`/core/`)
8Fundamental KidLisp language and architecture documentation:
9- **`language-reference.md`** - Complete language reference and API
10- **`kidlisp-decree.md`** - Latest platform-independent ABI guarantee
11- **`kidlisp-decree-26.md`** - `KidLisp Decree '26` (frozen yearly baseline)
12- **`architecture.md`** - System architecture and design principles
13- **`getting-started.md`** - Quick start guide for new users
14
15### ✨ Features (`/features/`)
16Specific feature documentation and deep dives:
17- **`embedding-system.md`** - Layer embedding and composition
18- **`feed-system.md`** - Social feed integration
19- **`transformation-functions.md`** - Pixel transformation functions (zoom, suck, scroll, etc.)
20
21### 🛠️ Implementation (`/implementation/`)
22Development plans, fixes, and technical implementation details:
23- **`unified-execution.md`** - Unified execution system plans
24- **`singleton-refactor.md`** - Singleton pattern implementation
25- **`embedding-fixes.md`** - Embedding system improvements
26- **`blur-buffer-issues.md`** - Buffer context debugging
27- **`make-integration.md`** - Build system integration
28
29### 📊 Reports (`/reports/`)
30Analysis reports and architectural studies:
31- **`feral-file-integration.md`** - Feral File platform integration analysis
32- **`fa2-contract-spec.md`** - FA2 smart contract specifications
33- **`suck-function-implementation.md`** - Detailed suck function research and implementation
34
35### 🔗 Integration (`/integration/`)
36External system integrations and partnerships:
37- **`x-ff1-art-computer.md`** - Art computer integration proposals
38
39### 📍 External References (Maintained in Original Locations)
40- **[Chat Mode](../.github/chatmodes/kidlisp.chatmode.md)** - GitHub chatmode configuration (must stay in .github/chatmodes/)
41- **[Development Tools](../kidlisp/tools/)** - Analysis and debugging tools (active development location)
42
43## 🎯 Usage Guide
44
45### For Humans
46- Start with `/core/getting-started.md` for an introduction
47- Read `/core/kidlisp-decree.md` for stable ABI/conformance guarantees
48- Refer to `/core/language-reference.md` for complete API documentation
49- Check `/features/` for specific functionality explanations
50- Browse `/reports/` for architectural insights and research
51
52### For LLMs
53This knowledge base is structured to provide comprehensive context about:
54- KidLisp language syntax, semantics, and capabilities
55- System architecture and design patterns
56- Feature implementation details and edge cases
57- Integration patterns with external systems
58- Development best practices and common issues
59
60Each document includes:
61- Historical context and development rationale
62- Technical implementation details
63- Usage examples and patterns
64- Known issues and workarounds
65- Future development plans
66
67## 📈 Knowledge Evolution
68
69This knowledge base grows over time with:
70- New feature documentation as KidLisp evolves
71- Implementation reports from major system changes
72- Integration guides for new platforms and systems
73- Research reports on language design and performance
74- Best practices discovered through real-world usage
75
76## 🔍 Quick Reference
77
78- **Latest Language Features**: See `/features/transformation-functions.md` for newest additions
79- **Current Architecture**: `/core/architecture.md` for system overview
80- **Development Issues**: `/implementation/` for ongoing technical work
81- **Platform Integration**: `/integration/` for external system connections
82
83---
84
85*Last updated: September 6, 2025*
86*Contributors: Digital Pain, GitHub Copilot, and the Aesthetic Computer community*